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.
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 thegrafana-agent-flow
CLI.help
: Print help for supported commands.