opentelemetry-instrumentation-aiopg

What it is and what it does

This package integrates OpenTelemetry tracing into aiopg, the async PostgreSQL driver for Python. When installed and initialized, it automatically wraps aiopg database calls to emit spans—structured records of database operations—that can be exported to observability platforms for monitoring, debugging, and performance analysis.

It sits between your application and aiopg, intercepting queries and connections to record timing, status, and query details. The instrumentation depends on opentelemetry-instrumentation-dbapi for shared database tracing logic and wrapt for non-invasive function wrapping. It is currently in beta (version 0.65b0) and requires Python 3.10 or later.

Use it for:

• Monitor query latency and database operation timing in async web applications using aiopg.
• Correlate database calls with HTTP requests and other services in distributed tracing systems.
• Debug slow or failing database operations by examining detailed spans in a tracing backend.
• Track database connection pool behavior and identify bottlenecks in async workloads.
• Export database metrics to observability platforms like Jaeger or Datadog for centralized monitoring.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adds distributed tracing instrumentation for aiopg, an async PostgreSQL driver, to automatically capture and export database operations as OpenTelemetry spans.

Yes, if you use aiopg in an async application and need distributed tracing. The low install friction, active maintenance, permissive license, and zero known vulnerabilities make it safe to adopt. The beta status is not a blocker—it reflects ongoing refinement, not instability. Install it if observability of your async database layer is a priority; skip it if you have no tracing infrastructure or do not use aiopg.

Install

opentelemetry-instrumentation-aiopg on PyPI

pip install opentelemetry-instrumentation-aiopg

uv add opentelemetry-instrumentation-aiopg

poetry add opentelemetry-instrumentation-aiopg

Installing opentelemetry-instrumentation-aiopg

Before you install

Low install friction with four runtime dependencies. Actively maintained as of 2026-08-14 with recent releases. Beta status (0.65b0) indicates the instrumentation is still stabilizing but usable.

License in practice

Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions beyond attribution.

Quickstart

pip install opentelemetry-instrumentation-aiopg

from opentelemetry.instrumentation.aiopg import AiopgInstrumentor
AiopgInstrumentor().instrument()

Requires Python 3.10 or later; aiopg must be installed and used in an async context; an OpenTelemetry exporter must be configured separately to send traces.

Verify before relying

• Whether instrumentation works with all aiopg connection pool patterns or only direct connections.
• Performance overhead of tracing in high-throughput async database workloads.
• Compatibility with specific OpenTelemetry exporter backends (Jaeger, Datadog, etc.).

Package facts

Evidence: opentelemetry_instrumentation_aiopg-0.65b0-py3-none-any.whl

Tags

More Monitoring packages