Quickstart
Overview
respan is the recommended way to use Respan. It provides a single Respan() class that sets up tracing, activates instrumentation plugins, and will also initialize the Respan API client when available.
Version: 3.0.0 | Python: >=3.9, <4.0
Quick start
What it does
Respan() is a facade that orchestrates multiple backends:
You don’t need to interact with RespanTelemetry or RespanAPI directly — Respan handles initialization and configuration for both.
Public exports
Everything you need is available from respan:
When to use respan vs respan-tracing
Most users should use respan. Use respan-tracing directly only when you need manual OTEL configuration.
Next steps
- Respan() — constructor parameters and configuration examples
- propagate_attributes() — attach user/thread/metadata to all spans
- log_batch_results() — log OpenAI Batch API results
- Instrumentation Protocol — build your own plugin