Mackerel offers mackerel-agent’s Homebrew Tap for macOS. Monitoring of a macOS machine can be done by following the procedure below.
However, please note that macOS is not officially supported for mackerel-agent. For a list of supported OS, check here.
We assume that you have installed Homebrew in
If you are using Homebrew which natively supports Apple Silicon Mac, please replace
You can find where Homebrew is installed with
brew --prefix command.
With Homebrew's preinstalled environment, the agent can be installed by executing the following command.
brew install mackerelio/mackerel-agent/mackerel-agent
Edit the configuration file
The agent configuration file installed with Homebrew is placed in
Before starting-up the agent, you need to configure an API key in the configuration file. The API key can be configured with the following command.
mackerel-agent init -apikey="<YOUR_API_KEY>" -conf /usr/local/etc/mackerel-agent.conf
You can check API keys from the Organization page. Please be careful to not allow this API key to be leaked to the outside as it is used to identify the organization.
For details, refer to the mackerel-agent specifications page.
The following can be achieved using the configuration file:
Startup/stop the agent
To startup and stop the agent, execute the following commands respectively.
brew services start mackerel-agent
brew services stop mackerel-agent
The agent log is output to
When the agent starts to run correctly, it will be registered as a host in Mackerel. This can be confirmed from the Dashboard etc.