IBeam.Services.Logging 2.9.1

IBeam.Services.Logging

IBeam.Services.Logging provides audit and system-log sinks for IBeam service operations.

dotnet add package IBeam.Services.Logging

When To Use This

• You want service CRUD and custom operation changes to be audited.
• You want audit output through ILogger, a repository, or Azure Table Storage.
• You want unexpected API/system errors and service audit records to share a durable IBeamSystemLogs table.
• You need actor/request metadata such as user ID, tenant ID, correlation ID, IP address, user agent, or device ID.

What This Package Contains

Architecture Fit

API <-- DTO/model object --> Service <-- Entity --> Repository

The service method is the audit boundary. This package stores or transports audit records generated by IBeam.Services; it should not decide whether a user may perform the operation.

Quick Start

Log through ILogger:

builder.Services.AddIBeamLoggerAuditTrail(builder.Configuration);
builder.Services.AddIBeamHttpContextAuditActor();

Persist through an IBeam repository:

builder.Services.AddIBeamRepositoryAuditTrail(builder.Configuration);
builder.Services.AddIBeamHttpContextAuditActor();

Persist to Azure Table Storage:

using IBeam.Services.Logging.AzureTable;

builder.Services.AddIBeamAzureTableSystemLogs(builder.Configuration);
builder.Services.AddIBeamHttpContextAuditActor();

Audit Configuration

Service audit options live under IBeam:Services:Audit:

{
  "IBeam": {
    "Services": {
      "Audit": {
        "Enabled": true,
        "DefaultMode": "AuditWrites",
        "EnableSelectAudits": false,
        "SelectMode": "DailyRollup",
        "CaptureBefore": true,
        "CaptureAfter": true,
        "FailOnAuditError": false
      }
    }
  }
}

Azure Table Configuration

Azure Table system-log options live under IBeam:Logging:AzureTable:

{
  "IBeam": {
    "Logging": {
      "AzureTable": {
        "StorageConnectionString": "<connection-string>",
        "TablePrefix": "IBeam",
        "TableName": "SystemLogs",
        "CreateTableIfNotExists": true
      }
    }
  }
}

Connection string fallback also checks shared IBeam/Azure Table connection settings such as IBeam:AzureTables, IBeam:ConnectionString, ConnectionStrings:AzureTables, ConnectionStrings:AzureStorage, ConnectionStrings:IBeam, and ConnectionStrings:DefaultConnection.

With TablePrefix = "IBeam" and TableName = "SystemLogs", the physical table is IBeamSystemLogs.

Azure Table Schema

IBeamSystemLogs

Purpose: stores system log events, service audit transactions, and select-audit rollups.

Data Storage

Extended Docs And Agent Guidance

• AI prompt: .agent/prompt.md
• Root implementation guide: ../.agent/implementation-guide.md
• Service logging and audit: ../docs/service-logging-and-audit.md
• Service operation permissions: ../docs/service-operation-permissions.md

Agents should wire logging at the application composition root and keep audit decisions in services.

Troubleshooting

Version Notes

• Targets net10.0.
• Uses ILogger, IBeam repositories, and Azure Table Storage depending on registration.
• Package version is assigned by the repository release workflow.