opentelemetry-instrumentation-mysql
OpenTelemetry MySQL instrumentation
Decision gist · record as of 2026-08-14
Yes, if you use mysql-connector and need distributed tracing. The package is actively maintained, has no known vulnerabilities, and integrates cleanly into the OpenTelemetry ecosystem. Beta status is typical for instrumentation libraries and does not indicate instability. Install it when you are already using OpenTelemetry and want visibility into MySQL queries.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; mysql-connector-python must be installed separately to instrument actual MySQL connections.
- Low install friction with a pure-Python wheel and three lightweight runtime dependencies.
- Actively maintained with a recent release (29 days old) and continuous repository activity.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.
last release 2026-07-16 (29 days) · last repo commit 2026-08-14 · 1,086 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 3,476,549 downloads/mo, #2,608 on PyPI
Alternatives
Verify before relying
pip install opentelemetry-instrumentation-mysql
from opentelemetry.instrumentation.mysql import MySQLInstrumentor
MySQLInstrumentor().instrument()- Whether mysql-connector-python is automatically installed or must be added separately as a peer dependency.
- What specific query attributes (SQL text, parameters, duration, result set size) are captured in the spans.
- Whether the instrumentation works with connection pooling or async mysql-connector patterns.
What it is and what it does
This package integrates the mysql-connector library with OpenTelemetry's distributed tracing system. When installed, it automatically wraps MySQL database calls to emit spans that record query execution, allowing you to see database operations in your observability backend alongside application and network traces.
It is part of the OpenTelemetry Python contrib ecosystem and depends on opentelemetry-api, opentelemetry-instrumentation, and opentelemetry-instrumentation-dbapi. The package is in beta status and supports Python 3.10 through 3.14. It requires minimal setup—typically just importing the instrumentation module to activate automatic tracing of mysql-connector calls.
Use it for
- Trace MySQL queries in distributed systems to correlate database latency with application performance issues.
- Export query spans to observability platforms (Jaeger, Datadog, New Relic) for centralized database monitoring.
- Debug slow database operations by viewing query execution time and context within the full request trace.
- Audit database access patterns by collecting structured span data on which queries run and when.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use mysql-connector and need distributed tracing.
The package is actively maintained, has no known vulnerabilities, and integrates cleanly into the OpenTelemetry ecosystem. Beta status is typical for instrumentation libraries and does not indicate instability. Install it when you are already using OpenTelemetry and want visibility into MySQL queries.
Install
opentelemetry-instrumentation-mysql on PyPI
Before you install
Low install friction with a pure-Python wheel and three lightweight runtime dependencies. Actively maintained with a recent release (29 days old) and continuous repository activity.
Requires Python 3.10 or later; mysql-connector-python must be installed separately to instrument actual MySQL connections.
License in practice
Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.
Quickstart
pip install opentelemetry-instrumentation-mysql
from opentelemetry.instrumentation.mysql import MySQLInstrumentor
MySQLInstrumentor().instrument()Verify before relying
- Whether mysql-connector-python is automatically installed or must be added separately as a peer dependency.
- What specific query attributes (SQL text, parameters, duration, result set size) are captured in the spans.
- Whether the instrumentation works with connection pooling or async mysql-connector patterns.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesopentelemetry-apiopentelemetry-instrumentation-dbapiopentelemetry-instrumentation |
| Maintenance | Actively maintained 29 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,476,549 / month, #2,608 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_mysql-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 › “mysql query tracing”
- opentelemetry-instrumentation-mysqlAdds distributed tracing to MySQL database calls made through the…
- opentelemetry-instrumentation-mysqlclientAdds OpenTelemetry tracing instrumentation to mysqlclient database…
- opentelemetry-instrumentation-pymysqlAdds OpenTelemetry tracing instrumentation to PyMySQL database…
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-mysqlclient · opentelemetry-instrumentation-pymysql · opentelemetry-instrumentation-asyncpg · opentelemetry-instrumentation-dbapi · opentelemetry-instrumentation-tortoiseorm · opentelemetry-instrumentation-aiopg · opentelemetry-instrumentation-psycopg2 · opentelemetry-instrumentation-pymssql · opentelemetry-instrumentation-sqlalchemy · opentelemetry-instrumentation-elasticsearch