---
id: aiobotocore-otel
version: "1.7.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# aiobotocore-otel — OpenTelemetry aiobotocore instrumentation

License: permissive · Maintenance: active · Downloads: 142.4K/mo

## What it is and what it does

aiobotocore-otel is an OpenTelemetry instrumentation plugin for aiobotocore, the async AWS SDK client library. It automatically captures and exports trace data for all AWS API calls made through aiobotocore, including request attributes, response metadata, and errors. This enables distributed tracing across microservices that use aiobotocore for AWS interactions.

The package is a fork adapted to work with aiobotocore's async/await patterns. It integrates with the OpenTelemetry ecosystem (opentelemetry-api, opentelemetry-instrumentation, opentelemetry-semantic-conventions, and opentelemetry-propagator-aws-xray) to emit spans that can be exported to any OpenTelemetry-compatible backend. Once installed and initialized, it requires no code changes to your aiobotocore calls—instrumentation happens transparently.

Use it for:

- Trace async AWS API calls in serverless functions or microservices to debug latency and failures across service boundaries.
- Export aiobotocore spans to observability platforms for centralized monitoring of AWS SDK usage.
- Correlate aiobotocore requests with application logs and metrics using trace IDs propagated by OpenTelemetry.
- Audit and monitor which AWS services and operations are called by async Python applications without modifying application code.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds distributed tracing to aiobotocore AWS API calls via OpenTelemetry, capturing request/response metadata and propagating trace context across services.

Yes, if you use aiobotocore in an async application and need distributed tracing. The package is actively maintained, has no known vulnerabilities, low install friction, and integrates cleanly with the OpenTelemetry ecosystem. It is production-stable and supports current Python versions. Install it if observability of AWS SDK calls is a requirement; skip it if you have no tracing infrastructure or do not use aiobotocore.

## Install

pip install aiobotocore-otel
uv add aiobotocore-otel
poetry add aiobotocore-otel

## Installing aiobotocore-otel

Before you install: Low install friction with a pure-Python wheel. Active maintenance with a recent release. Supports current Python versions. Depends on the OpenTelemetry ecosystem and aiobotocore itself, all standard instrumentation packages.

License in practice: Licensed under Apache Software License (permissive). No restrictions on commercial or private use; you may modify and redistribute under the same terms.

Quickstart:

pip install aiobotocore-otel

from opentelemetry import trace
from opentelemetry.instrumentation.aiobotocore import AiobotocoreInstrumentor

AiobotocoreInstrumentor().instrument()
# Now aiobotocore calls are automatically traced

Requires Python >=3.10. Assumes an active OpenTelemetry SDK and exporter are already configured in your application.

Verify before relying:

- Whether the package works with all aiobotocore versions or has specific version constraints beyond what the fact sheet shows.
- Whether trace context propagation to downstream services works out-of-the-box or requires additional setup.
- Performance overhead of instrumentation on high-volume async workloads.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 142.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

opentelemetry aiobotocore tracing, aws sdk async instrumentation, distributed tracing boto async, opentelemetry aws instrumentation, aiobotocore observability, trace aws api calls async, otel instrumentation aiobotocore, observability, aws-instrumentation, async-tracing

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