Skip to content

Graylog Open SDK

Grow Codes CI License

One API for Graylog Open 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 graylog/graylog:7.0 (with OpenSearch 2.19 and MongoDB) in Docker.

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

What you get

  • Client with health (lbstatus), authenticated ping, server version and system info (Client).
  • Configuration from code or GROW_GRAYLOG_* / 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).
  • Graylog Open API (Functions): GELF over UDP (compression, chunking up to 128 chunks), TCP (NUL framing, TLS, reconnect) and HTTP (bulk, gzip); an OTLP/gRPC log exporter for Graylog's OpenTelemetry input; Views search with Lucene queries, getMessage and a polling tail; inputs (ensureGelfInput), streams and index sets administration.

Start with Install and the Quickstart.

Independent project

This SDK is made by Grow Codes. Graylog and Graylog Open are trademarks of Graylog, Inc. This project is not affiliated with or endorsed by Graylog, Inc. See License & disclaimer.