Serilog sink that writes to console with high-performance non-blocking output. Supports plaintext and JSON output but does not support themes and colors.
This sink uses a background channel with a single reader, efficient text buffer, and asynchronous writes to remove all blocking and lock contention to the console output stream. It also implements IDiposable
so calling Log.CloseAndFlush()
will ensure all lines are flushed.
Recommended for high-volume logging where console output is collected or redirected to another system, for example this library was originally created for large application clusters running in Kubernetes and logging hundreds of JSON objects every second.
- Built for
net6.0
,netstandard2.1
,netstandard2.0
- Release notes here: CHANGELOG.md
Install package from Nuget:
dotnet add package Serilog.Sinks.FastConsole
var config = new FastConsoleSinkOptions { UseJson = true };
Log.Logger = new LoggerConfiguration().WriteTo.FastConsole(config).CreateLogger();
- Serilog example for .NET 6: https://blog.datalust.co/using-serilog-in-net-6/
Name | Default | Description |
---|---|---|
UseJson |
true | Enable to write log events as a JSON object with { timestamp, level, message, properties } structure. Provide an ITextFormatter implementation instead to customize the output completely. |
QueueLimit |
null | Set max limit for the number of log entries queued in memory. Used to provide backpressure and avoid out-of-memory issues for high-volume logging. |
BlockWhenFull |
false | Set behavior when queue is full. When true this will block the thread until logs are output to console. Only applicable if QueueLimit is set. |