correlation-id-tracking

Using Traceability Package for Correlation-ID Tracking

This skill helps you use the WhiteBeard.Traceability NuGet package to implement correlation-id tracking in .NET applications. The package provides automatic correlation-id management with zero-configuration setup.

Installation

dotnet add package WhiteBeard.Traceability

Or via Package Manager:

Install-Package WhiteBeard.Traceability

Quick Setup

ASP.NET Core (.NET 8) - Zero Configuration

Minimal setup (one line!):

using Traceability.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Zero configuration - everything is automatic!
// - Middleware registered automatically
// - HttpClient configured automatically
// - Source from TRACEABILITY_SERVICENAME or assembly name
builder.Services.AddTraceability();
builder.Services.AddControllers();

var app = builder.Build();
app.MapControllers();
app.Run();

With explicit service name:

builder.Services.AddTraceability("MyService");

Done! Correlation-id is now automatically:

• ✅ Generated on each request (if not provided via X-Correlation-Id header)
• ✅ Available via CorrelationContext.Current
• ✅ Added to response headers as X-Correlation-Id
• ✅ Propagated in HttpClient calls automatically
• ✅ Included in logs (when logging is configured)

ASP.NET Framework 4.8 - Zero Code

Just install the package - no code needed!

The library automatically:

• ✅ Registers CorrelationIdHttpModule via PreApplicationStartMethod
• ✅ Manages correlation-id automatically

Optional: Configure Serilog

// Global.asax.cs
using Traceability.Extensions;
using Serilog;

protected void Application_Start()
{
    Log.Logger = new LoggerConfiguration()
        .WithTraceability("MyService")
        .WriteTo.Console(
            outputTemplate: "[{Timestamp:HH:mm:ss} {Level:u3}] {Source} {CorrelationId} {Message:lj}{NewLine}{Exception}")
        .CreateLogger();
}