Logger.SDK 2.2.1

Logger.SDK

Production-grade .NET SDK for centralized exception logging with async queueing, batching, retries, and enriched observability context.

Installation

dotnet add package Logger.SDK

Quick Start

using Logger;

LoggerSdk.Configure(options =>
{
    options.Endpoint = "https://your-api/api/Logs/ReceiveLog";
    options.ApiKey = "lg_xxx";
    options.ProjectId = "00000000-0000-0000-0000-000000000000";
    options.ApplicationName = "Orders.API";
});

// 1. Asynchronous Execution Context
public async Task ProcessOrderAsync()
{
    try 
    {
        await ExecuteLogicAsync();
    }
    catch (Exception ex)
    {
        await LoggerSdk.LogExceptionAsync(ex);
        throw;
    }
}

// 2. Synchronous Execution Context (No async/await)
public void ProcessOrder()
{
    try 
    {
        ExecuteLogic();
    }
    catch (Exception ex)
    {
        LoggerSdk.LogException(ex);
        throw;
    }
}

SaaS Features

• Non-blocking async logging with bounded queue.
• Batch flushing with configurable interval.
• Retry policy for transient failures.
• Safe process-exit flush to reduce data loss.
• Exception fingerprinting and duplicate collapse.
• Trace correlation fields (TraceId, SpanId, CorrelationId).
• Optional environment/runtime metadata capture.

Configuration

LoggerOptions supports a wide range of settings for performance and observability:

• Core: Endpoint, ApiKey, ProjectId, ApplicationName
• Performance: EnableAsyncLogging, MaxQueueSize, MaxBatchSize, FlushIntervalSeconds, RequestTimeoutSeconds, RetryCount, DropOldestWhenQueueFull
• Context: CaptureEnvironmentInfo, CaptureSourceCode, EnableFingerprinting, CorrelationHeaderName, Tags

ASP.NET Core Registration

// In Program.cs
builder.Services.AddLoggerSdk(builder.Configuration);

var app = builder.Build();

// Optional: Ensure all logs are flushed on graceful shutdown
app.Lifetime.ApplicationStopping.Register(() =>
{
    LoggerSdk.FlushAsync().GetAwaiter().GetResult();
    LoggerSdk.ShutdownAsync().GetAwaiter().GetResult();
});

app.Run();

Complex appsettings.json example:

{
  "Logger": {
    "Endpoint": "https://loggeraiagent-b4b3defjcyh2axds.centralindia-01.azurewebsites.net/api/Logs/ReceiveLog",
    "ApiKey": "lg_your_api_key_here",
    "ProjectId": "your-project-id-here",
    "ApplicationName": "YourApplicationName",
    "EnableAsyncLogging": false,
    "RequestTimeoutSeconds": 5,
    "RetryCount": 1,
    "EnableDebugConsole": true,
    "CaptureSourceCode": false
  }
}

Lifecycle Management

For non-web applications or manual control:

// Graceful shutdown
await LoggerSdk.FlushAsync();
await LoggerSdk.ShutdownAsync();