If the installed agent fails to start, an error occurs during installation, or the installation cannot be performed, please check the following.

Installation environment

• Please check whether OS to be installed is officially supported.
  • Supported Environments - Mackerel Docs

Connection status

• Make sure that you can connect from the target server to the destinations listed in “What is Mackerel’s IP address and port number?”.
• If connecting via a proxy server, make sure that the proxy server is configured according to “Is it possible to control which port the mackerel-agent uses?”.
• If antivirus software is installed on the server where the agent is installed, please make sure that mackerel-agent signal is not blocked.
• Check whether or notapi.mackerelio.comname resolution is working.

Other

• Check whether or not the package (yum / apt) is installed correctly.
• Confirm that the API key specified for mackerel-agent is not ReadOnly.
• Check the contents of the log by mackerel-agent and check whether an error is output.
• Please check the command mackerel-agent configtest to see if the configuration file mackerel-agent.conf is written correctly.
• If you’ve copied /var/lib/mackerel-agent/id onto an OS image with Docker Image or AMI, this file needs to be deleted.
  
  • When mackerel-agent starts up for the first time, the ID issued by the server will be saved to/var/lib/mackerel-agent/id. The host will be identified by this ID from then on.  
  • For this reason, if /var/lib/mackerel-agent/id is copied, multiple hosts will be recognized by Mackerel as the same host, resulting in metric posting and monitoring not functioning properly.

If the problem has not been resolved after double checking all of the points above, please contact us via the "Contact Us" button (please attach any relevant information such as error logs if available). The "Contact Us" button is displayed in the header of this page or the header of the Mackerel Web Console.