opentelemetry-instrumentation-sqlalchemy

OpenTelemetry SQLAlchemy instrumentation

opentelemetry-instrumentation-sqlalchemy Permissive license Apache-2.0 Active ★ 1,086 v0.65b0 released 2026-07-16

Install

opentelemetry-instrumentation-sqlalchemy on PyPI

pip

pip install opentelemetry-instrumentation-sqlalchemy

uv

uv add opentelemetry-instrumentation-sqlalchemy

poetry

poetry add opentelemetry-instrumentation-sqlalchemy

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 — opentelemetry-api, opentelemetry-instrumentation, opentelemetry-semantic-conventions, packaging, wrapt
Maintenance	actively maintained — 28 days since the last release
Last repo commit	2026-08-13
First released	2020-08-14
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

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

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

About opentelemetry-instrumentation-sqlalchemy

from the package's own PyPI description — quoted content, verbatim

OpenTelemetry SQLAlchemy Instrumentation

|pypi|

.. |pypi| image:: https://badge.fury.io/py/opentelemetry-instrumentation-sqlalchemy.svg :target: https://pypi.org/project/opentelemetry-instrumentation-sqlalchemy/

This library allows tracing requests made by the SQLAlchemy library.

Installation

pip install opentelemetry-instrumentation-sqlalchemy

References

SQLAlchemy Project <https://www.sqlalchemy.org/>_
OpenTelemetry SQLAlchemy Tracing <https://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/sqlalchemy/sqlalchemy.html>_
OpenTelemetry Project <https://opentelemetry.io/>_
OpenTelemetry Python Examples <https://github.com/open-telemetry/opentelemetry-python/tree/main/docs/examples>_

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Automatically traces SQL queries executed through SQLAlchemy, integrating with OpenTelemetry to capture database operation metrics and spans for observability.

Low friction installation with five stable runtime dependencies; actively maintained with a release 28 days ago and ongoing repository activity.

Apache-2.0 permissive license allows commercial and private use with minimal restrictions, typical for OpenTelemetry ecosystem packages.

Usage

pip install opentelemetry-instrumentation-sqlalchemy

from opentelemetry.instrumentation.sqlalchemy import SQLAlchemyInstrumentor
SQLAlchemyInstrumentor().instrument()

Requires Python 3.10 or later; OpenTelemetry SDK and exporter must be separately configured to collect and export traces.

Verdict: A well-maintained, actively developed instrumentation library in beta status with no known vulnerabilities. Permissive licensing and low install friction make it suitable for adding SQLAlchemy observability to OpenTelemetry-enabled applications, though beta status warrants testing before production deployment.

Needs verification

Whether beta status (0.65b0) indicates API stability or planned breaking changes before 1.0 release
Performance overhead of instrumentation on high-throughput database workloads
Compatibility matrix with specific SQLAlchemy versions beyond the generic dependency

sqlalchemy tracingdatabase query instrumentationopentelemetry sql monitoringsqlalchemy observabilitydistributed tracing databasesql span collectiondatabase performance tracing