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.
Installing Grafana Agent Operator with Helm
In this guide you’ll learn how to deploy the Grafana Agent Operator into your Kubernetes cluster using the grafana-agent-operator Helm chart.
Note: Agent Operator is currently in beta and its custom resources are subject to change as the project evolves. It currently supports the metrics and logs subsystems of Grafana Agent. Integrations and traces support is coming soon.
By the end of this guide, you’ll have deloyed Agent Operator into your cluster.
Before you begin, make sure that you have the following available to you:
- A Kubernetes cluster
kubectlcommand-line client installed and configured on your machine
helmcommand-line client installed and configured on your machine
Install Agent Operator Helm Chart
In this step you’ll install the grafana-agent-operator Helm chart into your Kubernetes cluster. This will install the latest version of Agent Operator and its Custom Resource Definitions (CRDs). By default the chart will configure the operator to maintain a Service that allows you scrape kubelets using a
Begin by adding and updating the
grafana Helm chart repo:
helm repo add grafana https://grafana.github.io/helm-charts helm repo update
Next, install the chart:
helm install my-release grafana/grafana-agent-operator
my-release with your desired release name.
If you want to modify the default parameters, you can create a
values.yaml file and pass it in to
helm install my-release grafana/grafana-agent-operator -f values.yaml
A list of configurable template parameters can be found in the Helm chart repository.
If you want to deploy Agent Operator into a namespace other than
default, use the
helm install my-release grafana/grafana-agent-operator -f values.yaml -n my-namespace
Once you’ve successfully deployed the Helm release, confirm that Agent Operator is up and running:
kubectl get pod kubectl get svc
You should see an Agent Operator Pod in
RUNNING state, and a
With Agent Operator up and running, you can move on to setting up a
GrafanaAgent custom resource. This will discover
LogsInstance custom resources and endow them with Pod attributes (like requests and limits) defined in the
GrafanaAgent spec. To learn how to do this, please see Custom Resource Quickstart.