Caution

Grafana Agent has reached End-of-Life (EOL) on November 1, 2025. Agent is no longer receiving vendor support and will no longer receive security or bug fixes. Current users of Agent Static mode, Agent Flow mode, and Agent Operator should proceed with migrating to Grafana Alloy. If you have already migrated to Alloy, no further action is required. 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 Flow modebreadcrumb arrow Referencebreadcrumb arrow Command-line interfacebreadcrumb arrow fmt
Open source

The fmt command

The fmt command formats a given Grafana Agent Flow configuration file.

Usage

Usage:

  • AGENT_MODE=flow grafana-agent fmt [FLAG ...] FILE_NAME

  • grafana-agent-flow fmt [FLAG ...] FILE_NAME

    Replace the following:

    • FLAG: One or more flags that define the input and output of the command.
    • FILE_NAME: The Grafana Agent Flow configuration file.

If the FILE_NAME argument is not provided or if the FILE_NAME argument is equal to -, fmt formats the contents of standard input. Otherwise, fmt reads and formats the file from disk specified by the argument.

The --write flag can be specified to replace the contents of the original file on disk with the formatted results. --write can only be provided when fmt is not reading from standard input.

The command fails if the file being formatted has syntactically incorrect River configuration, but does not validate whether Flow components are configured properly.

The following flags are supported:

  • --write, -w: Write the formatted file back to disk when not reading from standard input.