opentelemetry-sdk-extension-aws
AWS SDK extension for OpenTelemetry
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and is essential if you are using OpenTelemetry with AWS X-Ray. The permissive license and broad Python version support (3.8–3.12) make adoption straightforward. Install it if you need X-Ray compatibility; skip it if you are not using X-Ray or are not instrumenting AWS workloads.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires opentelemetry-sdk to be installed separately; Python 3.8 or later.
- Low install friction with a single runtime dependency on opentelemetry-sdk.
- Actively maintained as of 2026-08-14 with no known vulnerabilities.
License · maintenance · safety
permissive license (permissive) — Licensed under permissive terms (Apache Software License), imposing no restrictions on use or redistribution in proprietary or open-source projects.
last release 2024-12-24 (598 days) · last repo commit 2026-08-14 · 1,086 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 6,219,298 downloads/mo, #1,956 on PyPI
Alternatives
Verify before relying
pip install opentelemetry-sdk-extension-aws
import opentelemetry.trace as trace
from opentelemetry.sdk.extension.aws.trace import AwsXRayIdGenerator
from opentelemetry.sdk.trace import TracerProvider
trace.set_tracer_provider(
TracerProvider(id_generator=AwsXRayIdGenerator())
)- Whether resource detectors (e.g., AwsEc2ResourceDetector) require AWS credentials or IAM permissions to function.
- Performance overhead of resource detection on non-AWS environments or when detectors fail to retrieve metadata.
What it is and what it does
This package extends OpenTelemetry's SDK with AWS-specific components that bridge the gap between OpenTelemetry's distributed tracing model and AWS X-Ray's backend service. It provides an AwsXRayIdGenerator that formats span IDs and trace IDs in the format X-Ray expects, ensuring compatibility when exporting traces to X-Ray. It also includes resource detectors that automatically populate span resource attributes with AWS environment metadata—such as EC2 instance information—without requiring manual configuration.
The package is designed for developers instrumenting applications running on AWS infrastructure who want to use OpenTelemetry for observability while sending traces to X-Ray. It handles the translation layer between OpenTelemetry's semantic conventions and X-Ray's requirements, reducing boilerplate and configuration errors.
Use it for
- Configure OpenTelemetry tracing on an EC2 instance to automatically detect and attach instance metadata to spans sent to AWS X-Ray.
- Instrument a microservice deployed on AWS with OpenTelemetry while ensuring trace IDs remain compatible with X-Ray's trace format.
- Populate resource attributes (region, instance ID, availability zone) automatically when creating a TracerProvider for AWS workloads.
- Integrate OpenTelemetry into an existing AWS X-Ray observability pipeline without manual ID translation or resource mapping.
- Build a multi-service tracing setup on AWS where OpenTelemetry agents export traces to X-Ray with proper AWS resource context.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has no known vulnerabilities, low install friction, and is essential if you are using OpenTelemetry with AWS X-Ray. The permissive license and broad Python version support (3.8–3.12) make adoption straightforward. Install it if you need X-Ray compatibility; skip it if you are not using X-Ray or are not instrumenting AWS workloads.
Install
opentelemetry-sdk-extension-aws on PyPI
Before you install
Low install friction with a single runtime dependency on opentelemetry-sdk. Actively maintained as of 2026-08-14 with no known vulnerabilities.
Requires opentelemetry-sdk to be installed separately; Python 3.8 or later.
License in practice
Licensed under permissive terms (Apache Software License), imposing no restrictions on use or redistribution in proprietary or open-source projects.
Quickstart
pip install opentelemetry-sdk-extension-aws
import opentelemetry.trace as trace
from opentelemetry.sdk.extension.aws.trace import AwsXRayIdGenerator
from opentelemetry.sdk.trace import TracerProvider
trace.set_tracer_provider(
TracerProvider(id_generator=AwsXRayIdGenerator())
)Verify before relying
- Whether resource detectors (e.g., AwsEc2ResourceDetector) require AWS credentials or IAM permissions to function.
- Performance overhead of resource detection on non-AWS environments or when detectors fail to retrieve metadata.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packageopentelemetry-sdk |
| Maintenance | Actively maintained 598 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 6,219,298 / month, #1,956 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: opentelemetry_sdk_extension_aws-2.1.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “otel sdk aws extension”
- opentelemetry-sdk-extension-awsProvides OpenTelemetry SDK components to make distributed traces…
- aiobotocore-otelAdds distributed tracing to aiobotocore AWS API calls via…
- elastic-opentelemetryElastic's customized distribution of OpenTelemetry Python that…
Give your agent the search over MCP, or paste the wish link into any chat.
More Monitoring packages
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
Provides generated Python code for OpenTelemetry semantic conventions, enabling standardized attribute naming and constant definitions for instrumentation and telemetry collection.
Install it if you are using OpenTelemetry and want to follow semantic conventions correctly.
Provides the reference implementation of the OpenTelemetry API for collecting and exporting traces, metrics, and logs from Python applications.
Provides the abstract API and interfaces for OpenTelemetry instrumentation in Python, defining how to emit traces, metrics, and logs without tying code to a specific SDK implementation.
Exports OpenTelemetry observability data to an OpenTelemetry Collector using Protobuf-encoded messages over HTTP.
Install it if you are using OpenTelemetry in Python and need to send data to a Collector over HTTP.
Provides automatic instrumentation commands and programmatic APIs to inject distributed tracing into Python applications without code changes, detecting and instrumenting packages used by your program.
Install it if you need distributed tracing without code changes and have compatible instrumented packages in your environment.
See also opentelemetry-propagator-aws-xray · opentelemetry-resource-detector-containerid · aws-xray-sdk · azure-core-tracing-opentelemetry · opentelemetry-instrumentation-boto · opentelemetry-resource-detector-azure · aiobotocore-otel · opentelemetry-resourcedetector-docker · opentelemetry-resourcedetector-kubernetes · opentelemetry-exporter-gcp-trace