Menu
Documentation Grafana Cloud Monitor infrastructure Grafana integrations Troubleshoot Cloud Integrations installation on Mac
Grafana Cloud

Common errors when executing the Grafana Agent installation script on Mac

The installation script will return an error message if there is a problem during installation. You can use these messages to identify and correct the errors.

homebrew not detected

The Homebrew package manager is used to install the Grafana Agent. You should first make sure that is installed in your environment, and may find installation instructions at https://brew.sh/.

Failed to download config

The script was not able to download the Grafana Agent configuration file. This is probably due to networking errors or the unavailability of an internet connection in your environment.

Any other error while executing the installation script

Other errors might occur during installation. Check the error message for more details. If you need help, contact us using one of the options available on our official Help page.

Common errors when configuring Grafana Agent for Cloud Integrations - Test Data Connection button

You can use the Test Data Connection button on the integration setup page to verify that you configured your Grafana Agent correctly and that it is sending the expected data.

A few things can cause a check failure. Before going into detail, make sure you have restarted your Grafana Agent service by running the following command in a terminal window:

shell
brew services restart grafana-agent

You can view the Grafana Agent logs in the following places:

  • For system logs: $(brew --prefix)/var/log/grafana-agent.log
  • For error logs: $(brew --prefix)/var/log/grafana-agent.err.log

No metrics were found for this integration.

This message indicates that the Grafana Agent is not able to contact your Grafana Cloud Prometheus endpoint. This can happen for several reasons, not limited to:

  • The agent is not starting correctly due to problems in your configuration file syntax or indentation
  • The agent is not being able to connect to your Grafana Cloud Prometheus endpoint (networking or configuration issues)

To understand the reasons for this problem, please check the Grafana Agent error logs that can be found at:

shell
$(brew --prefix)/var/log/grafana-agent.err.log

If you find errors in the logs about loading the YAML configuration file, make sure you have placed the snippets in the correct sections and with the right YAML indentation and syntax. Make sure you have placed metrics snippets under metrics.configs.scrape_configs, logs snippets under logs.configs.scrape_configs, and integrations (exporters) snippets under integrations.

If you find errors in the logs about connecting to your Grafana Cloud Prometheus endpoint, make sure you didn’t change the prometheus_remote_write URL or authentication details. You can verify your endpoint and create new keys under the Cloud Portal.

The agent was not able to reach your application prometheus metrics endpoint.

This message means that the Grafana Agent started and connected to your Grafana Cloud Prometheus endpoint, but failed to scrape your application Prometheus metrics endpoint. This can happen for several reasons, not limited to:

  • The endpoint address is incorrect
  • The endpoint is protected, and no authentication details were provided
  • The endpoint is not online

To understand the reasons for this problem, please check the Grafana Agent error logs that can be found at:

shell
$(brew --prefix)/var/log/grafana-agent.err.log

If you find that the endpoint is not online or there are authentication errors, make sure you have followed the steps under the first section of the Integration setup page, Check prerequisites specific to....

The agent was not able to collect your application logs

This message is displayed when the Grafana Agent can’t collect logs and send them to your Grafana Cloud Loki endpoint. This can happen for several reasons, not limited to:

  • There are no logs available
  • The logs path is incorrect
  • The agent does not have the necessary permissions to access your application logs
  • The agent is not being able to connect to your Grafana Cloud Loki endpoint (networking or configuration issues)

To understand the reasons for this problem, please check the Grafana Agent error logs that can be found at:

shell
$(brew --prefix)/var/log/grafana-agent.err.log

If you find that there are permission errors, make sure you have followed the steps under the first section of the Integration setup page, Check prerequisites specific to....

If you find errors in the logs about connecting to your Grafana Cloud Loki endpoint, make sure you didn’t change the logs URL or authentication details. You can verify your endpoint and create new keys under the Cloud Portal.