Skip to content

Zipkin SDK

Grow Codes CI License

One API for Zipkin 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 openzipkin/zipkin:3.6.1 in Docker.

Language Package Coverage
TypeScript @grow-codes/zipkin TypeScript coverage
Rust grow-zipkin Rust coverage
Go github.com/grow-codes-packages/zipkin/go Go coverage
Python grow-zipkin Python coverage
Java codes.grow.packages:zipkin Java coverage

What you get

  • Tracing: OpenTelemetry setup in one call with the package's own Zipkin exporter (v2 JSON to /api/v2/spans, no deprecated OpenTelemetry Zipkin exporter), W3C + B3 propagation, span helpers and framework adapters (Tracing setup, Tracing).
  • Span reporter: send Zipkin v2 spans without OpenTelemetry (Span reporter).
  • Trace queries: the full Zipkin v2 query API plus the category TraceQueryClient with one normalized trace model (Trace queries).
  • Client with health, ping and server version (Client and status).
  • Configuration from code or GROW_ZIPKIN_* / ZIPKIN_URL / OTEL_EXPORTER_ZIPKIN_ENDPOINT, 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: gateway credentials never appear in errors, logs, hooks or toString (Redaction).

Start with Install and the Quickstart.

Independent project

This SDK is made by Grow Codes. Zipkin is a trademark of its owner (The OpenZipkin authors); this project is not affiliated with or endorsed by it. See License & disclaimer.