Ozcorps.Logger 9.0.0

Ozcorps.Logger

A modular, extensible logging library for ASP.NET Core applications. Routes logs to Text files, RabbitMQ, Logstash (ELK), or OTLP-compatible backends (Grafana, Aspire Dashboard) through a single IOzLogger interface.

Installation

dotnet add package Ozcorps.Logger

Backends

Text Logger

// Program.cs
builder.Services.AddOzTextLogger();

// appsettings.json
{
  "Logging": {
    "Directory": {
      "TextLogger": "/var/logs/myapp"
    }
  }
}

RabbitMQ Logger

// Program.cs
builder.Services.AddOzRabbitMqLogger();

// appsettings.json
{
  "RabbitMq": {
    "HostName": "localhost",
    "Username": "admin",
    "Password": "admin",
    "VirtualHost": "/"
  },
  "RabbitMqLogger": {
    "UserLogQueue": "myapp-user-logs",
    "AuditLogQueue": "myapp-audit-logs",
    "ActionLogQueue": "myapp-action-logs",
    "OtherLogQueue": "myapp-other-logs"
  }
}

Logstash Logger (ELK)

// Program.cs
builder.Services.AddOzLogstashLogger();

// appsettings.json
{
  "Logging": {
    "Logstash": {
      "Host": "localhost",
      "Port": 5000,
      "Protocol": "tcp",
      "ApplicationName": "MyApp",
      "Enabled": true,
      "ActionIndexName": "myapp-action-logs",
      "UserIndexName": "myapp-user-logs",
      "AuditIndexName": "myapp-audit-logs",
      "OtherIndexName": "myapp-other-logs"
    }
  }
}

OTLP Logger (Grafana / Aspire Dashboard)

// Program.cs
builder.Services.AddOzOtlpLogger();

builder.Services.AddOpenTelemetry()
    .WithLogging(b => b.AddOtlpExporter(o =>
    {
        o.Endpoint = new Uri(builder.Configuration["OpenTelemetry:Endpoint"]!);
    }));

// appsettings.json
{
  "OpenTelemetry": {
    "Endpoint": "http://localhost:4317"
  }
}

Log categories used by OtlpLogger: OzLogger.Error, OzLogger.Warning, OzLogger.Debug, OzLogger.User, OzLogger.Audit, OzLogger.Action

Usage

All backends share the same IOzLogger interface:

public class OrderController : ControllerBase
{
    private readonly IOzLogger _logger;

    public OrderController(IOzLogger logger) => _logger = logger;

    [HttpPost]
    public async Task<IActionResult> Create(OrderRequest request)
    {
        try
        {
            // ...

            await _logger.ActionAsync(new ActionLog
            {
                ControllerName = "Order",
                ActionName     = "Create",
                Message        = "Order created",
                UserId         = GetUserId(),
                Username       = User.Identity!.Name
            });

            return Ok();
        }
        catch (Exception ex)
        {
            await _logger.ErrorAsync(ex, "Order creation failed",
                _ip:       HttpContext.Connection.RemoteIpAddress?.ToString(),
                _username: User.Identity?.Name,
                _userId:   GetUserId());

            return StatusCode(500);
        }
    }
}

Log Types

// Error
_logger.Error(ex, "message",
    _ip: "...", _username: "...", _userId: 1,
    _className: "OrderService", _functionName: "Create");

// Warning
_logger.Warning("message", _ip: "...", _username: "...", _userId: 1);

// Debug
_logger.Debug("message", _ip: "...", _username: "...", _userId: 1);

// User activity (login / logout)
_logger.User(new UserLog
{
    UserId         = 1,
    Username       = "oz",
    UserIpAddress  = "127.0.0.1",
    UserRoles      = "admin",
    UserLogType    = UserLogType.LogIn,  // WrongLogIn | LogIn | LogOut
    Date           = DateTime.UtcNow
});

// Controller action (automatic or manual)
_logger.Action(new ActionLog
{
    UserId         = 1,
    Username       = "oz",
    UserIpAddress  = "127.0.0.1",
    ControllerName = "Order",
    ActionName     = "Create",
    Message        = "Order created",
    Date           = DateTime.UtcNow
});

// Database change tracking
_logger.Audit(new List<AuditLog>
{
    new AuditLog
    {
        Entity    = "Product",
        EntityId  = 42,
        Table     = "products",
        Operation = "Update",
        Json      = "{...}",
        UserId    = 1,
        Username  = "oz",
        Date      = DateTime.UtcNow
    }
});

Automatic Action Logging with OzLoggerActionFilter

OzLoggerActionFilter automatically captures each controller action and logs it. It reads user identity from the following HTTP request headers:

// Program.cs — global (all controllers)
builder.Services.AddControllers(options =>
    options.Filters.Add<OzLoggerActionFilter>());

// Per-controller or per-action
[OzLoggerActionFilter]
public class ProductController : ControllerBase { ... }

Requirements

• .NET 8.0+
• Ozcorps.Core 8.0.0
• Ozcorps.Tools 8.0.0 (required by AddOzRabbitMqLogger)