opentelemetry-instrumentation-mysql

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

Adds distributed tracing to MySQL database calls made through the mysql-connector library by automatically capturing query execution as OpenTelemetry spans.

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

pip install opentelemetry-instrumentation-mysql

uv add opentelemetry-instrumentation-mysql

poetry add opentelemetry-instrumentation-mysql

Installing opentelemetry-instrumentation-mysql

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.

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()

Requires Python 3.10 or later; mysql-connector-python must be installed separately to instrument actual MySQL connections.

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

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

Tags

More Monitoring packages