Serilog.Sinks.OpenTelemetry 3.0.0-dev-00298

The ID prefix of this package has been reserved for one of the owners of this package by Prefix Reserved
This is a prerelease version of Serilog.Sinks.OpenTelemetry.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Serilog.Sinks.OpenTelemetry --version 3.0.0-dev-00298
NuGet\Install-Package Serilog.Sinks.OpenTelemetry -Version 3.0.0-dev-00298
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Serilog.Sinks.OpenTelemetry" Version="3.0.0-dev-00298" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Serilog.Sinks.OpenTelemetry --version 3.0.0-dev-00298
#r "nuget: Serilog.Sinks.OpenTelemetry, 3.0.0-dev-00298"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Serilog.Sinks.OpenTelemetry as a Cake Addin
#addin nuget:?package=Serilog.Sinks.OpenTelemetry&version=3.0.0-dev-00298&prerelease

// Install Serilog.Sinks.OpenTelemetry as a Cake Tool
#tool nuget:?package=Serilog.Sinks.OpenTelemetry&version=3.0.0-dev-00298&prerelease

Serilog.Sinks.OpenTelemetry Build status NuGet Version

This Serilog sink transforms Serilog events into OpenTelemetry LogRecords and sends them to an OTLP (gRPC or HTTP) endpoint.

The sink aims for full compliance with the OpenTelemetry Logs protocol. It does not depend on the OpenTelemetry SDK or .NET API.

OpenTelemetry supports attributes with scalar values, arrays, and maps. Serilog does as well. Consequently, the sink does a one-to-one mapping between Serilog properties and OpenTelemetry attributes. There is no flattening, renaming, or other modifications done to the properties by default.

Getting started

To use the OpenTelemetry sink, first install the NuGet package:

dotnet add package Serilog.Sinks.OpenTelemetry

Then enable the sink using WriteTo.OpenTelemetry():

Log.Logger = new LoggerConfiguration()

Generate logs using the Log.Information(...) and similar methods to send transformed logs to a local OpenTelemetry OTLP endpoint.

A more complete configuration would specify Endpoint, Protocol, and other parameters, such asResourceAttributes, as shown in the examples below.


This sink supports two configuration styles: inline and options. The inline configuration looks like:

Log.Logger = new LoggerConfiguration()
        endpoint: "",
        protocol: OtlpProtocol.HttpProtobuf)

This configuration is appropriate only for simple, local logging setups.

More complicated use cases will need to use the options configuration, which looks like:

