106 lines
3.0 KiB
Markdown
106 lines
3.0 KiB
Markdown
# MaxScale Nagios plugins, for Nagios 3.5.1
|
|
|
|
Massimiliano Pinto
|
|
|
|
Last Updated: 12th March 2015
|
|
|
|
## Document History
|
|
|
|
<table>
|
|
<tr>
|
|
<td>Date</td>
|
|
<td>Change</td>
|
|
<td>Who</td>
|
|
</tr>
|
|
<tr>
|
|
<td>10th March 2015</td>
|
|
<td>Initial version</td>
|
|
<td>Massimiliano Pinto</td>
|
|
</tr>
|
|
</table>
|
|
|
|
# MaxScale Requirements
|
|
|
|
MaxScale must be configured with 'maxscaled' protocol for the administration interface:
|
|
|
|
Example of MaxScale.cnf file:
|
|
|
|
[AdminInterface]
|
|
type=service
|
|
router=cli
|
|
|
|
[AdminListener]
|
|
type=listener
|
|
service=AdminInterface
|
|
protocol=maxscaled
|
|
port=6603
|
|
|
|
## Prepare Nagios configuration files.
|
|
|
|
Assuming Nagios installed on a separated server and the plugins are in /usr/lib64/nagios/plugins and configuration files are 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 MaxScale AdminInterface port is 6603
|
|
- default maxadmin executable path is /usr/local/skysql/maxscale/bin/maxadmin
|
|
It can be changed by -m option
|
|
- maxadmin executable could be copied from an existing maxscale setup (default location is /usr/local/skysql/maxscale/bin/maxadmin)
|
|
|
|
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
|
|
|
|
Returns OK and the number of services
|
|
|
|
Returns CRITICAL if no services are found
|
|
|
|
The data after | char are so called performance data and may be collected by Nagios
|
|
output format is:
|
|
servicex=Name;router_module;NumUsers;TotalSessions
|