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.
Set up integrations
This topic provides examples of setting up Grafana Agent Operator integrations, including node_exporter and mysqld_exporter.
Before you begin
Before you begin, make sure that you have deployed the Grafana Agent Operator CRDs and installed Agent Operator into your cluster. See Install Grafana Agent Operator with Helm or Install Grafana Agent Operator for instructions.
Also, make sure that you deploy the GrafanaAgent resource and the yaml
you use has the integrations
definition under spec
.
Important: The field name
under the spec
section of the manifest must contain the name of the integration to be installed according to the list of integrations defined here.
Important: The value of the metrics_instance
field needs to be in the format <namespace>/<name>
, with namespace and name matching the values defined in the metadata
section from the MetricsInstance
resource as explained in deploy a MetricsInstance resource
Set up an Agent Operator node_exporter integration
The Agent Operator node_exporter integration lets you monitor your hardware and OS metrics from Unix-based machines, including Linux machines.
To set up a node_exporter integration:
Copy the following manifest to a file:
apiVersion: monitoring.grafana.com/v1alpha1 kind: Integration metadata: name: node-exporter namespace: default labels: agent: grafana-agent-integrations spec: name: node_exporter type: allNodes: true unique: true config: autoscrape: enable: true metrics_instance: default/primary rootfs_path: /default/node_exporter/rootfs sysfs_path: /default/node_exporter/sys procfs_path: /default/node_exporter/proc volumeMounts: - mountPath: /default/node_exporter/proc name: proc - mountPath: /default/node_exporter/sys name: sys - mountPath: /default/node_exporter/rootfs name: root volumes: - name: proc hostPath: path: /proc - name: sys hostPath: path: /sys - name: root hostPath: path: /root
Customize the manifest as needed and roll it out to your cluster using
kubectl apply -f
followed by the filename.The manifest causes Agent Operator to create an instance of a grafana-agent-integrations-deploy resource that exports Node metrics.
Set up an Agent Operator mysqld_exporter integration
The Agent Operator mysqld_exporter integration is an embedded version of mysqld_exporter that lets you collect metrics from MySQL servers.
To set up a mysqld_exporter integration:
Copy the following manifest to a file:
apiVersion: monitoring.grafana.com/v1alpha1 kind: Integration metadata: name: mysqld-exporter namespace: default labels: agent: grafana-agent-integrations spec: name: mysql type: allNodes: true unique: true config: autoscrape: enable: true metrics_instance: default/primary data_source_name: root@(server-a:3306)/
Customize the manifest as needed and roll it out to your cluster using
kubectl apply -f
followed by the filename.The manifest causes Agent Operator to create an instance of a grafana-agent-integrations-deploy resource that exports MySQL metrics.