Skip to content
Simple .NET logging with fully-structured events
Branch: dev
Clone or download
nblumhardt Merge pull request #1342 from WeihanLi/dev
remove unnecessary System.Collections.NonGeneric dependency for netstandard2.0
Latest commit 53aafc0 Jul 11, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Fixed dead link to Sep 16, 2017
assets Removed CommonAssemblyInfo, it's not used anymore Dec 2, 2015
results Update perf tests to netcoreapp2 with output. May 18, 2018
src/Serilog remove unnecessary System.Collections.NonGeneric dependency for netst… Jul 10, 2019
test Merge pull request #1325 from nblumhardt/default-format Jun 22, 2019
.editorconfig LangVersion to latest May 15, 2019
.gitattributes Added gitattributes to set CRLF to auto. Apr 8, 2013
.gitignore Struct alternative to LogEventProperty; optimizations (#1315) May 29, 2019
Build.ps1 Removed TravisCI and replaced with AppVeyor for Linux builds. Apr 4, 2019
BuildNativeUWP.ps1 Struct alternative to LogEventProperty; optimizations (#1315) May 29, 2019 typos May 15, 2019 Removed detailed code in favour of Contributor Covenant link. Sep 4, 2017 Grammar fix [Skip CI] Sep 13, 2017
Directory.Build.props Use SourceLink and separate symbol packages. Jun 14, 2019
LICENSE GitHub Apache 2 licence template Oct 11, 2013
NuGet.config Some cleanup Jun 2, 2016 updated ps link to www for non-logged in users Apr 29, 2019
RunPerfTests.ps1 Updated (micro) benchmarks Aug 19, 2016
Serilog.sln Struct alternative to LogEventProperty; optimizations (#1315) May 29, 2019
Serilog.sln.DotSettings LoggerEnrichmentConfiguration.Wrap() May 29, 2019
Setup.ps1 Struct alternative to LogEventProperty; optimizations (#1315) May 29, 2019
appveyor-perftest.yml Independent Build for Perf Tests. Jun 2, 2017
appveyor.yml Fix AppVeyor artifact paths. Jun 14, 2019 Struct alternative to LogEventProperty; optimizations (#1315) May 29, 2019
global.json Struct alternative to LogEventProperty; optimizations (#1315) May 29, 2019 Update perf tests to netcoreapp2 with output. May 18, 2018 Struct alternative to LogEventProperty; optimizations (#1315) May 29, 2019

Serilog Build status Test status NuGet Version NuGet Downloads Join the chat at Stack Overflow

Serilog is a diagnostic logging library for .NET applications. It is easy to set up, has a clean API, and runs on all recent .NET platforms. While it's useful even in the simplest applications, Serilog's support for structured logging shines when instrumenting complex, distributed, and asynchronous applications and systems.


Like many other libraries for .NET, Serilog provides diagnostic logging to files, the console, and many other outputs.

var log = new LoggerConfiguration()

log.Information("Hello, Serilog!");

Unlike other logging libraries, Serilog is built from the ground up to record structured event data.

var position = new { Latitude = 25, Longitude = 134 };
var elapsedMs = 34;

log.Information("Processed {@Position} in {Elapsed} ms.", position, elapsedMs);

Serilog uses message templates, a simple DSL that extends .NET format strings with named as well as positional parameters. Instead of formatting events immediately into text, Serilog captures the values associated with each named parameter.

The example above records two properties, Position and Elapsed, in the log event. The @ operator in front of Position tells Serilog to serialize the object passed in, rather than convert it using ToString(). Serilog's deep and rich support for structured event data opens up a huge range of diagnostic possibilities not available when using traditional loggers.

Rendered into JSON format for example, these properties appear alongside the timestamp, level, and message like:

{"Position": {"Latitude": 25, "Longitude": 134}, "Elapsed": 34}

Back-ends that are capable of recording structured event data make log searches and analysis possible without log parsing or regular expressions.

Supporting structured data doesn't mean giving up text: when Serilog writes events to files or the console, the template and properties are rendered into friendly human-readable text just like a traditional logging library would produce:

09:14:22 [INF] Processed { Latitude: 25, Longitude: 134 } in 34 ms.

Upgrading from Serilog 1.x? Check out the 2.0 Upgrade Guide and Release Notes.


  • Community-backed and actively developed
  • Format-based logging API with familiar levels like Debug, Information, Warning, Error, and so-on
  • Discoverable C# configuration syntax and optional XML or JSON configuration support
  • Efficient when enabled, extremely low overhead when a logging level is switched off
  • Best-in-class .NET Core support, including a provider for Microsoft.Extensions.Logging
  • Support for a comprehensive range of sinks, including files, the console, on-premises and cloud-based log servers, databases, and message queues
  • Sophisticated enrichment of log events with contextual information, including scoped (LogContext) properties, thread and process identifiers, and domain-specific correlation ids such as HttpRequestId
  • Zero-shared-state Logger objects, with an optional global static Log class
  • Format-agnostic logging pipeline that can emit events in plain text, JSON, in-memory LogEvent objects (including Rx pipelines) and other formats

Getting started

Serilog is installed from NuGet. To view log events, one or more sinks need to be installed as well, here we'll use the pretty-printing console sink, and a rolling file set:

Install-Package Serilog
Install-Package Serilog.Sinks.Console
Install-Package Serilog.Sinks.File

The simplest way to set up Serilog is using the static Log class. A LoggerConfiguration is used to create and assign the default logger.

using Serilog;

public class Program
    public static void Main()
        Log.Logger = new LoggerConfiguration()
                rollingInterval: RollingInterval.Day,
                rollOnFileSizeLimit: true)
        Log.Information("Hello, Serilog!");

Find more, including a runnable example application, under the Getting Started topic in the documentation.

Getting help

To learn more about Serilog, check out the documentation - you'll find information there on the most common scenarios. If Serilog isn't working the way you expect, you may find the troubleshooting guide useful.

Serilog has an active and helpful community who are happy to help point you in the right direction or work through any issues you might encounter. You can get in touch via:


Would you like to help make Serilog 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
dev Build status
master Build status

Serilog is copyright © 2013-2018 Serilog Contributors - Provided under the Apache License, Version 2.0. Needle and thread logo a derivative of work by Kenneth Appiah.

You can’t perform that action at this time.