- User Guide >
- Monitoring Agent >
- Configure Hardware Monitoring with
munin-node
Configure Hardware Monitoring with munin-node
¶
On this page
Overview¶
On Prem MMS Monitoring provides support for several plugins for charting hardware statistics collected with Munin. MMS supports the following munin-node plugins:
cpu
plugin, which creates thecputime
chart.iostat
plugin, which creates theiostat
chart.iostat_ios
plugin, which creates theiotime
chart.
Install the munin-node
Package¶
You
must install the munin-node
package on all of the host systems that
you wish to monitor. Ensure that the Monitoring Agent can connect to the
munin-node
process on port 4949 of the monitored host to collect data.
Note
munin-node
, and hardware monitoring is only available for
MongoDB instances running on Linux hosts.
On Debian and Ubuntu systems, issue the following command to install
munin-node
:
To install munin-node
on Red Hat, CentOS, and Fedora systems, issue
the following command:
Note
For Red Hat and CentOS 6.8 systems, you will need to install the
EPEL repository before installing munin-node
. To install the
EPEL repository, issue the following command:
Configure munin-node
¶
When installation is complete, ensure that munin-node
:
is running. Use the command, “
ps -ef | grep "munin"
” to confirm. If the process is not running, issue the command “/etc/init.d/munin-node start
”.will start following the next system reboot. This is the default behavior on most Debian-based systems. Red Hat and related distributions should use the “
chkconfig
” command, to configure this behavior (i.e. “chkconfig munin-node on
”)is accessible from the system running the agent.
munin-node
uses port 4949, which needs to be open on the monitored system, so the agent can access this data source. Use the following procedure to test access:Replace
[HOSTNAME]
with the hostname of the monitored system. Run these commands from the system where the Monitoring Agent is running. If these “fetch
” commands return data, thenmunin-node
is running and accessible by the Monitoring Agent.
Note
On some platforms, munin-node
does not have all required
plugins enabled.
For CentOS and Ubuntu, the munin-node
package does not have the iostat
and iostat_ios
plugins enabled. Use the following operation to enable
these plugins:
If munin-node
is running but inaccessible, make sure that you have
access granted for the system running the Monitoring Agent and that no
firewalls block the port between munin-node
and the Monitoring
Agent. You may find the munin-node
configuration at
/etc/munin-node/munin-node.conf
, /etc/munin/munin-node.conf
, or /etc/munin-node.conf
,
depending on your distribution.
Additional Considerations for munin-node
¶
If you have numbered disk devices (e.g.
/dev/sda1
and/dev/sda2
) then you will need to configure support for numbered disk in the munin iostat plugin. Find the configuration file at/etc/munin/plugin-conf.d/munin-node
or a similar path, and add the following value:If you have Munin enabled and do not have
iostat ios
data in your Munin charts, yourmunin-node
may not have write access to required state files in itsmunin/plugin-state/
directory. See themunin-node
plugin log (i.e./var/log/munin/munin-node.log
or similar depending on your distribution) for more information.The full path of this state directory depends on the system, but is typically
/var/lib/munin/plugin-state/
. Run the following command sequence to correct this issue:Replace
[username]
and[group]
with the username and group that themunin-node
process runs with.Add the host running the Monitoring Agent to the allow directive in the
/etc/munin-node/munin-node.conf
file. The allow directive lists hosts allowed to query the munin-node process. Otherwise, traffic from the MMS host will be allowed via firewall but will not be collected by munin.
If you encounter any other problems, check the log files for munin-node
to
ensure that there are no errors with Munin. munin-node
writes logs files in
the /var/log/
directory on the monitored system.
See also