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.

Documentationbreadcrumb arrow Grafana Agentbreadcrumb arrow Flow modebreadcrumb arrow Get startedbreadcrumb arrow Runbreadcrumb arrow macOS
Open source

Run Grafana Agent Flow on macOS

Grafana Agent Flow is installed as a launchd service on macOS.

Start Grafana Agent Flow

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

shell 
brew services start grafana-agent-flow

Grafana Agent Flow automatically runs when the system starts.

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

shell 
brew services info grafana-agent-flow

Restart Grafana Agent Flow

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

shell 
brew services restart grafana-agent-flow

Stop Grafana Agent Flow

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

shell 
brew services stop grafana-agent-flow

View Grafana Agent Flow logs on macOS

By default, logs are written to $(brew --prefix)/var/log/grafana-agent-flow.log and $(brew --prefix)/var/log/grafana-agent-flow.err.log.

If you followed Configure the Grafana Agent Flow service and changed the path where logs are written, refer to your current copy of the Grafana Agent Flow formula to locate your log files.

Next steps