This repo hosts documentation and sample apps for the ADOT .NET library which provides the AWS service integrations for traces and metrics for the OpenTelemetry .NET library. The library can be configured to support trace applications with the AWS X-Ray service. This way, all the features of the OpenTelemetry project are available, but its components are configured to create traces which can be viewed in the AWS X-Ray console and are configured to allow propagation of those contexts across multiple downstream AWS services.
To send traces to AWS X-Ray, you can use the AWS Distro for OpenTelemetry (ADOT) Collector. OpenTelemetry .NET SDK exports traces from the application to the ADOT Collector. The ADOT Collector translates OTLP traces to X-Ray compatiable traces and further exports them to X-Ray backend. For more information, read AWS X-Ray Tracing Exporter for OpenTelemetry Collector.
Check out the getting started documentation
The sample app has included AspNetCore instrumentation, Http instrumentation and OTLP exporter. In addition, it instruments AWS X-Ray id generator in order for the AWS X-Ray back-end to process the traces. It also integrates AWS X-Ray propagator and AWS client instrumentation to trace AWS sdk calls.
See the example sample application for setup steps.
- For more information on OpenTelemetry, visit their website
- OpenTelemetry .NET core Repo
- OpenTelemetry .NET Contrib Repo
- AWS Distro for OpenTelemetry
- AWS Distro for OpenTelemetry Collector
Please note that as per policy, we're providing support via GitHub on a best effort basis. However, if you have AWS Enterprise Support you can create a ticket and we will provide direct support within the respective SLAs.
If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public github issue.
This project is licensed under the Apache-2.0 License.