Menu

Caution

Grafana Alloy is the new name for our distribution of the OTel collector. Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025. Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025. Read more about why we recommend migrating to Grafana Alloy.

This is documentation for the next version of Agent. For the latest stable release, go to the latest version.

Open source

Introduction to Grafana Agent

Grafana Agent is a flexible, high performance, vendor-neutral telemetry collector. It’s fully compatible with the most popular open source observability standards such as OpenTelemetry (OTel) and Prometheus.

Grafana Agent is available in three different variants:

Stability

ProjectStability
Static modeStable
Static mode Kubernetes operatorBeta
Flow modeStable

Choose which variant of Grafana Agent to run

NOTE: You don’t have to pick just one variant; it’s possible to mix-and-match installations of Grafana Agent.

Compare variants

Each variant of Grafana Agent provides a different level of functionality. The following tables compare Grafana Agent Flow mode with Static mode, Operator, OpenTelemetry, and Prometheus.

Core telemetry

Grafana Agent Flow modeGrafana Agent Static modeGrafana Agent OperatorOpenTelemetry CollectorPrometheus Agent mode
MetricsPrometheus, OTelPrometheusPrometheusOTelPrometheus
LogsLoki, OTelLokiLokiOTelNo
TracesOTelOTelOTelOTelNo
ProfilesPyroscopeNoNoPlannedNo

OSS features

Grafana Agent Flow modeGrafana Agent Static modeGrafana Agent OperatorOpenTelemetry CollectorPrometheus Agent mode
Kubernetes nativeYesNoYesYesNo
ClusteringYesNoNoNoNo
Prometheus rulesYesNoNoNoNo
Native Vault supportYesNoNoNoNo

Grafana Cloud solutions

Grafana Agent Flow modeGrafana Agent Static modeGrafana Agent OperatorOpenTelemetry CollectorPrometheus Agent mode
Official vendor supportYesYesYesNoNo
Cloud integrationsSomeYesSomeNoNo
Kubernetes monitoringYesYes, customYesNoYes, custom
Application observabilityYesNoNoYesNo

Static mode

Static mode is the original variant of Grafana Agent, introduced on March 3, 2020. Static mode is the most mature variant of Grafana Agent.

You should run Static mode when:

  • Maturity: You need to use the most mature version of Grafana Agent.

  • Grafana Cloud integrations: You need to use Grafana Agent with Grafana Cloud integrations.

Static mode Kubernetes operator

Note

Grafana Agent version 0.37 and newer provides Prometheus Operator compatibility in Flow mode. You should use Grafana Agent Flow mode for all new Grafana Agent deployments.

The Static mode Kubernetes operator is a variant of Grafana Agent introduced on June 17, 2021. It’s currently in beta.

The Static mode Kubernetes operator provides compatibility with Prometheus Operator, allowing static mode to support resources from Prometheus Operator, such as ServiceMonitors, PodMonitors, and Probes.

You should run the Static mode Kubernetes operator when:

  • Prometheus Operator compatibility: You need to be able to consume ServiceMonitors, PodMonitors, and Probes from the Prometheus Operator project for collecting Prometheus metrics.

Flow mode

Flow mode is a stable variant of Grafana Agent, introduced on September 29, 2022.

Grafana Agent Flow mode focuses on vendor neutrality, ease-of-use, improved debugging, and ability to adapt to the needs of power users by adopting a configuration-as-code model.

You should run Flow mode when:

  • You need functionality unique to Flow mode:

    • Improved debugging: You need to more easily debug configuration issues using a UI.

    • Full OpenTelemetry support: Support for collecting OpenTelemetry metrics, logs, and traces.

    • PrometheusRule support: Support for the PrometheusRule resource from the Prometheus Operator project for configuring Grafana Mimir.

    • Ecosystem transformation: You need to be able to convert Prometheus and Loki pipelines to and from OpenTelmetry Collector pipelines.

    • Grafana Pyroscope support: Support for collecting profiles for Grafana Pyroscope.

BoringCrypto

BoringCrypto is an EXPERIMENTAL feature for building Grafana Agent binaries and images with BoringCrypto enabled. Builds and Docker images for Linux arm64/amd64 are made available.