Zipkin SDK¶
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 |
|
| Rust | grow-zipkin |
|
| Go | github.com/grow-codes-packages/zipkin/go |
|
| Python | grow-zipkin |
|
| Java | codes.grow.packages:zipkin |
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
TraceQueryClientwith 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.