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.

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.