Chapter 5. Configure Ceph Plug-ins

Log in to the monitor server and create a Ceph key and keyring for Nagios.

[user@mon]# ssh mon
[user@mon]# cd /etc/ceph
[user@mon]# ceph auth get-or-create client.nagios mon 'allow r' > client.nagios.keyring

Each plug-in will require authentication. Repeat this procedure for each host that contains a plug-in.

Before proceeding with additional configuration, ensure that the plug-ins are working. For example:

[user@mon]# /usr/lib/nagios/plugins/check_ceph_health --id nagios --keyring /etc/ceph/client.nagios.keyring

The check_ceph_health plug-in performs the the equivalent of:

[user@mon]# ceph health

Add a command for the check_ceph_health plug-in.

[user@mon]# vim /usr/local/nagios/etc/nrpe.cfg

For example:

command[check_ceph_health]=/usr/lib/nagios/plugins/check_ceph_health --id nagios --keyring /etc/ceph/client.nagios.keyring

Save and restart NRPE.

[user@mon]# systemctl restart nrpe

Repeat this procedure for each Ceph plug-in applicable to the host. See https://github.com/valerytschopp/ceph-nagios-plugins for usage.

Return to the Nagios server and define a check_nrpe command for the NRPE plug-in.

[user@nagios]# cd /usr/local/nagios/etc/objects
[user@nagios]# vi commands.cfg

define command{
 command_name check_nrpe
 command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -c $ARG1$
}

On the Nagios server, edit the configuration file for the host and add a service for the Ceph plug-in. For example:

[user@nagios]# vim /usr/local/nagios/etc/objects/mon.cfg

define service {
  use                   generic-service
  host_name             mon
  service_description   Ceph Health Check
  check_command         check_nrpe!check_ceph_health
}

Note that the check_command setting uses check_nrpe!` before the Ceph plug-in name. This tells NRPE to execute the check_ceph_health command on the remote host.

Repeat this procedure for each plug-in applicable to the host.

Then, restart the Nagios server.

[user@nagios]# systemctl restart nagios