Nagios Plugins Tutorial

Nagios Plugins Tutorial

Tutorials/Nagios-Plugins.md

@@ -0,0 +1,46 @@
+# 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
+
+## Prepare Nagios configuration files
+
+	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
+
+