XenoAtom.Logging

High-performance structured logging for .NET.
Zero-allocation hot path, predictable async behavior, and rich terminal/UI output.

Core package

Install XenoAtom.Logging for core runtime APIs, async processing, formatters, and file/JSON sinks.

dotnet add package XenoAtom.Logging

Terminal package (optional)

Add XenoAtom.Logging.Terminal for markup logs, rich segment styling, and LogControl integration powered by XenoAtom.Terminal.UI.

dotnet add package XenoAtom.Logging.Terminal

LogControl demo (markup + structured logs + background producer):

Features

Zero-allocation hot path

Interpolation handlers and generated logging methods minimize allocations on enabled logging paths.

Sync-first, async when needed

Use sync processing by default, or switch to async with explicit queue capacity and overflow policies.

Structured + generated APIs

Use properties/scopes with `[LogMethod]` and `[LogFormatter]` generation for strongly typed APIs.

Production-ready sinks

File rolling, retention, failure handling, JSONL output, and runtime diagnostics.

Terminal + LogControl rendering

Render rich logs, markup, and visuals in terminal apps and fullscreen UIs with XenoAtom.Terminal.UI.

Migration guidance

If you use Microsoft.Extensions.Logging, follow a practical migration path to equivalent patterns.