MaxScale/Tutorials/Nagios-Plugins.md

MaxScale Nagios plugins, for Nagios 3.5.1

Massimiliano Pinto

Last Updated: 12th March 2015

Document History

Date	Change	Who
10th March 2015	Initial version	Massimiliano Pinto

MaxScale Requirements

MaxScale must be configured with 'maxscaled' protocol for the administration interface

[AdminInterface]
type=service
router=cli

[AdminListener]
type=listener
service=AdminInterface
protocol=maxscaled
port=6603

Prepare Nagios configuration files.

Assuming plugins are in /usr/lib64/nagios/plugins and Nagios configuration in /etc/nagios:

• Copy ./nagios/plugins/check_maxscale_*.pl under /usr/lib64/nagios/plugins
• Copy ./nagios/plugins/maxscale_commands.cfg and server1.cfg to /etc/nagios/objects/
• Edit /etc/nagios/nagios.cfg

and add (just after localhost.cfg or commnads.cfg)

cfg_file=/etc/nagios/objects/maxscale_commands.cfg
cfg_file=/etc/nagios/objects/server1.cfg

Please note:

• modify server IP address in server1.cfg, pointing to MaxScale server
• maxadmin executable must be in the nagios server
• default AdminInterface port is 6603
• default maxadmin executable path is /usr/local/skysql/maxscale/bin/maxadmin It can be changed by -m option

Example related to server1.cfg

#Check MaxScale sessions, on the remote machine.
define service{
	use			local-service
	host_name		server1
	service_description	MaxScale_sessions
	check_command		check_maxscale_resource!6603!admin!skysql!sessions!/path_to/maxadmin
	notifications_enabled	0
}

Check new running monitors

• Restart Nagios and check new monitors are running in Current Status -> Services
• Look for any errors in /var/log/nagios/nagios.log or nagios.debug

Nagios Plugin command line usage

./check_maxscale_threads.pl -h

MaxScale monitor checker plugin for Nagios

Usage: check_maxscale_threads.pl [-r <resource>] [-H <host>] [-P <port>] [-u <user>] [-p <pass>] [-m <maxadmin>] [-h]

Options:
	-r <resource>	= threads
	-h		= provide this usage message
	-H <host>	= which host to connect to
	-P <port>	= port to use
	-u <user>	= username to connect as
	-p <pass>	= password to use for <user> at <host>
	-m <maxadmin>	= /path/to/maxadmin

Output description:

• services

  OK: 7 services found | services1=RW_Router;readwritesplit;1;1 services2=RW_Split;readwritesplit;1;1 services3=Test Service;readconnroute;1;1 services4=Master Service;readconnroute;2;2 services5=Debug Service;debugcli;1;1 services6=CLI;cli;2;145 services7=MaxInfo;maxinfo;2;2