opentelemetry-instrumentation-sqlalchemy
OpenTelemetry SQLAlchemy instrumentation
Decision gist · record as of 2026-08-14
Yes, if you are already using OpenTelemetry for application tracing and need to instrument SQLAlchemy queries. The package is actively maintained, has no known vulnerabilities, and integrates cleanly into the OpenTelemetry ecosystem. Install it only if you have a tracing infrastructure in place to consume the spans; standalone instrumentation without an exporter provides no value.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires an active OpenTelemetry SDK and exporter configured separately to actually export traces; instrumentation alone produces spans but they must be collected by a tracer provider.
- Low friction install with a small, stable dependency tree.
- The package is actively maintained with a recent release and supports current Python versions (3.10–3.14).
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
last release 2026-07-16 (29 days) · last repo commit 2026-08-13 · 1,086 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 29,388,766 downloads/mo, #817 on PyPI
Alternatives
Verify before relying
pip install opentelemetry-instrumentation-sqlalchemy
from opentelemetry.instrumentation.sqlalchemy import SQLAlchemyInstrumentor
SQLAlchemyInstrumentor().instrument()- Whether the package supports SQLAlchemy 1.x vs. 2.x, or both versions
- What span attributes and metadata are captured for each query type
- Performance overhead of instrumentation in high-throughput scenarios
What it is and what it does
This package hooks into SQLAlchemy to automatically generate OpenTelemetry spans for every SQL query executed through the library. It integrates with the OpenTelemetry ecosystem to emit tracing data that can be exported to observability backends like Jaeger, Datadog, or other collectors.
The instrumentation works by wrapping SQLAlchemy's query execution layer, capturing query details and timing information as span events. It's designed for teams already using OpenTelemetry for distributed tracing who need visibility into database operations as part of their broader observability strategy. The package depends on the core OpenTelemetry API, instrumentation framework, and semantic conventions to ensure spans conform to industry standards.
Use it for
- Trace database queries in a distributed system to identify slow or failing SQL operations across services.
- Monitor query performance and latency as part of end-to-end request tracing through a web application.
- Export SQLAlchemy query spans to a centralized observability platform for debugging production issues.
- Correlate database operations with application logs and metrics in a unified tracing backend.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are already using OpenTelemetry for application tracing and need to instrument SQLAlchemy queries.
The package is actively maintained, has no known vulnerabilities, and integrates cleanly into the OpenTelemetry ecosystem. Install it only if you have a tracing infrastructure in place to consume the spans; standalone instrumentation without an exporter provides no value.
Install
opentelemetry-instrumentation-sqlalchemy on PyPI
Before you install
Low friction install with a small, stable dependency tree. The package is actively maintained with a recent release and supports current Python versions (3.10–3.14). Beta status indicates ongoing development but no known stability issues.
Requires an active OpenTelemetry SDK and exporter configured separately to actually export traces; instrumentation alone produces spans but they must be collected by a tracer provider.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
Quickstart
pip install opentelemetry-instrumentation-sqlalchemy
from opentelemetry.instrumentation.sqlalchemy import SQLAlchemyInstrumentor
SQLAlchemyInstrumentor().instrument()Verify before relying
- Whether the package supports SQLAlchemy 1.x vs. 2.x, or both versions
- What span attributes and metadata are captured for each query type
- Performance overhead of instrumentation in high-throughput scenarios
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesopentelemetry-apiopentelemetry-instrumentationopentelemetry-semantic-conventionspackagingwrapt |
| Maintenance | Actively maintained 29 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 29,388,766 / month, #817 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: opentelemetry_instrumentation_sqlalchemy-0.65b0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “sqlalchemy tracing”
- opentelemetry-instrumentation-sqlalchemyAdds distributed tracing to SQLAlchemy database queries by…
- google-cloud-sqlcommenterAutomatically injects metadata comments into SQL queries executed…
- promptflow-devkitProvides a development toolkit for building, debugging, evaluating,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Monitoring packages
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
Provides generated Python code for OpenTelemetry semantic conventions, enabling standardized attribute naming and constant definitions for instrumentation and telemetry collection.
Install it if you are using OpenTelemetry and want to follow semantic conventions correctly.
Provides the reference implementation of the OpenTelemetry API for collecting and exporting traces, metrics, and logs from Python applications.
Provides the abstract API and interfaces for OpenTelemetry instrumentation in Python, defining how to emit traces, metrics, and logs without tying code to a specific SDK implementation.
Exports OpenTelemetry observability data to an OpenTelemetry Collector using Protobuf-encoded messages over HTTP.
Install it if you are using OpenTelemetry in Python and need to send data to a Collector over HTTP.
Provides automatic instrumentation commands and programmatic APIs to inject distributed tracing into Python applications without code changes, detecting and instrumenting packages used by your program.
Install it if you need distributed tracing without code changes and have compatible instrumented packages in your environment.
See also opentelemetry-instrumentation-psycopg2 · opentelemetry-instrumentation-redis · opentelemetry-instrumentation-tortoiseorm · sqltap · opentelemetry-instrumentation-flask · opentelemetry-instrumentation-pymysql · opentelemetry-instrumentation-cassandra · opentelemetry-instrumentation-django · opentelemetry-instrumentation-mysqlclient · opentelemetry-instrumentation-psycopg