Lyo.Diagnostic.AspNetCore 1.0.1

Lyo.Diagnostic.AspNetCore

ASP.NET Core integration for Lyo.Diagnostic: scoped breadcrumb trails per request and exception recording to the in-memory error inbox plus structured logging, without replacing your existing problem-details middleware.

Examples

Installation

using Lyo.Diagnostic.AspNetCore;

builder.Services.AddLyoDiagnosticsWeb(o =>
{
    o.MinimumSeverity = Lyo.Diagnostic.Classification.ExceptionSeverity.Low;
    o.BreadcrumbCapacity = 100;
    o.InMemoryInboxMaxOccurrences = 5_000;
    o.CorrelationIdHeaders = ["X-Correlation-Id", "X-Request-Id"];
});

// After outer middleware that catches and formats errors (e.g. LoggingMiddleware):
app.UseDiagnosticExceptionRecording();

Breadcrumbs in a controller

public sealed class OrdersController(IBreadcrumbTrail breadcrumbs)
{
    public async Task<IActionResult> Get(string id)
    {
        breadcrumbs.Add("orders", "Loading order", new Dictionary<string, string> { ["id"] = id });
        // ...
    }
}

Pipeline ordering

• This middleware sits closer to route handlers and runs first when an exception unwinds.
• It records the failure and calls IStructuredLogEnricher, then rethrows.
• Outer middleware can still build Problem Details / HTTP error bodies.

Options (DiagnosticWebOptions)

Breadcrumbs in a controller

Inject IBreadcrumbTrail (scoped) and add entries before risky work:

Do not put secrets or PII in breadcrumb data. See the Lyo.Diagnostic README.

Lyo.Api

Lyo.Api exposes AddLyoApiDiagnosticRecording as a convenience wrapper around AddLyoDiagnosticsWeb.

Dependencies

Generated from ProjectReference / PackageReference (same model as docs/Lyo.ProjectGraph.html).

• Lyo.Diagnostic — (direct, lyo)
• Lyo.Common — (transitive, lyo)
• Lyo.Exceptions — (transitive, lyo)
• Lyo.Hashing — (transitive, lyo)
• Lyo.PackageMetadata — (transitive, lyo)
• Microsoft.Extensions.DependencyInjection.Abstractions 10.0.5 — (transitive, microsoft)
• Microsoft.Extensions.Logging.Abstractions 10.0.5 — (transitive, microsoft)
• System.IO.Hashing 10.0.5 — (transitive, microsoft, net10.0)
• System.Memory 4.6.3 — (transitive, microsoft, netstandard2.0)
• System.Text.Json 10.0.5 — (transitive, microsoft, netstandard2.0)
• System.Threading.Tasks.Extensions 4.6.3 — (transitive, microsoft)