Menu

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.

This is documentation for the next version of Agent. For the latest stable release, go to the latest version.

DocumentationGrafana AgentFlow modeGet startedRunmacOS
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