• Overview
  • Deploying MCollective
  • Configuration / Deployment Topics
  • Use and Administer MCollective
  • Write Agent Plugins
  • Write Clients and Applications
  • Write Other Plugins
  • Plugin Directory
  • Internals
  • Older and Non-Recommended Information

MCollective Plugin: Agent Registration Monitor


MCollective supports sending registration messages at set intervals. This is an agent to receive those messages and simply write the content to a file per sender.

It includes a Nagios check that monitors the directory with these files for any that has not checked in for some time.

You can use this agent as well as other types of registration agents, just not more than one per server. So you can inventory your machines as well as monitor them on your Nagios server by just enabling registration on the mcollectived servers.



By default the plugin will create /var/tmp/mcollective and create files in there per sender id.

You can configure the directory used using the setting plugin.registration.directory in the server config.

You’d install this agent in just one of your nodes and then install the included Nagios check onto the same machine.

The nagios check should be invoked like:

check_mcollective --directory /var/tmp/mcollective --interval 300
OK: 50 / 50 hosts checked in within 300 seconds| totalhosts=50 oldhosts=0 currenthosts=50

It includes performance data for Nagios.

See an issue? Please file a JIRA ticket in our [DOCUMENTATION] project
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.