---
id: opentelemetry-instrumentation-mysql
version: "0.65b0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# opentelemetry-instrumentation-mysql — OpenTelemetry MySQL instrumentation

License: permissive · Maintenance: active · Downloads: 3.5M/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mysql query tracing, opentelemetry mysql instrumentation, database call observability, mysql connector tracing, distributed tracing mysql, database span collection, mysql dbapi instrumentation, observability, tracing, mysql

[View on SkillFed](https://skillfed.io/packages/opentelemetry-instrumentation-mysql) · [View on PyPI](https://pypi.org/project/opentelemetry-instrumentation-mysql/)