SigNoz SDK¶
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 |
|
| Rust | grow-signoz |
|
| Go | github.com/grow-codes-packages/signoz/go |
|
| Python | grow-signoz |
|
| Java | codes.grow.packages:signoz |
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
queryRangerequests (Aggregate). FilterBuilderfor 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.