Pbg.Logging 1.0.32

Pbg.Logging

A high-performance, centralized logging library for .NET applications that captures and sends structured logs to a remote endpoint in batches.

✨ Features

• 🚀 Asynchronous & non-blocking
• 📦 Batch processing with configurable intervals
• 🔄 Automatic retry with exponential backoff
• 🌐 HTTP request/response middleware
• 🔍 Distributed tracing support
• 🎯 Smart log filtering

📦 Installation

Install via NuGet Package Manager:

dotnet add package Pbg.Logging

Or via NuGet Package Manager Console:

Install-Package Pbg.Logging

Or visit the NuGet Gallery

🌐 Log Dashboard

Visit https://logs.pbg.ge/ to:

• 📋 View and search logs — browse all captured logs from your applications in real time
• 🔑 Generate a Service-Key — after registration, create a LicenseKey to use with this library

Getting started: Register at logs.pbg.ge, generate your Service-Key, and use it as the LicenseKey in your configuration.

Quick Start

ASP.NET Core Web API

using Pbg.Logging;

var builder = WebApplication.CreateBuilder(args);

builder.Logging.AddPbgLogger(options =>
{
    options.LicenseKey = new Guid("your-license-key-here");
    options.EndpointUrl = "https://logs.pbg.ge/api/v1/log";
    options.ProjectName = "MyWebApi";
    options.Environment = PbgEnvironment.Production;
});

var app = builder.Build();

app.UsePbgLogging(); // Automatic HTTP logging middleware

app.Run();

Console Application

using Pbg.Logging;

var host = Host.CreateDefaultBuilder(args)
    .ConfigureServices((context, services) =>
    {
        services.AddLogging(builder =>
        {
            builder.AddPbgLogger(options =>
            {
                options.LicenseKey = new Guid("your-license-key-here");
                options.EndpointUrl = "https://your-endpoint.com/api/logs";
                options.ProjectName = "MyConsoleApp";
                options.Environment = PbgEnvironment.Development;
            });
        });
    })
    .Build();

await host.RunAsync();

Usage

public class MyService
{
    private readonly ILogger<MyService> _logger;

    public MyService(ILogger<MyService> logger)
    {
        _logger = logger;
    }

    public void DoWork()
    {
        _logger.LogInformation("Processing started");
        _logger.LogError("Something went wrong");
    }
}

Environment Mapping (One Code for All Environments)

Use ASPNETCORE_ENVIRONMENT/builder.Environment.EnvironmentName and map it to PbgEnvironment once:

using Pbg.Logging.Model;

builder.Logging.AddPbgLogger(options =>
{
    options.LicenseKey = Guid.Parse(builder.Configuration["PbgLogging:LicenseKey"]!);
    options.EndpointUrl = builder.Configuration["PbgLogging:EndpointUrl"]!;
    options.ProjectName = builder.Configuration["PbgLogging:ProjectName"] ?? builder.Environment.ApplicationName;
    options.Environment = builder.Environment.EnvironmentName.ToLowerInvariant() switch
    {
        "development" => PbgEnvironment.Development,
        "staging" => PbgEnvironment.Staging,
        "production" => PbgEnvironment.Production,
        "testing" => PbgEnvironment.Testing,
        "uat" => PbgEnvironment.Uat,
        _ => PbgEnvironment.Production
    };
});

LicenseKey can be the same for all environments or different per environment (recommended). Keep values in appsettings.{Environment}.json:

{
  "PbgLogging": {
    "LicenseKey": "11111111-1111-1111-1111-111111111111",
    "EndpointUrl": "https://logs.pbg.ge/api/v1/log",
    "ProjectName": "MyService"
  }
}

⚙️ Configuration

HTTP capture defaults are built-in and always on:

• Request headers
• Response headers
• Request body (when present)
• Response body (when present)
• Outbound HttpClient interception for IHttpClientFactory clients
• UserId from claims (when present)
• Body capture limit: 2000 characters (JSON responses are logged fully)

📊 Log Structure

{
  "timestamp": "2026-01-15T10:30:00Z",
  "logLevel": "Information",
  "message": "Your log message",
  "projectName": "MyApp",
  "environment": "Production",
  "machineName": "SERVER-01",
  "ipAddress": "192.168.1.100",
  "traceId": "abc123",
  "userId": "user-123",
  "method": "POST",
  "path": "/api/users",
  "statusCode": 200,
  "requestBody": "{...}",
  "responseBody": "{...}",
  "elapsedMilliseconds": 45.2,
  "exception": null
}

🎯 Automatic Filtering

• ✅ All Error and above
• ✅ Microsoft.Hosting.Lifetime logs
• ⚠️ Microsoft/System logs: Warning and above only
• ✅ Application logs: All levels

🔄 Retry Strategy

• Max retries: 3
• Backoff: 2s → 4s → 8s (exponential)
• Timeout: 30s per request (configurable via RequestTimeout)

Upload Failure Handling

• Retryable failures: network errors, 5xx, 408, 429
• Retryable batches are saved as batch_*.json and retried later
• Non-retryable failures: 4xx (except 408 and 429)
• Non-retryable batches are moved to rejected_*.json and skipped
• Local files are stored in %TEMP%/Pbg.Logging/{ProjectName}

📝 License

Requires a valid license key.

🔗 Links

• Dashboard: logs.pbg.ge — View logs & generate Service-Keys
• GitHub: guliv3r/Pbg.Logging
• Issues: Report bugs