Configuration

All configuration is set once at process start via LOG.Configure(...). The call is not re-entrant — a second call throws InvalidOperationException. If you skip it entirely, defaults apply on first log write. Since v3.3.0, Configure is allowed again after LOG.Shutdown(), which restarts the pipeline with the options reset to their defaults.

using OzaLog;

LOG.Configure(o =>
{
    o.KeepDays = -7;
    o.SetFileSizeInMB(50);
    o.OutputFormat = LogOutputFormat.Json;
    o.ConfigureQuote(q => q.Enable = true);
});

1. LogOptions — main logger

1.1 File output

1.2 Output format (v3.1+)

1.3 Async pipeline behavior

1.4 Global exception capture (opt-in)

Does not intercept WPF DispatcherUnhandledException, WinForms ThreadException, or ASP.NET Core middleware exceptions — library can't reach those framework objects. Host app must hook those itself.

1.5 LogTypeDirectories — per-level subdirectories

o.TypeDirectories.DirectoryPath = "LogFiles";   // default if level-specific path is null
o.TypeDirectories.ErrorPath     = "ErrorLogs";  // route Error level to a separate folder
o.TypeDirectories.FatalPath     = "FatalLogs";
// TracePath / DebugPath / InfoPath / WarnPath / CustomPath also available

If a level-specific path is null, it falls back to DirectoryPath.

1.6 AsyncLogOptions — dispatcher tuning

Configured via o.ConfigureAsync(a => { ... }).

2. QuoteOptions — Quote pipeline (v3.1+)

Configured via o.ConfigureQuote(q => { ... }). Default is Enable = false — the Quote pipeline must be explicitly opted into.

LOG.Configure(o =>
{
    o.ConfigureQuote(q =>
    {
        q.Enable = true;
        q.OutputFormat = QuoteOutputFormat.Json;
        q.QuotePath = "Quotes";
        q.MaxOpenStreams = 500;
        q.MaxQueueSize = 50_000;
        q.MaxBatchSize = 500;
        q.FlushIntervalMs = 100;
        q.OnDropped = droppedCount => MyMetrics.RecordDrops(droppedCount);
    });
});

The Quote pipeline reuses the main logger's KeepDays and MaxFileSize settings for retention and file splitting. Quote files are cleaned up by the same LogRetentionCleaner.

3. Read-back via LOG.GetCurrentOptions()

After Configure, you can inspect the live configuration via the read-only view:

var current = LOG.GetCurrentOptions();

// Main logger
Console.WriteLine(current.OutputFormat);                  // Json
Console.WriteLine(current.TimeFormat);                    // "HH:mm:ss.fff"
Console.WriteLine(current.ShowThreadId);                  // true
Console.WriteLine(current.ShowThreadName);                // false
Console.WriteLine(current.HighPrecisionTimestamp);        // false
Console.WriteLine(current.MaxOpenFileStreams);            // 100
Console.WriteLine(current.AsyncOptions.MaxQueueSize);     // 10000

// Quote pipeline
Console.WriteLine(current.QuoteOptions.Enable);           // true
Console.WriteLine(current.QuoteOptions.OutputFormat);     // Json
Console.WriteLine(current.QuoteOptions.QuotePath);        // "Quotes"
Console.WriteLine(current.QuoteOptions.MaxOpenStreams);   // 500

All read-back values are wrapped in ReadOnlyLogOptions / ReadOnlyQuoteOptions — consumers cannot mutate the live config through this view.

4. Defaults summary (when LOG.Configure(...) is not called)

→ For a one-page API summary see API Reference.