opentelemetry-instrumentation-threading

Thread context propagation support for OpenTelemetry

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

Install

opentelemetry-instrumentation-threading on PyPI

pip

pip install opentelemetry-instrumentation-threading

uv

uv add opentelemetry-instrumentation-threading

poetry

poetry add opentelemetry-instrumentation-threading

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 — opentelemetry-api, opentelemetry-instrumentation, wrapt
Maintenance	actively maintained — 28 days since the last release
Last repo commit	2026-08-13
First released	2024-05-31
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_threading-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-threading

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

OpenTelemetry threading Instrumentation

|pypi|

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

This library provides instrumentation for the threading module to ensure that the OpenTelemetry context is propagated across threads. It is important to note that this instrumentation does not produce any telemetry data on its own. It merely ensures that the context is correctly propagated when threads are used.

Installation

pip install opentelemetry-instrumentation-threading

References

OpenTelemetry Threading Tracing <https://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/threading/threading.html>_
OpenTelemetry Project <https://opentelemetry.io/>_

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

Propagates OpenTelemetry context across Python threads, ensuring tracing context remains consistent when using the threading module. It does not generate telemetry itself but ensures context is correctly passed between threads.

Low friction install with a pure-wheel distribution and only three runtime dependencies (opentelemetry-api, opentelemetry-instrumentation, wrapt). Actively maintained with a recent release 28 days old and ongoing commits.

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

Usage

pip install opentelemetry-instrumentation-threading

from opentelemetry.instrumentation.threading import ThreadingInstrumentor
ThreadingInstrumentor().instrument()

Requires Python 3.10 or later; assumes opentelemetry-api and opentelemetry-instrumentation are already configured in your tracing setup.

Verdict: A lightweight, actively maintained beta instrumentation package for propagating OpenTelemetry context across threads. Low install friction, no known vulnerabilities, and permissive licensing make it a safe addition to tracing-enabled applications. The beta status and lack of standalone telemetry output mean it is a context-propagation utility rather than a primary observability tool.

Needs verification

Whether context propagation works correctly with all threading patterns (daemon threads, thread pools, asyncio integration).
Performance overhead of instrumentation in high-concurrency scenarios.
Compatibility with third-party thread pool libraries beyond stdlib threading.

opentelemetry thread context propagationdistributed tracing threadingthread-safe span contextopentelemetry instrumentation threadingcross-thread trace contextthreading module tracing