NLog.Targets.OpenTelemetryHttp 6.1.4

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. .NET Framework 4.7.1 This package targets .NET Framework 4.7.1. The package is compatible with this framework or higher. 
dotnet add package NLog.Targets.OpenTelemetryHttp --version 6.1.4
                    


                    

                
NuGet\Install-Package NLog.Targets.OpenTelemetryHttp -Version 6.1.4
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="NLog.Targets.OpenTelemetryHttp" Version="6.1.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="NLog.Targets.OpenTelemetryHttp" Version="6.1.4" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="NLog.Targets.OpenTelemetryHttp" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add NLog.Targets.OpenTelemetryHttp --version 6.1.4
                    


                    

                
#r "nuget: NLog.Targets.OpenTelemetryHttp, 6.1.4"
#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. 
#:package NLog.Targets.OpenTelemetryHttp@6.1.4
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=NLog.Targets.OpenTelemetryHttp&version=6.1.4
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=NLog.Targets.OpenTelemetryHttp&version=6.1.4
                    


                            Install as a Cake Tool

NLog.Targets.OpenTelemetryHttp

Version AppVeyor

NLog OpenTelemetry target for exporting log events to an OpenTelemetry Collector or any OTLP/HTTP-compatible endpoint.

If having trouble with output, then check NLog InternalLogger for clues. See also Troubleshooting NLog.

See also:

Register Extension

NLog will only recognize the type-alias OpenTelemetry when loading from an NLog.config file after registering the extension:

<extensions>
    <add assembly="NLog.Targets.OpenTelemetryHttp"/>
</extensions>

Alternative - register from code using the fluent configuration API:

LogManager.Setup().SetupExtensions(ext => {
    ext.RegisterTarget<NLog.Targets.OpenTelemetryHttpTarget>();
});

Configuration Example

Typical endpoint URL is http://localhost:4318/v1/logs.

<targets>
    <target xsi:type="OpenTelemetry"
            name="otel"
            url="http://localhost:4318/v1/logs"
            serviceName="MyApplication"
            layout="${message}" />
</targets>

<rules>
    <logger name="*" minlevel="Info" writeTo="otel" />
</rules>

Supports the standard OpenTelemetry environment variables as fallback defaults:

  • OTEL_EXPORTER_OTLP_ENDPOINT
  • OTEL_EXPORTER_OTLP_LOGS_ENDPOINT
  • OTEL_EXPORTER_OTLP_HEADERS
  • OTEL_EXPORTER_OTLP_LOGS_HEADERS
  • OTEL_EXPORTER_OTLP_COMPRESSION
  • OTEL_EXPORTER_OTLP_LOGS_COMPRESSION
  • OTEL_EXPORTER_OTLP_TIMEOUT
  • OTEL_EXPORTER_OTLP_LOGS_TIMEOUT
  • OTEL_SERVICE_NAME
  • OTEL_RESOURCE_ATTRIBUTES

Parameters

Parameter Default Description
url OTEL_EXPORTER_OTLP_ENDPOINT OTLP/HTTP endpoint URL. Automatically append /v1/logs when missing.
layout ${message} Layout used to populate the OpenTelemetry LogRecord.Body field.
traceId ${activity:property=TraceId} Layout used to populate the OpenTelemetry LogRecord.TraceId field.
spanId ${activity:property=SpanId} Layout used to populate the OpenTelemetry LogRecord.SpanId field.
includeEventProperties true Includes NLog event properties as OpenTelemetry log attributes.
scopeName NLog OpenTelemetry instrumentation scope name.
serviceName ${appdomain:format=Friendly} OpenTelemetry service.name resource attribute.
serviceVersion ${assembly-version:Default=} OpenTelemetry service.version resource attribute.
hostName ${hostname} OpenTelemetry host.name resource attribute.
resourceAttributes OTEL_RESOURCE_ATTRIBUTES Additional OpenTelemetry resource attributes.
headers OTEL_EXPORTER_OTLP_HEADERS Additional HTTP headers.
Batching and Retry Default Description
batchSize 200 Maximum number of log events to send in a single HTTP payload.
compress None Optional payload compression. Supports None, GZip, and GZipFast.
maxPayloadSizeBytes 40960 Max payload size before splitting into multiple HTTP requests. Remember BatchSize
taskDelayMilliseconds 50 Delay before processing queued log events. Higher value can improve batching
taskTimeoutSeconds 150 Maximum time in seconds before cancellation of HTTP request.
retryCount 0 Number of retry attempts for failed write operations.
retryDelayMilliseconds 2500 Initial delay before retry after failed request. Delay doubles for each retry.
queueLimit 10000 Maximum number of pending log events allowed in the internal queue.
overflowAction Discard Action taken when the internal request queue reaches its limit.
Network and Security Default Description
sendTimeoutSeconds 30 HTTP request timeout in seconds.
sslCertificateFile Client certificate file used for mutual TLS authentication.
sslCertificatePassword Password for the client certificate.
proxyUrl Proxy server URL.
proxyUser Proxy authentication username.
proxyPassword Proxy authentication password.

Resource Attributes

Additional OpenTelemetry resource attributes can be configured using resourceAttribute entries:

<target xsi:type="OpenTelemetry" name="otel">

    <resourceAttribute name="service.namespace" layout="Backend" />
    <resourceAttribute name="deployment.environment" layout="Production" />

</target>

OpenTelemetry Environment Variables

The target automatically resolves standard OpenTelemetry environment variables when equivalent target properties have not been explicitly configured.

Endpoint

Order of precedence:

  1. OTEL_EXPORTER_OTLP_LOGS_ENDPOINT
  2. OTEL_EXPORTER_OTLP_ENDPOINT

When OTEL_EXPORTER_OTLP_ENDPOINT is used, /v1/logs is automatically appended.

Headers

Order of precedence:

  1. OTEL_EXPORTER_OTLP_LOGS_HEADERS
  2. OTEL_EXPORTER_OTLP_HEADERS

Example:

OTEL_EXPORTER_OTLP_HEADERS=api-key=my-secret-key

Compression

Order of precedence:

  1. OTEL_EXPORTER_OTLP_LOGS_COMPRESSION
  2. OTEL_EXPORTER_OTLP_COMPRESSION

Supported values:

  • gzip
  • none

Timeout

Order of precedence:

  1. OTEL_EXPORTER_OTLP_LOGS_TIMEOUT
  2. OTEL_EXPORTER_OTLP_TIMEOUT

Timeout values are specified in milliseconds.

Service Name

OTEL_SERVICE_NAME

Overrides the service.name value from OTEL_RESOURCE_ATTRIBUTES.

Resource Attributes

OTEL_RESOURCE_ATTRIBUTES

Example:

OTEL_RESOURCE_ATTRIBUTES=service.namespace=Backend,deployment.environment=Production

The special attribute:

service.name

is automatically mapped to the serviceName property.

Client Certificate

Order of precedence:

  1. OTEL_EXPORTER_OTLP_LOGS_CLIENT_CERTIFICATE
  2. OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE

Used to configure mutual TLS authentication.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.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 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
6.1.4 128 7/26/2026

Changelog:

- Initial Release of OpenTelemetryHttpTarget.