grafana/alloy: OpenTelemetry Collector distribution with programmable pipelines

Grafana Alloy is an open source OpenTelemetry Collector distribution with built-in Prometheus pipelines and support for metrics, logs, traces, and profiles.

What can Alloy do?

• Programmable pipelines: Use a rich [expression-based syntax][syntax] for

• OpenTelemetry Collector Distribution: Alloy is a [distribution][] of

• Big tent: Alloy embraces Grafana's "big tent" philosophy, where Alloy

* [OpenTelemetry Collector][] * [Prometheus][] * [Grafana Loki][] * [Grafana Pyroscope][]

• Kubernetes-native: Use components to interact with native and custom

• Shareable pipelines: Use [modules][] to share your pipelines with the

• Automatic workload distribution: Configure Alloy instances to form a

• Centralized configuration support: Alloy supports retrieving its

• Debugging utilities: Use the [built-in UI][ui] for visualizing and

[syntax]: https://grafana.com/docs/alloy/latest/concepts/configuration-syntax/ [distribution]: https://opentelemetry.io/docs/collector/distributions/ [OpenTelemetry Collector]: https://opentelemetry.io [Prometheus]: https://prometheus.io [Grafana Loki]: https://github.com/grafana/loki [Grafana Pyroscope]: https://github.com/grafana/pyroscope [modules]: https://grafana.com/docs/alloy/latest/concepts/modules/ [cluster]: https://grafana.com/docs/alloy/latest/concepts/clustering/ [remotecfg]: https://grafana.com/docs/alloy/latest/reference/config-blocks/remotecfg/ [ui]: https://grafana.com/docs/alloy/latest/tasks/debug/

Example

otelcol.receiver.otlp "example" {
  grpc {
    endpoint = "127.0.0.1:4317"
  }
output {
    metrics = [otelcol.processor.batch.example.input]
    logs    = [otelcol.processor.batch.example.input]
    traces  = [otelcol.processor.batch.example.input]
  }
}
otelcol.processor.batch "example" {
  output {
    metrics = [otelcol.exporter.otlp.default.input]
    logs    = [otelcol.exporter.otlp.default.input]
    traces  = [otelcol.exporter.otlp.default.input]
  }
}
otelcol.exporter.otlp "default" {
  client {
    endpoint = "my-otlp-grpc-server:4317"
  }
}

Getting started

Check out our [documentation][] to see:

• [Installation instructions][install] for Alloy
• Steps for [Getting started][get-started] with Alloy
• The list of Alloy [components][]

Release cadence

A new minor release is planned every three weeks. Patch releases are published every one to two weeks.

The release cadence is best-effort: if necessary, releases may be performed outside of this cadence, or a scheduled release date can be moved forwards or backwards.

Minor releases published on cadence include updating dependencies for upstream OpenTelemetry Collector code if new versions are available. Minor releases published outside of the release cadence may not include these dependency updates.

Patch and security releases may be published at any time.

Community

To engage with the Alloy community:

• Chat with us on our community Slack channel. To invite yourself to the