OpenTelemetry.Extensions.AWS 1.21.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
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET.
14
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET
12
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET.
12
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET.
11
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET.
10
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET.
9
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET
9
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET.
8
OpenTelemetry.Instrumentation.AWSLambda
AWS Lambda tracing wrapper for OpenTelemetry .NET.
7

.NET 10.0

.NET 11.0

.NET Framework 4.6.2

.NET Standard 2.0

Version Downloads Last updated
1.21.0 2 11/14/2026
1.20.3 2 11/06/2026
1.20.2 1 10/31/2026
1.20.1 1 10/28/2026
1.20.0 4 10/21/2026
1.19.1 3 10/07/2026
1.19.0 1 09/30/2026
1.18.0 6 08/26/2026
1.17.0 6 07/27/2026
1.16.0 6 06/23/2026
1.15.1 5 06/30/2026
1.15.0 7 06/29/2026
1.14.2 5 06/29/2026
1.14.1 3 06/29/2026
1.14.0 6 06/29/2026
1.13.0 6 06/29/2026
1.12.1 6 06/29/2026
1.12.0 5 06/30/2026
1.11.3 5 06/29/2026
1.11.2 6 07/18/2026
1.11.1 3 06/23/2026
1.11.0 4 06/30/2026
1.10.0-rc.2 5 06/29/2026
1.10.0-rc.1 6 06/29/2026
1.10.0-beta.3 8 06/23/2026
1.10.0-beta.2 6 06/23/2026
1.10.0-beta.1 5 06/23/2026
1.3.0-beta.2 4 06/29/2026
1.3.0-beta.1 8 04/23/2024