Merge branch 'develop' of https://github.com/mariadb-corporation/MaxScale into develop
This commit is contained in:
Markus Makela
commit
e1c18603a4
84
Documentation/Tutorials/Nagios-Plugins.md
Normal file
84
Documentation/Tutorials/Nagios-Plugins.md
Normal file
@ -0,0 +1,84 @@
|
||||
# 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
|
||||
|
||||
[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)
|
||||
|
||||
1) Copy ./nagios/plugins/check_maxscale_*.pl under /usr/lib64/nagios/plugins
|
||||
2) Copy ./nagios/plugins/maxscale_commands.cfg and server1.cfg to /etc/nagios/objects/
|
||||
3) 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 ; Name of service template to use
|
||||
host_name server1
|
||||
service_description MaxScale_sessions
|
||||
check_command check_maxscale_resource!6603!admin!skysql!sessions!/path_to/maxadmin
|
||||
notifications_enabled 0
|
||||
}
|
||||
|
||||
4) Restart Nagios
|
||||
|
||||
|
||||
# Nagios Plugin 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
|
||||
|
||||
@ -1,44 +0,0 @@
|
||||
MaxScale Nagios plugins, for Nagios 3.5.1
|
||||
|
||||
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
|
||||
|
||||
1) copy check_maxscale_*.pl under /usr/lib64/nagios/plugins
|
||||
2) copy maxscale_commands.cfg, server1.cfg to /etc/nagios/objects/
|
||||
3) Edit /etc/nagios/nagios.cfg
|
||||
|
||||
add
|
||||
|
||||
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 ; Name of service template to use
|
||||
host_name server1
|
||||
service_description MaxScale_sessions
|
||||
check_command check_maxscale_resource!6603!admin!skysql!sessions!/path_to/maxadmin
|
||||
notifications_enabled 0
|
||||
}
|
||||
|
||||
4) Restart Nagios
|
||||
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
###############################################################################
|
||||
# MAXSCALE_COMMANDS.CFG - SAMPLE COMMAND DEFINITIONS FOR NAGIOS 3.5.1
|
||||
#
|
||||
# Massimiliano Pinto
|
||||
# Last Modified: 06-03-2015
|
||||
#
|
||||
# NOTES: This config file provides you with some example command definitions
|
||||
|
||||
@ -101,11 +101,11 @@ define service{
|
||||
notifications_enabled 0
|
||||
}
|
||||
|
||||
# Define a service to check Script on the remote machine.
|
||||
# Define a service to check Script on the remote machine, with maxadmin path
|
||||
define service{
|
||||
use local-service ; Name of service template to use
|
||||
host_name server1
|
||||
service_description MaxScale_threads
|
||||
check_command check_maxscale_threads!6603!admin!skysql!threads
|
||||
check_command check_maxscale_threads!6603!admin!skysql!threads!/usr/local/skysql/maxscale/bin/maxadmin
|
||||
notifications_enabled 0
|
||||
}
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user