---
id: opentelemetry-instrumentation-aiohttp-server
version: "0.65b0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# opentelemetry-instrumentation-aiohttp-server — Aiohttp server instrumentation for OpenTelemetry

License: permissive · Maintenance: active · Downloads: 1.4M/mo

## What it is and what it does

This package integrates OpenTelemetry tracing into aiohttp server applications, automatically capturing HTTP request and response data for distributed tracing. It works by instrumenting the aiohttp server library to emit trace spans that can be exported to observability backends like Jaeger, Datadog, or other OpenTelemetry-compatible collectors.

The package depends on opentelemetry-api, opentelemetry-instrumentation, opentelemetry-semantic-conventions, opentelemetry-util-http, and wrapt to hook into aiohttp's request lifecycle. It requires Python 3.10 or later and is designed for developers building async web services who need visibility into HTTP traffic patterns, latencies, and errors across distributed systems.

Use it for:

- Add distributed tracing to an aiohttp server to track request flows across microservices
- Export HTTP request spans to a tracing backend for performance monitoring and debugging
- Correlate aiohttp server requests with upstream client traces in a full-stack observability setup
- Capture HTTP metadata (status codes, headers, latency) automatically without modifying handler code

## Worth the install?

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

Adds distributed tracing to aiohttp server applications by instrumenting HTTP requests with OpenTelemetry, capturing request/response metadata for observability.

Yes, if you are running aiohttp servers and need distributed tracing. The package has low install friction, active maintenance, no known vulnerabilities, and Apache-2.0 licensing. The Beta status warrants checking release notes, but the OpenTelemetry ecosystem is mature and widely used in production. Install it as part of your observability stack.

## Install

pip install opentelemetry-instrumentation-aiohttp-server
uv add opentelemetry-instrumentation-aiohttp-server
poetry add opentelemetry-instrumentation-aiohttp-server

## Installing opentelemetry-instrumentation-aiohttp-server

Before you install: Low friction install with a stable dependency chain. Actively maintained as of 2026-08-14 with recent releases; marked Beta but part of the established OpenTelemetry ecosystem.

License in practice: Apache-2.0 permissive license allows use in most projects, including proprietary software, with minimal legal friction.

Quickstart:

pip install opentelemetry-instrumentation-aiohttp-server

from opentelemetry.instrumentation.aiohttp_server import AioHttpServerInstrumentor

AioHttpServerInstrumentor().instrument()

Requires Python 3.10 or later; aiohttp server library must be installed separately and configured before instrumentation is applied.

Verify before relying:

- Whether this version (0.65b0) is production-ready or still experimental despite Beta status
- Compatibility with specific aiohttp server versions not listed in the fact sheet
- Performance overhead of instrumentation in high-throughput scenarios

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aiohttp server tracing, opentelemetry http instrumentation, distributed tracing aiohttp, http request observability, opentelemetry aiohttp integration, observability, distributed-tracing, async-web

[View on SkillFed](https://skillfed.io/packages/opentelemetry-instrumentation-aiohttp-server) · [View on PyPI](https://pypi.org/project/opentelemetry-instrumentation-aiohttp-server/)