uptrace

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 on this page — 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

uptrace on PyPI

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

Evidence: uptrace-1.41.0-py3-none-any.whl

Tags

More Monitoring packages