opentelemetry-instrumentation

Instrumentation Tools & Auto Instrumentation for OpenTelemetry Python

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

Install

opentelemetry-instrumentation on PyPI

pip

pip install opentelemetry-instrumentation

uv

uv add opentelemetry-instrumentation

poetry

poetry add opentelemetry-instrumentation

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	4 — opentelemetry-api, opentelemetry-semantic-conventions, packaging, wrapt
Maintenance	actively maintained — 28 days since the last release
Last repo commit	2026-08-13
First released	2020-06-11
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-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

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

OpenTelemetry Instrumentation

|pypi|

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

Installation

pip install opentelemetry-instrumentation

This package provides commands that help automatically instrument a program:

.. note:: You need to install a distro package to get auto instrumentation working. The opentelemetry-distro package contains the default distro and configurator and automatically configures some of the common options for users. For more info about opentelemetry-distro check here <https://opentelemetry-python.readthedocs.io/en/latest/examples/distro/README.html>__ ::

    pip install "opentelemetry-distro[otlp]"

When creating a custom distro and/or configurator, be sure to add entry points for each under `opentelemetry_distro` and `opentelemetry_configurator` respectfully.
If you have entry points for multiple distros or configurators present in your environment, you should specify the entry point name of the distro and configurator you want to be used via the...

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

Provides automatic instrumentation commands and programmatic APIs to inject OpenTelemetry tracing and metrics into Python applications without code changes, using the opentelemetry-instrument CLI or auto_instrumentation.initialize().

Low friction: pure Python wheel with four stable runtime dependencies (opentelemetry-api, opentelemetry-semantic-conventions, packaging, wrapt). Active maintenance with release 28 days old and last commit 2026-08-13.

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Usage

pip install opentelemetry-instrumentation

# CLI usage:
opentelemetry-instrument --traces_exporter console python program.py

# Or programmatic:
from opentelemetry.instrumentation import auto_instrumentation
auto_instrumentation.initialize()

Requires Python >=3.10. For full auto-instrumentation, a distro package (e.g. opentelemetry-distro[otlp]) should be installed separately; some instrumentations require initialize() to be called before importing the target library.

Verdict: Beta-stage instrumentation framework actively maintained and in the top 1000 PyPI packages with no known vulnerabilities. Low install friction and permissive licensing make it suitable for adding observability to Python applications, though users must install a separate distro package and ensure compatible library versions for auto-instrumentation to work.

Needs verification

Whether the beta status (0.65b0) indicates API stability concerns or expected production readiness
Performance overhead of auto-instrumentation on typical application workloads
Completeness of instrumentation coverage for popular Python frameworks beyond what the fact sheet lists

opentelemetry auto instrumentationautomatic distributed tracing pythonopentelemetry bootstrap instrumentationpython tracing without code changesopentelemetry-instrument commandauto instrumentation setupopentelemetry distro configuration