aiobotocore-otel

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 on this page — 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

aiobotocore-otel on PyPI

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

Evidence: aiobotocore_otel-1.7.0-py3-none-any.whl

Tags

More Monitoring packages