Serilog.Sinks.Console
6.0.0-dev-00946
Prefix Reserved
See the version list below for details.
dotnet add package Serilog.Sinks.Console --version 6.0.0-dev-00946
NuGet\Install-Package Serilog.Sinks.Console -Version 6.0.0-dev-00946
<PackageReference Include="Serilog.Sinks.Console" Version="6.0.0-dev-00946" />
paket add Serilog.Sinks.Console --version 6.0.0-dev-00946
#r "nuget: Serilog.Sinks.Console, 6.0.0-dev-00946"
// Install Serilog.Sinks.Console as a Cake Addin #addin nuget:?package=Serilog.Sinks.Console&version=6.0.0-dev-00946&prerelease // Install Serilog.Sinks.Console as a Cake Tool #tool nuget:?package=Serilog.Sinks.Console&version=6.0.0-dev-00946&prerelease
Serilog.Sinks.Console
A Serilog sink that writes log events to the Windows Console or an ANSI terminal via standard output. Coloring and custom themes are supported, including ANSI 256-color themes on macOS, Linux and Windows 10. The default output is plain text; JSON formatting can be plugged in using a package such as Serilog.Formatting.Compact.
Getting started
To use the console sink, first install the NuGet package:
dotnet add package Serilog.Sinks.Console
Then enable the sink using WriteTo.Console()
:
Log.Logger = new LoggerConfiguration()
.WriteTo.Console()
.CreateLogger();
Log.Information("Hello, world!");
Log events will be printed to STDOUT
:
[12:50:51 INF] Hello, world!
Themes
The sink will colorize output by default:
Themes can be specified when configuring the sink:
.WriteTo.Console(theme: AnsiConsoleTheme.Code)
The following built-in themes are available:
ConsoleTheme.None
- no stylingSystemConsoleTheme.Literate
- styled to replicate Serilog.Sinks.Literate, using theSystem.Console
coloring modes supported on all Windows/.NET targets; this is the default when no theme is specifiedSystemConsoleTheme.Grayscale
- a theme using only shades of gray, white, and blackAnsiConsoleTheme.Literate
- an ANSI 256-color version of the "literate" themeAnsiConsoleTheme.Grayscale
- an ANSI 256-color version of the "grayscale" themeAnsiConsoleTheme.Code
- an ANSI 256-color Visual Studio Code-inspired themeAnsiConsoleTheme.Sixteen
- an ANSI 16-color theme that works well with both light and dark backgrounds
Adding a new theme is straightforward; examples can be found in the SystemConsoleThemes
and AnsiConsoleThemes
classes.
Output templates
The format of events to the console can be modified using the outputTemplate
configuration parameter:
.WriteTo.Console(
outputTemplate: "[{Timestamp:HH:mm:ss} {Level:u3}] {Message:lj}{NewLine}{Exception}")
The default template, shown in the example above, uses built-in properties like Timestamp
and Level
. Properties from events, including those attached using enrichers, can also appear in the output template.
JSON output
The sink can write JSON output instead of plain text. CompactJsonFormatter
or RenderedCompactJsonFormatter
from Serilog.Formatting.Compact is recommended:
dotnet add package Serilog.Formatting.Compact
Pass a formatter to the Console()
configuration method:
.WriteTo.Console(new RenderedCompactJsonFormatter())
Output theming is not available when custom formatters are used.
XML <appSettings>
configuration
To use the console sink with the Serilog.Settings.AppSettings package, first install that package if you haven't already done so:
dotnet add package Serilog.Settings.AppSettings
Instead of configuring the logger in code, call ReadFrom.AppSettings()
:
var log = new LoggerConfiguration()
.ReadFrom.AppSettings()
.CreateLogger();
In your application's App.config
or Web.config
file, specify the console sink assembly under the <appSettings>
node:
<configuration>
<appSettings>
<add key="serilog:using:Console" value="Serilog.Sinks.Console" />
<add key="serilog:write-to:Console" />
To configure the console sink with a different theme and include the SourceContext
in the output, change your App.config
/Web.config
to:
<configuration>
<appSettings>
<add key="serilog:using:Console" value="Serilog.Sinks.Console" />
<add key="serilog:write-to:Console.theme" value="Serilog.Sinks.SystemConsole.Themes.AnsiConsoleTheme::Code, Serilog.Sinks.Console" />
<add key="serilog:write-to:Console.outputTemplate" value="[{Timestamp:HH:mm:ss} {Level:u3}] {Message:lj} <s:{SourceContext}>{NewLine}{Exception}" />
JSON appsettings.json
configuration
To use the console sink with Microsoft.Extensions.Configuration, for example with ASP.NET Core or .NET Core, use the Serilog.Settings.Configuration package. First install that package if you have not already done so:
dotnet add package Serilog.Settings.Configuration
Instead of configuring the sink directly in code, call ReadFrom.Configuration()
:
var configuration = new ConfigurationBuilder()
.AddJsonFile("appsettings.json")
.Build();
var logger = new LoggerConfiguration()
.ReadFrom.Configuration(configuration)
.CreateLogger();
In your appsettings.json
file, under the Serilog
node, :
{
"Serilog": {
"WriteTo": [{"Name": "Console"}]
}
}
To configure the console sink with a different theme and include the SourceContext
in the output, change your appsettings.json
to:
{
"Serilog": {
"WriteTo": [
{
"Name": "Console",
"Args": {
"theme": "Serilog.Sinks.SystemConsole.Themes.AnsiConsoleTheme::Code, Serilog.Sinks.Console",
"outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] {Message:lj} <s:{SourceContext}>{NewLine}{Exception}"
}
}
]
}
}
Performance
Console logging is synchronous and this can cause bottlenecks in some deployment scenarios. For high-volume console logging, consider using Serilog.Sinks.Async to move console writes to a background thread:
// dotnet add package serilog.sinks.async
Log.Logger = new LoggerConfiguration()
.WriteTo.Async(wt => wt.Console())
.CreateLogger();
Contributing
Would you like to help make the Serilog console sink even better? We keep a list of issues that are approachable for newcomers under the up-for-grabs label. Before starting work on a pull request, we suggest commenting on, or raising, an issue on the issue tracker so that we can help and coordinate efforts. For more details check out our contributing guide.
When contributing please keep in mind our Code of Conduct.
Detailed build status
Branch | AppVeyor | Travis |
---|---|---|
dev | ||
main |
Copyright © Serilog Contributors - Provided under the Apache License, Version 2.0.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 is compatible. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
NuGet packages (1.4K)
Showing the top 5 NuGet packages that depend on Serilog.Sinks.Console:
Package | Downloads |
---|---|
Serilog.AspNetCore
Serilog support for ASP.NET Core logging |
|
Serilog.Sinks.ColoredConsole
Now replaced by Serilog.Sinks.Console, please use that package instead. The colored console sink for Serilog |
|
Serilog.Sinks.Literate
Now replaced by Serilog.Sinks.Console, please use that package instead. An alternative colored console sink for Serilog that pretty-prints properties. |
|
Pulumi
The Pulumi .NET SDK lets you write cloud programs in C#, F#, and VB.NET. |
|
IppDotNetSdkForQuickBooksApiV3
The IPP .NET SDK for QuickBooks V3 is a set of .NET classes that make it easier to call QuickBooks APIs. This is the .Net Standard 2.0 version of the .Net SDK |
GitHub repositories (406)
Showing the top 5 popular GitHub repositories that depend on Serilog.Sinks.Console:
Repository | Stars |
---|---|
jellyfin/jellyfin
The Free Software Media System - Server Backend & API
|
|
netchx/netch
A simple proxy client
|
|
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
|
|
IdentityServer/IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
|
|
reactiveui/refit
The automatic type-safe REST library for .NET Core, Xamarin and .NET. Heavily inspired by Square's Retrofit library, Refit turns your REST API into a live interface.
|
Version | Downloads | Last updated |
---|---|---|
6.0.0 | 19,154,894 | 6/9/2024 |
6.0.0-dev-00946 | 260 | 6/9/2024 |
5.1.0-dev-00943 | 246,756 | 3/17/2024 |
5.0.2-dev-00942 | 321 | 3/17/2024 |
5.0.1 | 28,964,395 | 11/28/2023 |
5.0.1-dev-00928 | 751 | 11/28/2023 |
5.0.0 | 39,615,421 | 11/9/2023 |
5.0.0-dev-00923 | 72,146 | 10/12/2023 |
4.2.0-dev-00918 | 232,489 | 7/21/2023 |
4.1.1-dev-00917 | 9,781 | 7/21/2023 |
4.1.1-dev-00910 | 354,283 | 3/14/2023 |
4.1.1-dev-00907 | 251,014 | 2/3/2023 |
4.1.1-dev-00901 | 119,933 | 1/6/2023 |
4.1.1-dev-00896 | 476,977 | 9/27/2022 |
4.1.0 | 78,445,120 | 9/6/2022 |
4.1.0-dev-00893 | 1,091 | 9/5/2022 |
4.0.2-dev-00890 | 544,247 | 12/22/2021 |
4.0.1 | 157,182,758 | 11/19/2021 |
4.0.1-dev-00879 | 83,893 | 10/21/2021 |
4.0.1-dev-00876 | 310,657 | 8/3/2021 |
4.0.1-dev-00874 | 55,805 | 7/13/2021 |
4.0.0 | 22,335,584 | 7/12/2021 |
4.0.0-dev-00870 | 1,208 | 7/12/2021 |
4.0.0-dev-00839 | 5,175,904 | 1/24/2020 |
4.0.0-dev-00837 | 48,642 | 1/15/2020 |
4.0.0-dev-00834 | 722,448 | 11/22/2019 |
4.0.0-dev-00832 | 1,498 | 11/22/2019 |
4.0.0-dev-00831 | 14,645 | 11/22/2019 |
3.1.2-dev-00824 | 541,393 | 9/13/2019 |
3.1.2-dev-00823 | 55,905 | 8/22/2019 |
3.1.2-dev-00819 | 15,465 | 8/21/2019 |
3.1.2-dev-00811 | 21,208 | 8/15/2019 |
3.1.2-dev-00806 | 30,179 | 8/2/2019 |
3.1.2-dev-00802 | 88,387 | 7/5/2019 |
3.1.2-dev-00800 | 53,595 | 6/24/2019 |
3.1.2-dev-00798 | 74,425 | 5/12/2019 |
3.1.2-dev-00796 | 12,629 | 5/6/2019 |
3.1.2-dev-00792 | 83,626 | 3/14/2019 |
3.1.2-dev-00788 | 109,469 | 1/15/2019 |
3.1.2-dev-00786 | 8,173 | 1/5/2019 |
3.1.2-dev-00779 | 235,626 | 9/22/2018 |
3.1.2-dev-00777 | 445,190 | 5/21/2018 |
3.1.2-dev-00774 | 35,407 | 5/9/2018 |
3.1.2-dev-00771 | 18,287 | 4/29/2018 |
3.1.1 | 233,296,931 | 10/22/2017 |
3.1.1-dev-00764 | 2,063 | 10/22/2017 |
3.1.1-dev-00762 | 1,934 | 10/22/2017 |
3.1.1-dev-00757 | 40,427 | 9/11/2017 |
3.1.0 | 854,110 | 9/11/2017 |
3.0.2-dev-00753 | 14,444 | 8/1/2017 |
3.0.1 | 18,393,820 | 6/23/2017 |
3.0.1-dev-00749 | 2,024 | 6/22/2017 |
3.0.1-dev-00747 | 2,041 | 6/22/2017 |
3.0.0 | 260,493 | 6/21/2017 |
3.0.0-dev-00737 | 2,003 | 6/21/2017 |
3.0.0-dev-00735 | 1,991 | 6/21/2017 |
3.0.0-dev-00734 | 1,955 | 6/19/2017 |
3.0.0-dev-00732 | 2,036 | 6/19/2017 |
2.2.0-dev-00721 | 26,468 | 1/25/2017 |
2.2.0-dev-00719 | 4,755 | 10/25/2016 |
2.1.0 | 1,220,994 | 7/5/2016 |
2.1.0-dev-00715 | 1,997 | 7/5/2016 |
2.1.0-dev-00713 | 1,946 | 7/5/2016 |
2.0.0 | 607,756 | 6/28/2016 |
2.0.0-rc-709 | 2,953 | 5/26/2016 |
2.0.0-beta-707 | 2,089 | 5/17/2016 |
2.0.0-beta-706 | 1,865 | 5/17/2016 |
2.0.0-beta-700 | 2,274 | 3/23/2016 |
2.0.0-beta-513 | 1,912 | 3/15/2016 |
2.0.0-beta-511 | 1,898 | 3/14/2016 |
2.0.0-beta-509 | 2,033 | 3/13/2016 |
2.0.0-beta-507 | 2,242 | 3/1/2016 |
2.0.0-beta-505 | 2,286 | 2/25/2016 |
2.0.0-beta-502 | 2,094 | 2/22/2016 |
2.0.0-beta-499 | 2,031 | 2/21/2016 |
2.0.0-beta-495 | 1,967 | 2/19/2016 |
2.0.0-beta-494 | 1,976 | 2/18/2016 |
2.0.0-beta-493 | 2,011 | 2/18/2016 |
2.0.0-beta-487 | 1,918 | 2/16/2016 |
2.0.0-beta-486 | 1,921 | 2/11/2016 |
2.0.0-beta-479 | 1,910 | 2/9/2016 |
2.0.0-beta-478 | 1,938 | 2/9/2016 |
2.0.0-beta-465 | 1,916 | 1/26/2016 |
2.0.0-beta-456 | 1,874 | 1/20/2016 |
2.0.0-beta-450 | 2,198 | 1/14/2016 |
2.0.0-beta-449 | 2,697 | 1/14/2016 |