Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

DocumentationGrafana AgentGrafana Agent Operator

Grafana Agent Operator

The Grafana Agent Operator is a Kubernetes operator that makes it easier to deploy Grafana Agent and collect telemetry data from your Pods. Agent Operator is currently in Beta, and is subject to change.

Note: If you are shipping your data to Grafana Cloud, use Kubernetes Monitoring to set up Agent Operator. Kubernetes Monitoring provides a simplified approach and preconfigured dashboards and alerts.

Grafana Agent Operator uses Kubernetes custom resources to simplify the deployment and configuration of Grafana Agents. Agent Operator installs and manages Agents, and dynamically watches resources on your Kubernetes clusters, helping to discover Pods, Services, and Ingresses to scrape. This dynamic, declarative approach works well for decentralized deployments. You can provide your own Service Discovery (SD) scrape configs to indicate how your Pods should be monitored without explicitly defining the entire monitoring configuration yourself.

Metric collection is based on the Prometheus Operator and supports the official v1 ServiceMonitor, PodMonitor, and Probe CRDs from the project. These custom resources represent abstractions for monitoring Services, Pods, and Ingresses. They are especially useful for Helm users, where manually writing a generic SD to match all your charts can be difficult or where manually writing a specific SD for each chart can be tedious.

The following sections describe how to use Grafana Agent Operator.