---
id: uptrace
version: "1.41.0"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# uptrace — OpenTelemetry Python distribution for Uptrace

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

## What it is and what it does

Uptrace is a Python package that simplifies integration with the Uptrace observability platform by wrapping OpenTelemetry. It handles the export of distributed traces, metrics, and logs from your Python application to Uptrace's backend, eliminating the need to manually configure OpenTelemetry exporters. The package depends on four core OpenTelemetry libraries: opentelemetry-api, opentelemetry-sdk, opentelemetry-instrumentation, and opentelemetry-exporter-otlp.

You use it by installing the package, configuring it with your Uptrace DSN, and then instrumenting your application code or frameworks. The wrapper abstracts away OpenTelemetry configuration details, making it faster to get observability running. It includes guides for popular frameworks like Django, Flask, FastAPI, and SQLAlchemy, so you can instrument web applications and database calls with minimal setup.

Use it for:

- Instrument a Django or Flask web application to collect distributed traces and send them to Uptrace for performance analysis.
- Export application metrics and logs alongside traces to correlate performance issues with error patterns.
- Monitor database queries in SQLAlchemy-based applications by collecting query spans and latency data.
- Set up observability for a FastAPI microservice without manually configuring each OpenTelemetry component.
- Collect end-to-end traces across multiple services to debug latency and failures in distributed systems.

## Worth the install?

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

Uptrace is a thin wrapper over OpenTelemetry that exports traces, metrics, and logs to the Uptrace observability platform.

Yes, if you are already using Uptrace or planning to adopt it for observability. The package reduces boilerplate compared to configuring OpenTelemetry directly, and it has active maintenance, no known vulnerabilities, and permissive licensing. Install it as part of your observability stack setup, not as a standalone tool—it requires an Uptrace account to be useful.

## Install

pip install uptrace
uv add uptrace
poetry add uptrace

## Installing uptrace

Before you install: Low friction installation with a pure Python wheel. Active maintenance with recent commits and a stable production release status.

License in practice: BSD-3-Clause is permissive; you can use this package in commercial and proprietary projects with minimal restrictions.

Quickstart:

pip install uptrace

import uptrace
from opentelemetry import trace

uptrace.configure_opentelemetry(dsn="https://...@api.uptrace.dev/...")
tracer = trace.get_tracer(__name__)

Requires Python 3.9 or later; also requires an Uptrace account and DSN to export data.

Verify before relying:

- Whether the package supports automatic instrumentation for specific frameworks beyond Django, Flask, and FastAPI.
- Performance overhead of the wrapper layer compared to direct OpenTelemetry usage.
- Whether metrics and logs export are fully featured or have limitations compared to traces.

## Package facts

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

## Tags

opentelemetry uptrace exporter, distributed tracing python, metrics and logs export, application observability, uptrace instrumentation, opentelemetry wrapper, trace collection python, observability, opentelemetry, distributed-tracing

[View on SkillFed](https://skillfed.io/packages/uptrace) · [View on PyPI](https://pypi.org/project/uptrace/)