jordanpurinton / aws-otel-js

AWS Distro for OpenTelemetry JavaScript SDK

Home Page:https://aws-otel.github.io/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

AWS Distro for OpenTelemetry JavaScript

Introduction

The AWS Distro for OpenTelemetry JavaScript contains components of OpenTelemetry JavaScript SDK, configured for use with AWS X-Ray. Check out the upstream project for documentation on the underlying features, APIs, and additional libraries. This repository only contains a small portion of components which will allow the OpenTelemetry JavaScript SDK to work with AWS X-Ray. The OpenTelemetry repository contains the rest.

We provided an ID generator and propagator, which can be configured from the OpenTelemetry upstream API. The telemetry data generated can be exported in a variety of formats and can be configured via command lines or environment variables. The aim of this project is to be able to gather telemetry data from a JavaScript application, propagate the AWS X-Ray trace header, and export trace data to the AWS X-Ray backend using the AWS Distro for OpenTelemetry Collector.

Getting Started

Check out the getting started documentation.

Supported Runtimes

For the complete list of supported runtimes, please refer to the upstream documentation here

How it works

The OpenTelemetry JavaScript SDK provides entry points with methods used for configuring aspects through its API. This custom configuration allows us to reconfigure the IdsGenerator which is needed in order to support the X-Ray Trace ID format. In addition, we are also able to use a custom propagator which is passed into the tracer provider to conform to AWS X-Ray headers.

Useful links

License

This project is licensed under the Apache-2.0 License.

About

AWS Distro for OpenTelemetry JavaScript SDK

https://aws-otel.github.io/

License:Apache License 2.0


Languages

Language:TypeScript 53.3%Language:JavaScript 46.2%Language:Dockerfile 0.5%