Log.Logger = new LoggerConfiguration()
    .WriteTo.OpenTelemetry(options =>
        options.Endpoint = "";
        options.Protocol = OtlpProtocol.HttpProtobuf;

This supports the sink's full set of configuration options. See the OpenTelemetrySinkOptions.cs file for the full set of options. Some of the more imporant parameters are discussed in the following sections.

Endpoint and protocol

The default endpoint is http://localhost:4317, which will send logs to an OpenTelemetry collector running on the same machine over the gRPC protocol. This is appropriate for testing or for using a local OpenTelemetry collector as a proxy for a downstream logging service.

In most production scenarios, you will want to set an endpoint. To do so, add the endpoint argument to the WriteTo.OpenTelemetry() call.

You may also want to set the protocol explicitly. The supported values are:

  • OtlpProtocol.Grpc: Sends a protobuf representation of the OpenTelemetry Logs over a gRPC connection (the default).
  • OtlpProtocol.HttpProtobuf: Sends a protobuf representation of the OpenTelemetry Logs over an HTTP connection.

When the OtlpProtocol.HttpProtobuf option is specified, the endpoint URL must include the full path, for example http://localhost:4318/v1/logs.

Resource attributes

OpenTelemetry logs may contain a "resource" that provides metadata concerning the entity associated with the logs, typically a service or library. These may contain "resource attributes" and are emitted for all logs flowing through the configured logger.

These resource attributes may be provided as a Dictionary<string, Object> when configuring a logger. OpenTelemetry allows resource attributes with rich values; however, this implementation only supports resource attributes with primitive values.

⚠️ Resource attributes with non-primitive values will be silently ignored.

This example shows how the resource attributes can be specified when the logger is configured.

Log.Logger = new LoggerConfiguration()
    .WriteTo.OpenTelemetry(options =>
        options.Endpoint = "";
        options.ResourceAttributes = new Dictionary<string, object>
            [""] = "test-logging-service",
            ["index"] = 10,
            ["flag"] = true,
            ["value"] = 3.14

Serilog LogEvent to OpenTelemetry log record mapping

The following table provides the mapping between the Serilog log events and the OpenTelemetry log records.

Serilog LogEvent OpenTelemetry LogRecord Comments
Exception.GetType().ToString() Attributes["exception.type"]
Exception.Message Attributes["exception.message"] Ignored if empty
Exception.StackTrace Attributes[ "exception.stacktrace"] Value of ex.ToString()
Level SeverityNumber Serilog levels are mapped to corresponding OpenTelemetry severities
Level.ToString() SeverityText
Message Body Culture-specific formatting can be provided via sink configuration
MessageTemplate Attributes[ "message_template.text"] Requires IncludedData. MessageTemplateText (enabled by default)
MessageTemplate (MD5) Attributes[ "message_template.hash.md5"] Requires IncludedData. MessageTemplateMD5 HashAttribute
Properties Attributes Each property is mapped to an attribute keeping the name; the value's structure is maintained
SpanId (Activity.Current) SpanId Requires IncludedData.SpanId (enabled by default)
Timestamp TimeUnixNano .NET provides 100-nanosecond precision
TraceId (Activity.Current) TraceId Requires IncludedData.TraceId (enabled by default)

Configuring included data

This sink supports configuration of how common OpenTelemetry fields are populated from the Serilog LogEvent and .NET Activity context via the IncludedData flags enum:

Log.Logger = new LoggerConfiguration()
    .WriteTo.OpenTelemetry(options =>
        options.Endpoint = "";
        options.IncludedData: IncludedData.MessageTemplate |
                              IncludedData.TraceId | IncludedData.SpanId;

The example shows the default value; IncludedData.MessageTemplateMD5HashAttribute can also be used to add the MD5 hash of the message template.


The example/Example subdirectory contains an example application that logs to a local OpenTelemetry collector. See the README in that directory for instructions on how to run the example.

Copyright © Serilog Contributors - Provided under the Apache License, Version 2.0.

Product 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 was computed.  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 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (18)

Showing the top 5 NuGet packages that depend on Serilog.Sinks.OpenTelemetry:

Package Downloads

Package Description


Relativity Transfer SDK allows performing high-throughput transfers of files from and to Relativity environment.

Fluxera.Extensions.Hosting.Modules.Serilog The ID prefix of this package has been reserved for one of the owners of this package by

A module that enables Serilog logging.


Package Description


Biblioteca com utilitários comuns para uso na AEVO.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Serilog.Sinks.OpenTelemetry:

Repository Stars
An core template based on .Net 8, Vertical Slice Architecture, CQRS, Minimal APIs, API Versioning and Swagger.
Version Downloads Last updated
3.0.0 13,147 6/6/2024
3.0.0-dev-00300 69 6/6/2024
3.0.0-dev-00298 2,357 5/8/2024
2.0.0 84,969 5/7/2024
2.0.0-dev-00289 88 5/7/2024
2.0.0-dev-00284 89 5/7/2024
2.0.0-dev-00282 61,577 3/18/2024
2.0.0-dev-00270 16,885 1/4/2024
2.0.0-dev-00261 806 1/2/2024
2.0.0-dev-00259 1,706 12/7/2023
1.2.0 763,347 11/15/2023
1.2.0-dev-00255 360 11/15/2023
1.2.0-dev-00253 463 11/9/2023
1.2.0-dev-00247 6,072 10/11/2023
1.2.0-dev-00243 482 10/3/2023
1.1.0 247,879 9/28/2023
1.1.0-dev-00239 443 9/28/2023
1.1.0-dev-00236 838 9/18/2023
1.0.3-dev-00230 4,801 8/24/2023
1.0.2 245,227 7/11/2023
1.0.2-dev-00227 604 7/10/2023
1.0.1 39,399 7/7/2023
1.0.1-dev-00223 589 7/7/2023
1.0.1-dev-00222 593 7/7/2023
1.0.1-dev-00218 5,316 6/13/2023
1.0.0 170,647 6/1/2023
1.0.0-dev-00214 1,523 5/30/2023
1.0.0-dev-00212 1,064 5/29/2023
1.0.0-dev-00208 6,309 5/26/2023
1.0.0-dev-00204 6,675 5/18/2023
1.0.0-dev-00202 1,577 5/17/2023
1.0.0-dev-00200 603 5/17/2023
1.0.0-dev-00194 812 5/15/2023
1.0.0-dev-00192 591 5/15/2023
1.0.0-dev-00188 2,308 5/5/2023
1.0.0-dev-00182 74 5/5/2023
1.0.0-dev-00178 502 5/4/2023
1.0.0-dev-00175 1,161 5/3/2023
1.0.0-dev-00173 1,741 5/2/2023
1.0.0-dev-00166 2,123 5/1/2023
1.0.0-dev-00161 86 4/30/2023
1.0.0-dev-00152 127 4/29/2023
1.0.0-dev-00151 324 4/29/2023
1.0.0-dev-00148 85 4/29/2023
1.0.0-dev-00143 3,775 4/24/2023
1.0.0-dev-00142 84 4/24/2023
1.0.0-dev-00141 86 4/24/2023
1.0.0-dev-00129 579 4/19/2023
1.0.0-dev-00128 111 4/19/2023
1.0.0-dev-00121 611 4/14/2023
1.0.0-dev-00120 234 4/14/2023
1.0.0-dev-00117 226 4/12/2023
1.0.0-dev-00113 44,459 3/14/2023
1.0.0-dev-00098 30,913 2/12/2023
1.0.0-dev-00091 113 2/12/2023
1.0.0-dev-00080 100 2/10/2023
0.5.0-dev-00078 1,370 2/9/2023
0.4.0-dev-00073 23,120 2/3/2023
0.2.0-dev-00063 7,139 1/23/2023
0.2.0-dev-00059 207 1/10/2023
0.1.0-dev-00048 101 1/10/2023
0.0.4-dev-00039 21,234 1/9/2023
0.0.3-dev-00036 106 1/9/2023
0.0.2-dev-00027 113 1/7/2023
0.0.1-dev-00018 104 1/4/2023
0.0.1-dev-00015 104 1/3/2023
0.0.1-dev-00013 106 1/3/2023