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.

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.

Documentationbreadcrumb arrow Grafana Agentbreadcrumb arrow Set up Grafana Agent
Open source RSS

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.

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.