ln-771-logging-configurator

Overview

Phase 1: Receive Context

• STACK

  : .NET or Python

• FRAMEWORK

  : ASP.NET Core or FastAPI

• FRAMEWORK_VERSION

  : Version number

• PROJECT_ROOT

  : Project directory path

• ENVIRONMENT

  : Development or Production

• If

  STACK

  not provided, detect from project files
• If version not provided, use latest stable

Phase 2: Research Current Best Practices

MCP ref: "Serilog ASP.NET Core structured logging configuration"
Context7: /serilog/serilog-aspnetcore

MCP ref: "structlog Python structured logging configuration"
Context7: /hynek/structlog

1. Request logging middleware
2. Log enrichment (correlation ID, user context)
3. Log level configuration by environment
4. Sink configuration (Console, File, Seq, Elastic)

Phase 3: Decision Points

Q1: Log Format

Q2: Enrichment Fields

correlationId

userId

requestPath

responseTime

machineName

threadId

Q3: Log Sinks

Q4: Log Levels by Environment

Phase 4: Generate Configuration

.NET Output Files

Extensions/LoggingExtensions.cs

appsettings.json

appsettings.Development.json

1. Use MCP ref to get current Serilog API
2. Generate LoggingExtensions.cs with:
   • UseSerilog configuration
   • Request logging middleware
   • Enrichment configuration
3. Update appsettings.json with Serilog section

• Serilog.AspNetCore

• Serilog.Sinks.Console

• Serilog.Sinks.File

  (if File sink selected)

• Serilog.Enrichers.Environment

  (if machineName selected)

Python Output Files

core/logging_config.py

middleware/logging_middleware.py

1. Use MCP ref to get current structlog API
2. Generate logging_config.py with:
   • Processor chain configuration
   • Renderer selection (JSON/Console)
   • Log level configuration
3. Generate logging_middleware.py for FastAPI

• structlog

• python-json-logger

  (if JSON format)

Phase 5: Validate

1. Check imports: Ensure all packages are available
   • .NET:

     dotnet list package | grep Serilog

   • Python:

     pip list | grep structlog

2. Syntax check:
   • .NET:

     dotnet build --no-restore

   • Python:

     python -m py_compile core/logging_config.py

3. Test log output:
   • Start application
   • Make test request
   • Verify log format matches configuration

{
  "timestamp": "2026-01-10T12:00:00.000Z",
  "level": "info",
  "message": "Request completed",
  "correlationId": "abc-123",
  "requestPath": "/api/health",
  "responseTime": 45,
  "statusCode": 200
}

Return to Coordinator

{
  "status": "success",
  "files_created": [
    "Extensions/LoggingExtensions.cs",
    "appsettings.json"
  ],
  "packages_added": [
    "Serilog.AspNetCore",
    "Serilog.Sinks.Console"
  ],
  "registration_code": "services.AddLoggingServices(configuration);",
  "message": "Configured structured logging with Serilog"
}

Idempotency

• Phase 1: Check if logging already configured (Grep for Serilog/structlog)
• If configured: Return

  { "status": "skipped", "message": "Logging already configured" }

• If not: Proceed with configuration

Reference Links

• Serilog.AspNetCore
• structlog Documentation
• ASP.NET Core Logging