BrainEnterprise.Library.Logging 1.0.0

BrainEnterprise.Library.Logging

A lightweight .NET performance tracking library with hierarchical correlation, async-safe context propagation, and structured logging via NLog. Designed for production monitoring and BI-ready analysis (e.g. Power BI).

Features

• Performance Tracking - Monitor execution duration with millisecond precision using Stopwatch
• Hierarchical Correlation - Automatic parent-child relationship tracking across nested operations
• Async-Safe Context - Correct context propagation in async/await and parallel scenarios via AsyncLocal<T>
• Slow Operation Detection - Configurable thresholds (global and per-operation) to flag slow executions
• Exception Tracking - Capture and log exceptions with full type and message details
• Zero-Overhead Disable - When disabled, returns an inactive singleton with virtually no performance cost
• Caller Info Capture - Automatic capture of caller method, file, and line number via compiler attributes

Target Frameworks

Dependencies

Getting Started

Configuration

The library can be configured via appSettings, appsettings.json, or environment variables.

App.config / Web.config:

<appSettings>
  <add key="PerformanceTracker:LoggerName" value="Performance.Execution" />
  <add key="PerformanceTracker:Enabled" value="true" />
  <add key="PerformanceTracker:SlowThresholdMs" value="3000" />
</appSettings>

appsettings.json:

{
  "PerformanceTracker": {
    "LoggerName": "Performance.Execution",
    "Enabled": true,
    "SlowThresholdMs": 3000
  }
}

Environment variables:

PerformanceTracker__LoggerName=Performance.Execution
PerformanceTracker__Enabled=true
PerformanceTracker__SlowThresholdMs=3000

Programmatic initialization:

PerformanceTrackerConfig.Initialize("MyLogger", enabled: true, slowThresholdMs: 5000);

Usage

Using statement (recommended)

using (var tracker = PerformanceTracker.Start("MyOperation"))
{
    // Do work...
    tracker.Complete();
}

Track synchronous actions

PerformanceTracker.Track("SendEmail", () =>
{
    emailService.Send(message);
});

var total = PerformanceTracker.Track("CalculateTotal", () =>
{
    return items.Sum(x => x.Price);
});

Track async operations

await PerformanceTracker.TrackAsync("FetchDataAsync", async () =>
{
    await database.QueryAsync();
});

var user = await PerformanceTracker.TrackAsync("GetUserAsync", async () =>
{
    return await api.GetUserAsync(userId);
});

Custom slow threshold per operation

using (var tracker = PerformanceTracker.Start("HeavyReport", slowThresholdMs: 10000))
{
    // Flagged as SLOW only if > 10 seconds
    tracker.Complete();
}

Exception handling

using (var tracker = PerformanceTracker.Start("RiskyOperation"))
{
    try
    {
        DoSomethingRisky();
        tracker.Complete();
    }
    catch (Exception ex)
    {
        tracker.SetException(ex);
        throw;
    }
}

Nested (hierarchical) operations

using (var parent = PerformanceTracker.Start("OrderProcessing"))
{
    using (var child = PerformanceTracker.Start("ValidateOrder"))
    {
        // ParentTrackingId automatically set to parent.TrackingId
        child.Complete();
    }

    using (var child = PerformanceTracker.Start("SaveOrder"))
    {
        child.Complete();
    }

    parent.Complete();
}

Accessing the current tracker

var current = PerformanceTracker.Current;
Console.WriteLine($"TrackingId: {current.TrackingId}");
Console.WriteLine($"Depth: {current.Depth}");

Disabling tracking globally

PerformanceTrackerConfig.Enabled = false;

Log Event Properties

Each tracked operation emits two structured log events: START and END.

START phase

END phase

All START properties, plus:

Status Values

License

MIT