---
id: aws-xray-sdk
version: "2.15.0"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# aws-xray-sdk — The AWS X-Ray SDK for Python (the SDK) enables Python developers to record and emit information from within their applications to the AWS X-Ray service.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install aws-xray-sdk
uv add aws-xray-sdk
poetry add aws-xray-sdk

## Description

![Build Status](https://github.com/aws/aws-xray-sdk-python/actions/workflows/IntegrationTesting.yaml/badge.svg)
[![codecov](https://codecov.io/gh/aws/aws-xray-sdk-python/branch/master/graph/badge.svg)](https://codecov.io/gh/aws/aws-xray-sdk-python)

# AWS X-Ray SDK for Python

## :mega: Upcoming Maintenance Mode on February 25, 2026

[The AWS X-Ray SDKs will enter maintenance mode on **`February 25, 2026`**][xray-sdk-daemon-timeline]. During maintenance mode, the X-Ray SDKs and Daemon will only receive critical bug fixes and security updates, and will not be updated to support new features.

We recommend that you migrate to [AWS Distro for OpenTelemetry (ADOT) or OpenTelemetry Instrumentation][xray-otel-migration-docs] to generate traces (through manual or zero-code instrumentation) from your application and send them to AWS X-Ray. OpenTelemetry is the industry-wide standard for tracing instrumentation and observability. It has a large open-source community for support and provides more instrumentations and updates. By adopting an OpenTelemetry solution, developers can leverage the latest services and innovations from AWS CloudWatch.

## :mega: End-of-Support on February 25,...

## AI interpretation — verify before relying

Records and emits trace data from Python applications to AWS X-Ray for distributed tracing and service mapping. Provides context managers and manual instrumentation APIs to capture segments, subsegments, metadata, and annotations.

Verdict: Production-ready tracing SDK with zero runtime dependencies and clean installation. Active maintenance through early 2026, but AWS recommends migration to OpenTelemetry for new projects. No known security vulnerabilities. Suitable for teams already invested in AWS X-Ray; others should evaluate OpenTelemetry alternatives.

[View on SkillFed](https://skillfed.io/packages/aws-xray-sdk) · [View on PyPI](https://pypi.org/project/aws-xray-sdk/)