Graylog Open SDK¶
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 |
|
| Rust | grow-graylog |
|
| Go | github.com/grow-codes-packages/graylog/go |
|
| Python | grow-graylog |
|
| Java | codes.grow.packages:graylog |
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,
getMessageand a pollingtail; 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.