Grafana Tempo SDK¶
One API for Grafana Tempo in five languages: TypeScript, Rust, Go, Python and Java. Every package
has the same functions, options, defaults, error codes and behaviour, tested against a real
grafana/tempo:3.1.1 in Docker.
| Language | Package | Coverage |
|---|---|---|
| TypeScript | @grow-codes/grafana-tempo |
|
| Rust | grow-grafana-tempo |
|
| Go | github.com/grow-codes-packages/grafana-tempo/go |
|
| Python | grow-grafana-tempo |
|
| Java | codes.grow.packages:grafana-tempo |
What you get¶
- Client with health, authenticated ping and server version (Client).
- Configuration from code or
GROW_GRAFANA_TEMPO_*/ vendor environment variables, immutable and validated (Configuration). - Retries with full-jitter backoff and
Retry-After, connect/request/total timeouts and cancellation in every language. - Typed errors with one set of codes across languages (Error handling).
- Redaction everywhere: credentials never appear in errors, logs, hooks or
toString(Redaction). - Tracing: OpenTelemetry setup, span helpers, propagation, framework adapters and trace queries (Tracing).
- Tempo query client: trace by id (v2 with v1 fallback), TraceQL search, tags, tag values and
TraceQL metrics, with multi-tenancy (
X-Scope-OrgID) built in (Query client). - TraceQL builder with escaping, quoting and structural operators (TraceQL builder).
initTracingpreset for Tempo's OTLP receivers (HTTP 4318 or gRPC 4317) with the tenant header (Tracing setup).
Start with Install and the Quickstart.
Independent project
This SDK is made by Grow Codes. Grafana Tempo is a trademark of its owner (Grafana Labs); this project is not affiliated with or endorsed by it. See License & disclaimer.