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.
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.
Set up Grafana Agent
Overview
If this is your first time using Grafana Agent, use one of the installation options to install Grafana Agent based on the platform you are using. Alternatively, use the quick start guides to help you with the specifics of sending metrics, logs, and traces to the Grafana Stack or Grafana Cloud.
If you have already installed Grafana Agent on your machine, you can jump to the Configure Grafana Agent section.
To get started with Grafana Agent Operator, refer to the Operator-specific documentation.
Installation options
Grafana Agent is currently distributed in plain binary form, Docker container images, a Windows installer, a Homebrew package, and a Kubernetes install script.
The following architectures receive active support.
- macOS: Intel Mac or Apple Silicon
- Windows: A x64 machine
- Linux: AMD64, ARM64, ARMv6, or ARMv7 machines
- FreeBSD: A AMD64 machine
In addition, best-effort support is provided for Linux: ppc64le.
Choose from the following platforms and installation options according to which suits your use case best.
Kubernetes
Deploy Kubernetes manifests from the kubernetes
directory.
You can manually modify the Kubernetes manifests by downloading them. These manifests do not include Grafana Agent configuration files.
For sample configuration files, refer to the Grafana Cloud Kubernetes quick start guide: https://grafana.com/docs/grafana-cloud/kubernetes/agent-k8s/.
Advanced users can use the Grafana Agent Operator to deploy the Grafana Agent on Kubernetes.
Docker
Refer to Install Grafana Agent on Docker.
Linux
Refer to Install Grafana Agent on Linux.
Windows
Refer to Install Grafana Agent on Windows.
Binary
Refer to Install the Grafana Agent binary.
macOS
Refer to Install Grafana Agent on macOS.
Grafana Cloud
Use the Grafana Agent Kubernetes quickstarts or follow instructions for installing the Grafana Agent in the Walkthrough.
Tanka
For more information, refer to the Tanka configurations in our production/
directory.