Skip to content

SigNoz SDK

Grow Codes CI License

One API for SigNoz 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 signoz/signoz-community:v0.150.0 (+ signoz-otel-collector + ClickHouse) in Docker.

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

What you get

  • Ingest over OTLP to the SigNoz collector (HTTP protobuf or gRPC, gzip, SigNoz Cloud ingestion key): batching log client, log exporter and OpenTelemetry tracing (Ingest).
  • Query API: raw log queries with a lossless keyset cursor, live tail, log fields and values, raw span queries, full traces from the waterfall, trace search, services, operations, dependencies (Logs, Traces).
  • Aggregations: count, percentiles, sums … grouped, as scalars or time series, plus raw queryRange requests (Aggregate).
  • FilterBuilder for safe SigNoz filter expressions (FilterBuilder).
  • Client with health, authenticated ping and server version (Client).
  • Configuration from code or GROW_SIGNOZ_* / 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).
  • Logging: batching log client, logger facade, redaction processor, framework adapters and log search (Logging).
  • Tracing: OpenTelemetry setup, span helpers, propagation, framework adapters and trace queries (Tracing).
  • Every function with an example in all five languages (Functions).

Start with Install and the Quickstart.

Independent project

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