Using the official check plugin pack for check monitoring, you can easily monitor processes, logs, and other types of checks in Mackerel.
See below for plugins included in the official check plugin pack.
- Installing the official check plugin pack
- Using the official check plugin pack
- Usage example
- Source code for the official check plugin pack
Installing the official check plugin pack
We recommend using yum or apt repositories for installation, depending on your environment. The repository is set up when you do Register a new Host; if you want to get the rpm or deb files directly, please refer to GitHub Releases.
sudo yum install mackerel-check-plugins
Updates can be performed using the following command.
sudo yum update mackerel-check-plugins
sudo apt-get install mackerel-check-plugins
Updates can be performed using the following command.。
sudo apt-get update sudo apt-get install mackerel-check-plugins
Updating the agent will also update the included plugins. See Installing mackerel-agent on Windows for instructions on how to update.
Plugins that are not included are not officially supported and must be built by the user.
Using the official check plugin pack
Each plugin will be installed in
/usr/bin, so you will need to add the item shown below to the mackerel-agent settings file for the plugins you will be using. To apply the settings, you will need to restart the mackerel-agent.
If you wanted to, for example, use the process monitoring plugin to monitor crond, you would add the following item.
[plugin.checks.check_cron] command = ["check-procs", "-p", "crond"]
Each plugin is stored in the agent's installation folder and has its own path. add the following settings to mackerel-agent's configuration file according to the plugin you are using. Restarting mackerel-agent is required for the settings to take effect.
To monitor the process "foobar" using the process monitoring plugin, use the following description.
[plugin.checks.check_foobar] command = ["check-procs", "-p", "foobar"]
Source code for the official check plugin pack
The source code for the official check plugin pack is publicly available here: GitHub. We are always happy to receive your pull requests for things like plugins to support new middleware.
For information about making plugins, please refer to Adding monitors for script checks.