{"id":21042767,"url":"https://github.com/aws-observability/aws-otel-js","last_synced_at":"2025-05-15T17:31:05.547Z","repository":{"id":37898486,"uuid":"295886063","full_name":"aws-observability/aws-otel-js","owner":"aws-observability","description":"AWS Distro for OpenTelemetry JavaScript SDK","archived":false,"fork":false,"pushed_at":"2025-05-12T17:43:52.000Z","size":17406,"stargazers_count":36,"open_issues_count":14,"forks_count":21,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-05-12T18:34:20.031Z","etag":null,"topics":["observability","opensource","opentelemetry","opentelemetry-api","opentelemetry-javascript"],"latest_commit_sha":null,"homepage":"https://aws-otel.github.io/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-observability.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-09-16T00:58:21.000Z","updated_at":"2025-05-12T17:42:29.000Z","dependencies_parsed_at":"2025-05-12T18:36:26.362Z","dependency_job_id":null,"html_url":"https://github.com/aws-observability/aws-otel-js","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-observability%2Faws-otel-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-observability","download_url":"https://codeload.github.com/aws-observability/aws-otel-js/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253805850,"owners_count":21967053,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["observability","opensource","opentelemetry","opentelemetry-api","opentelemetry-javascript"],"created_at":"2024-11-19T14:08:58.448Z","updated_at":"2025-05-15T17:31:05.250Z","avatar_url":"https://github.com/aws-observability.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS Distro for OpenTelemetry JavaScript Language\n\n## Introduction\n\nThis repo hosts documentation and sample apps for the ADOT JavaScript library which provides the AWS service integrations for traces and metrics for the [OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js) library. The library can be configured to support trace applications with the AWS X-Ray service.\n\nCheck 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. Note that ADOT is in preview for JavaScript metrics.\n\nWe 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](https://github.com/aws-observability/aws-otel-collector).\n\n## Getting Started\n\nCheck out the [getting started documentation](https://aws-otel.github.io/docs/getting-started/javascript-sdk).\n\n## Sample Application (DEPRECATED)\n\n**WARNING:** The sample app in this repository is deprecated and is no longer maintained.  Please use the [new standardized sample apps](https://github.com/aws-observability/aws-otel-community/tree/master/sample-apps).\n\n## Supported Runtimes\n\nFor the complete list of supported runtimes, please refer to the upstream documentation [here](https://github.com/open-telemetry/opentelemetry-js/blob/master/README.md#supported-runtimes)\n\n## How it works\n\nThe [OpenTelemetry JavaScript SDK](https://github.com/open-telemetry/opentelemetry-js) provides entry points with methods used for configuring vendor-specific aspects through its [API](https://www.npmjs.com/package/@opentelemetry/api). This custom configuration allows us to generate trace IDs which are compliant with the [X-Ray Trace ID format](https://docs.aws.amazon.com/xray/latest/devguide/xray-api-sendingdata.html#xray-api-traceids). 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.\n\n## Useful links\n\nFor more information on OpenTelemetry, visit: https://opentelemetry.io/\n\n## Security issue notifications\nIf 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.\n\n\n## License\n\nThis project is licensed under the Apache-2.0 License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-observability%2Faws-otel-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-observability%2Faws-otel-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-observability%2Faws-otel-js/lists"}