Skip to main content

@effectstream/grafana-loki

Package: @effectstream/grafana-loki · Source

NPM wrapper around Grafana Loki — the log-aggregation backend EffectStream nodes ship structured logs to in local development. Installs a pinned binary into node_modules/.bin/grafana-loki.

Install

bun add @effectstream/grafana-loki
# or
npm install @effectstream/grafana-loki

Standalone usage

# Start Loki with a config file
bunx grafana-loki -config.file=loki.yaml

# Or invoke through this package
bun run --bun @effectstream/grafana-loki/start

The package downloads the pinned tarball for your OS/arch on install.

Inside EffectStream

The orchestrator's observability step pairs this with @effectstream/grafana-alloy so logs emitted via @effectstream/log land in Loki, queryable from a local Grafana. Out of the box you get component-tagged (ComponentNames) logs without writing any collector config.