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 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
1 participant