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

# opentelemetry-instrumentation-starlette — OpenTelemetry Starlette Instrumentation

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

## What it is and what it does

This package integrates Starlette web applications with OpenTelemetry's distributed tracing system. It automatically instruments HTTP requests handled by Starlette, capturing request/response details and propagating trace context across service boundaries. The instrumentation works both as a manual middleware attachment and through OpenTelemetry's auto-instrumentation discovery mechanism.

It depends on the core OpenTelemetry API and instrumentation framework, plus ASGI instrumentation (since Starlette is an ASGI framework) and semantic conventions for standardized span attributes. Use it when you need observability into Starlette application behavior—request latency, error rates, and distributed trace correlation—without writing tracing code directly into your handlers.

Use it for:

- Trace HTTP requests in a Starlette microservice to correlate with traces from downstream services.
- Monitor request latency and error rates in production Starlette applications via OpenTelemetry exporters.
- Debug slow endpoints by examining detailed span data captured automatically by the instrumentation.
- Propagate trace IDs across service boundaries in a distributed system using standard OpenTelemetry headers.
- Enable observability in Starlette apps without modifying application code via auto-instrumentation.

## Worth the install?

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

Adds automatic tracing and observability instrumentation to Starlette web applications, capturing HTTP request and response telemetry for OpenTelemetry.

Yes, if you are already using OpenTelemetry in your stack and need Starlette tracing. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It is currently in beta (0.65b0), so expect the API to remain stable but verify compatibility with your specific Starlette and OpenTelemetry versions before production use.

## Install

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

## Installing opentelemetry-instrumentation-starlette

Before you install: Low friction install with five OpenTelemetry 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-starlette

from opentelemetry.instrumentation.starlette import StarletteInstrumentor
from starlette.applications import Starlette

app = Starlette()
StarletteInstrumentor().instrument_app(app)

Requires Python 3.10 or later; requires a configured OpenTelemetry tracer provider to export spans.

Verify before relying:

- Whether auto-instrumentation via opentelemetry-instrumentation entry points works out of the box without manual configuration.
- What telemetry attributes (span names, tags, status codes) are captured by default.
- Compatibility with specific Starlette versions and whether there are known breaking changes.

## Package facts

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

## Tags

starlette tracing instrumentation, opentelemetry starlette, http request telemetry, distributed tracing starlette, observability instrumentation, starlette monitoring, asgi tracing, observability, distributed-tracing, asgi

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