Skip to main content

@effectstream/grafana-alloy

Package: @effectstream/grafana-alloy · Source

NPM wrapper around Grafana Alloy - the OpenTelemetry-compatible collector EffectStream nodes ship traces, logs, and metrics to during local development. Installs a pinned binary into node_modules/.bin/grafana-alloy.

  • Pinned Grafana Alloy binary, the OTel collector Effectstream nodes ship to in local dev.
  • One-command start via bunx grafana-alloy run config.alloy.
  • Pairs with @effectstream/grafana-loki for logs.
  • Drop-in: point your own collector at the same OTLP endpoint in production.

Install​

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

Standalone usage​

# Start Alloy with a config file
bunx grafana-alloy run config.alloy

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

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

Inside EffectStream​

@effectstream/log emits OTLP. In local dev the orchestrator's observability step boots grafana-alloy plus grafana-loki so traces and logs from every component show up in one place. Point your own collector at the same OTLP endpoint to ship to Tempo / Honeycomb / etc. in production.