foundry-log 1.6.0

foundry-log

HTTP request/response logging middleware for ASP.NET Core. Captures request metadata and posts it as JSON to the Foundry Log API.

Installation

Then install the package:

dotnet add package foundry-log

Usage

builder.Services.AddFoundryLog(
    service: "my-api-service",
    apiUrl: "https://test.com/v1/foundrylog",
    apiKey: "your-api-key"
);

var app = builder.Build();
app.UseFoundryLog();

All three parameters are required:

Options

builder.Services.AddFoundryLog(
    service: "my-api-service",
    apiUrl: "https://test.com/v1/foundrylog",
    apiKey: "your-api-key",
    options =>
    {
        // When true, log dispatch runs in the background and won't delay responses.
        // Use false for AWS Lambda, true for long-running hosts (IIS, Kestrel).
        // Default: false
        options.FireAndForget = true;

        // Which log levels to send. Default: Slow | Warn | Error (info is excluded).
        options.SendLevels = FoundryLogLevel.Slow | FoundryLogLevel.Warn | FoundryLogLevel.Error;

        // To include all levels:
        // options.SendLevels = FoundryLogLevel.All;

        // Duration threshold in ms for "slow" classification. Default: 1200.
        options.SlowThresholdMs = 1200;

        // HTTP status codes to ignore entirely.
        options.IgnoreStatusCodes = [404];

        // Endpoints to exclude from logging.
        // Supports exact matches and wildcard patterns.
        options.IgnoreEndpoints =
        [
            new IgnoreEndpoint("/v1/health"),                          // ignore for all levels
            new IgnoreEndpoint("/v2/*"),                               // ignore for all levels
            new IgnoreEndpoint("/swagger/*"),                          // ignore for all levels
            new IgnoreEndpoint("/v1/polls", FoundryLogLevel.Info),     // ignore only info-level logs
            new IgnoreEndpoint("/v1/feed/*",
                FoundryLogLevel.Info | FoundryLogLevel.Slow)           // ignore info and slow
        ];
    }
);

Log levels

Each request is classified into a log level:

By default, only slow, warn, and error logs are sent.

What gets logged

Each request produces a JSON payload sent to the Foundry Log API:

Supported frameworks

• .NET 8
• .NET 10