Skip to content

Install

Pick your language. Every package has the same API; only the naming follows each language's conventions (see Compatibility for runtime versions).

Node.js 22.12 or newer (ESM and CommonJS).

npm install @grow-codes/better-stack-logs

Optional peer dependencies are only needed for the adapters you use (for example pino, winston, express, fastify).

Rust 1.88 or newer (edition 2021), tokio runtime.

cargo add grow-better-stack-logs
cargo add tokio --features macros,rt-multi-thread

Cargo features:

  • blocking — synchronous blocking::BetterStackClient
  • testing — in-memory fakes and the conformance runner
  • tracing-layer, log-bridge (default) — tracing and log adapters for the log client

Go 1.26 or newer. The module lives in the go/ folder of the repository; the package name is betterstack.

go get github.com/grow-codes-packages/better-stack-logs/go@latest
import betterstack "github.com/grow-codes-packages/better-stack-logs/go"

Python 3.10 or newer.

pip install grow-better-stack-logs

Extras add optional integrations, for example pip install "grow-better-stack-logs[all]".

Java 17 or newer.

<dependency>
  <groupId>codes.grow.packages</groupId>
  <artifactId>better-stack-logs</artifactId>
  <version>0.1.0</version>
</dependency>

Gradle: implementation("codes.grow.packages:better-stack-logs:0.1.0").

Verify the installation

Run the Quickstart against a running Better Stack Logs. To start one locally with the same image the tests use:

docker run --rm -p 8080:8080 local intake stub (contract-verified) + optional live Better Stack source

The service may need extra settings to start (see docker/compose.yml in the repository).

Versions

Packages follow Semantic Versioning. Before 1.0, minor versions may contain breaking changes; they are listed in each package's CHANGELOG.md. The five packages are released together from one release pull request, so the same version number means the same API.