OpenTelemetry.Extensions.AWS 1.16.0

Tracing with AWS Distro for OpenTelemetry .Net SDK

Status
Stability Stable
Code Owners @srprash, @normj

NuGet version badge NuGet download count badge codecov.io

If you want to send the traces to AWS X-Ray, you can do so by using AWS Distro with the OpenTelemetry SDK.

Getting Started

The OpenTelemetry SDK generates traces with W3C random ID which X-Ray backend doesn't currently support. You need to install the OpenTelemetry.Extensions.AWS to be able to use the AWS X-Ray id generator which generates X-Ray compatible trace IDs. If you plan to call another application instrumented with AWS X-Ray SDK, you'll need to configure the AWS X-Ray propagator as well.

dotnet add package OpenTelemetry.Extensions.AWS

Usage

AWS X-Ray Id Generator and Propagator

Configure AWS X-Ray ID generator and propagator globally in your application as follows. Make sure to call AddXRayTraceId() in the very beginning when creating TracerProvider.

using OpenTelemetry;
using OpenTelemetry.Extensions.AWS.Trace;
using OpenTelemetry.Trace;

var tracerProvider = Sdk.CreateTracerProviderBuilder()
                        .AddXRayTraceId()
                        // other instrumentations
                        ...
                        .Build();

Sdk.SetDefaultTextMapPropagator(new AWSXRayPropagator());

References

Showing the top 20 packages that depend on OpenTelemetry.Extensions.AWS.

Packages Downloads
Uptrace.OpenTelemetry
OpenTelemetry distribution that exports traces, metrics, and logs to Uptrace using OTLP/gRPC.
12

.NET 10.0

.NET Framework 4.6.2

.NET 8.0

.NET Standard 2.0

Version Downloads Last updated
1.17.0 1 08/03/2026
1.16.0 10 07/17/2026
1.15.1 1 07/22/2026
1.15.0 1 07/22/2026
1.14.2 1 07/22/2026
1.14.1 1 07/22/2026
1.14.0 1 07/22/2026
1.13.0 1 07/22/2026
1.12.1 1 07/22/2026
1.12.0 1 07/22/2026
1.11.3 1 07/22/2026
1.11.2 1 07/22/2026
1.11.1 1 07/22/2026
1.11.0 1 07/22/2026
1.10.0-rc.2 1 07/22/2026
1.10.0-rc.1 1 07/22/2026
1.10.0-beta.3 1 07/22/2026
1.10.0-beta.2 1 07/22/2026
1.10.0-beta.1 1 07/22/2026
1.3.0-beta.2 2 07/22/2026
1.3.0-beta.1 1 07/22/2026