https://github.com/aws-observability/aws-otel-dotnet

AWS Distro for OpenTelemetry .NET
https://github.com/aws-observability/aws-otel-dotnet

observability opensource opentelemetry opentelemetry-api opentelemetry-dotnet

Last synced: 2 months ago
JSON representation

AWS Distro for OpenTelemetry .NET

• Host: GitHub
• URL: https://github.com/aws-observability/aws-otel-dotnet
• Owner: aws-observability
• License: apache-2.0
• Created: 2020-10-05T21:28:34.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2023-07-02T01:14:23.000Z (over 1 year ago)
• Last Synced: 2024-07-30T19:46:01.005Z (6 months ago)
• Topics: observability, opensource, opentelemetry, opentelemetry-api, opentelemetry-dotnet
• Language: C#
• Homepage: https://aws-otel.github.io/
• Size: 17 MB
• Stars: 21
• Watchers: 18
• Forks: 12
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# AWS Distro for OpenTelemetry .NET Language

## Introduction

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](https://github.com/open-telemetry/opentelemetry-dotnet) 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](https://github.com/aws-observability/aws-otel-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](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/awsxrayexporter).

## Getting Started 

Check out the getting started [documentation](https://aws-otel.github.io/docs/introduction)

## Sample Application

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](https://github.com/aws-observability/aws-otel-dotnet/tree/master/integration-test-app) for setup steps.

## Useful Links

* For more information on OpenTelemetry, visit their [website](https://opentelemetry.io/)

* [OpenTelemetry .NET core Repo](https://github.com/open-telemetry/opentelemetry-dotnet)

* [OpenTelemetry .NET Contrib Repo](https://github.com/open-telemetry/opentelemetry-dotnet-contrib)

* [AWS Distro for OpenTelemetry](https://aws-otel.github.io/)

* [AWS Distro for OpenTelemetry Collector](https://github.com/aws-observability/aws-otel-collector)

## Support 

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. 

## Security issue notifications

If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/). Please do **not** create a public github issue.

## License

This project is licensed under the Apache-2.0 License.