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

# opentelemetry-instrumentation-structlog — OpenTelemetry structlog instrumentation

License: permissive · Maintenance: active · Downloads: 86.4K/mo

## What it is and what it does

This package bridges structlog, a popular Python structured logging library, with OpenTelemetry's observability framework. It automatically instruments structlog to emit logs that are correlated with OpenTelemetry traces and metrics, allowing you to see logs in the context of the spans and metrics they're associated with. This is useful when you're already using structlog for structured logging and want to add distributed tracing and metrics collection without rewriting your logging code.

The package is in beta status (0.65b0) and depends on three core OpenTelemetry libraries: opentelemetry-api, opentelemetry-instrumentation, and opentelemetry-semantic-conventions. It supports Python 3.10 through 3.14 and is actively maintained by the OpenTelemetry project. Installation is straightforward with no compiled dependencies.

Use it for:

- Add distributed tracing to applications already using structlog for structured logging.
- Correlate application logs with OpenTelemetry spans to debug request flows across services.
- Export structured logs alongside traces and metrics to a unified observability backend.
- Migrate from manual trace instrumentation to automatic log-based correlation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates structlog logging with OpenTelemetry to automatically capture and correlate structured logs with traces and metrics.

Yes, if you use structlog and need OpenTelemetry integration. The package is actively maintained, has low install friction, carries a permissive license, and requires only standard OpenTelemetry dependencies. The beta status (0.65b0) is typical for OpenTelemetry instrumentation packages and should not deter adoption for production use, though you should verify structlog dependency handling for your environment.

## Install

pip install opentelemetry-instrumentation-structlog
uv add opentelemetry-instrumentation-structlog
poetry add opentelemetry-instrumentation-structlog

## Installing opentelemetry-instrumentation-structlog

Before you install: Low friction install with three core OpenTelemetry dependencies. Actively maintained as of 2026-08-14 with recent release activity.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install opentelemetry-instrumentation-structlog

from opentelemetry.instrumentation.structlog import StructlogInstrumentor

StructlogInstrumentor().instrument()

Requires Python 3.10 or later; structlog must be installed separately as a peer dependency.

Verify before relying:

- Whether structlog is automatically installed or must be added as a separate dependency.
- How context propagation works between structlog and OpenTelemetry traces in practice.
- Performance overhead of instrumentation on high-volume logging workloads.

## Package facts

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

## Tags

structlog opentelemetry integration, structured logging with traces, opentelemetry instrumentation, log correlation with spans, observability structlog, observability, structured-logging, distributed-tracing

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