Skip to content

Grafana Tempo SDK

Grow Codes CI License

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 TypeScript coverage
Rust grow-grafana-tempo Rust coverage
Go github.com/grow-codes-packages/grafana-tempo/go Go coverage
Python grow-grafana-tempo Python coverage
Java codes.grow.packages:grafana-tempo Java coverage

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).
  • initTracing preset 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.