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 Flow modebreadcrumb arrow Get startedbreadcrumb arrow Runbreadcrumb arrow Linux
Open source

Run Grafana Agent Flow on Linux

Grafana Agent Flow is installed as a systemd service on Linux.

Start Grafana Agent Flow

To start Grafana Agent Flow, run the following command in a terminal window:

shell 
sudo systemctl start grafana-agent-flow

(Optional) To verify that the service is running, run the following command in a terminal window:

shell 
sudo systemctl status grafana-agent-flow

Configure Grafana Agent Flow to start at boot

To automatically run Grafana Agent Flow when the system starts, run the following command in a terminal window:

shell 
sudo systemctl enable grafana-agent-flow.service

Restart Grafana Agent Flow

To restart Grafana Agent Flow, run the following command in a terminal window:

shell 
sudo systemctl restart grafana-agent-flow

Stop Grafana Agent Flow

To stop Grafana Agent Flow, run the following command in a terminal window:

shell 
sudo systemctl stop grafana-agent-flow

View Grafana Agent Flow logs on Linux

To view Grafana Agent Flow log files, run the following command in a terminal window:

shell 
sudo journalctl -u grafana-agent-flow

Next steps