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.

Documentationbreadcrumb arrow Grafana Agentbreadcrumb arrow Flow modebreadcrumb arrow Referencebreadcrumb arrow Command-line interface
Open source

The Grafana Agent command-line interface

When in Flow mode, the grafana-agent binary exposes a command-line interface with subcommands to perform various operations.

The most common subcommand is run which accepts a configuration file and starts Grafana Agent Flow.

Available commands:

  • convert: Convert a Grafana Agent configuration file.
  • fmt: Format a Grafana Agent Flow configuration file.
  • run: Start Grafana Agent Flow, given a configuration file.
  • tools: Read the WAL and provide statistical information.
  • completion: Generate shell completion for the grafana-agent-flow CLI.
  • help: Print help for supported commands.