Skip to content

Conversation

@guardrex
Copy link
Collaborator

@guardrex guardrex commented Sep 30, 2025

Fixes #35806
Fixes #33187
Fixes #32746
Fixes #32520
Fixes #32049

Outline ...

  • Introductory remarks
  • Logging providers
  • Logging output
  • Create log messages
  • Log message template
  • Log at app startup
  • Configure logging
    • App settings
    • Command shell
    • Configure Azure App Service
  • Log category
  • Log event ID
  • Log level
  • Change log levels in a running app
  • How filtering rules are applied
  • ILogger and ILoggerFactory
  • Log exceptions
    • Default log level
    • Filter function
  • ASP.NET Core categories
  • Log scopes
  • Built-in logging providers
    • Console
    • Debug
      • dotnet-trace tooling
      • Perfview
    • Windows EventLog
      • Azure App Service
      • Azure log streaming
    • Azure Application Insights
  • Third-party logging providers
  • Non-host console app logging
  • No asynchronous logger methods
  • Apply log filter rules in code
  • Specify the trace context for logging scopes (>=5.0)
  • Create a custom logger
  • Log during host construction (<6.0)
  • Configure a service that depends on ILogger (<6.0)
  • Logging bug reports
  • Common log categories
  • Additional resources

Internal previews

📄 File 🔗 Preview link
aspnetcore/blazor/fundamentals/logging.md aspnetcore/blazor/fundamentals/logging
aspnetcore/fundamentals/logging/index.md aspnetcore/fundamentals/logging/index
aspnetcore/fundamentals/servers/yarp/diagnosing-yarp-issues.md aspnetcore/fundamentals/servers/yarp/diagnosing-yarp-issues
aspnetcore/host-and-deploy/proxy-load-balancer.md aspnetcore/host-and-deploy/proxy-load-balancer
aspnetcore/security/authentication/configure-oidc-web-authentication.md aspnetcore/security/authentication/configure-oidc-web-authentication

@guardrex guardrex self-assigned this Sep 30, 2025
@guardrex guardrex requested a review from Copilot October 1, 2025 12:42
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR represents a comprehensive overhaul of ASP.NET Core logging documentation, consolidating and improving the content structure while updating cross-references throughout the documentation set. The changes address multiple GitHub issues and reorganize the logging guidance into a more coherent structure.

Key changes:

  • Complete restructuring of the main logging article (fundamentals/logging/index.md) with improved organization and updated content
  • Updated cross-references across multiple files to point to new anchor sections
  • Consolidated include files for better maintainability
  • Refined Blazor logging documentation to focus on client-side scenarios

Reviewed Changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
aspnetcore/security/authentication/configure-oidc-web-authentication.md Updated logging reference anchor from configure-logging to configuration
aspnetcore/includes/sql-log.md Reformatted logging reference with bullet points and updated GitHub issue link
aspnetcore/includes/environmentVarableColon.md Simplified content into single paragraph with improved clarity
aspnetcore/host-and-deploy/proxy-load-balancer.md Updated logging reference anchors and corrected method reference format
aspnetcore/fundamentals/servers/yarp/diagnosing-yarp-issues.md Updated logging reference anchor from configure-logging to configuration
aspnetcore/fundamentals/logging/index/includes/index5.md Removed entire legacy content file (943 lines deleted)
aspnetcore/blazor/fundamentals/logging.md Streamlined focus to client-side logging with updated description and removed redundant component examples

@guardrex guardrex marked this pull request as ready for review October 1, 2025 15:27
@guardrex guardrex requested a review from danroth27 October 6, 2025 12:14
@guardrex guardrex requested review from tdykstra and removed request for danroth27 January 15, 2026 17:36
@guardrex
Copy link
Collaborator Author

@tdykstra ... Let's go ahead with this PR. Dan is apparently swamped with work, and this has been sitting forever. We should try to get this in before it breaks from new PRs, including anything coming along for .NET 11.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants