18 Nov

10 Steps: MySQL Monitoring through Nagios: Install & Configure

Nagios is a powerful monitoring system and here we will learn how to monitor MySQL through Nagios. We will be installing Nagios, required plugins and configuring it to monitor MySQL Database Server.

Let’s unleash the power step by step:

Installing and configuring Nagios

Step-1 : Install required stuff:
yum install httpd
yum install gcc
yum install glibc*
yum install gd*

Step-2 :Create Nagios user account and group
useradd nagios
passwd nagios
groupadd nagcmd
usermod -G nagcmd nagios
usermod -G nagcmd apache

Step-3: Downloads:
Create directory:
mkdir NagiosSetup
cd NagiosSetup

Download nagios
wget -X Get "http://sourceforge.net/projects/nagios/files/nagios-3.x/nagios-3.2.1/nagios-3.2.1.tar.gz/download"

Download Nagios Plugins:
wget -X Get "http://sourceforge.net/projects/nagiosplug/files/nagiosplug/1.4.15/nagios-plugins-1.4.15.tar.gz/download"

Step-4: Install Nagios

tar -xzvf nagios-3.2.1.tar.gz
cd nagios-3.2.1
./configure --with-command-group=nagcmd
make all
make install
make install-config
make install-commandmode
make install-init
chkconfig --add nagios

[If you miss step “make install-init” you may get:: error reading information on service nagios: No such file or directory ]

Configure Nagios Web Interface:
make install-webconf
htpasswd -c /usr/local/nagios/etc/htpasswd.users nagiosadmin

[specify password for nagios admin]

Step-5: Install plugins
tar xvf nagios-plugins-1.4.11.tar.gz
cd nagios-plugins-1.4.11
./configure --with-nagios-user=nagios --with-nagios-group=nagios
make install

Step-6: Verify Installation, Starting nagios for the first time

service nagios start
Browse: http://localhost/nagios

Here if you get Error:
“You don’t have permission to access /nagios/ on this server.”

Check /etc/httpd/conf/httpd.conf for DirectoryIndex.
If it’s not having index.php add it as follows:

vi /etc/httpd/conf/httpd.conf
DirectoryIndex index.php index.html index.html.var

Make sure you do restart apache(httpd) and nagios every time you change the config file. You must have php installed.

Monitoring MySQL:

Step-7: Download, Extract and install the MySQL Plugin:

wget http://labs.consol.de/wp-content/uploads/2010/10/check_mysql_health-2.1.3.tar.gz

tar -zxvf check_mysql_health-2.1.3.tar.gz
cd check_mysql_health-2.1.3
./configure --prefix=/usr/local/nagios --with-nagios-user=nagios --with-nagios-group=nagios --with-perl=/usr/bin/perl
make install

Step-8: Create database user:
grant usage, replication client on *.* to 'nagios'@'localhost' identified by 'nagios';

Step-9: Provide email address for nagiosadmin:
[Change contacts.cfg file accordingly.]
vi /usr/local/nagios/etc/objects/contacts.cfg

define contact{
contact_name nagiosadmin ; Short name of user
use generic-contact ; Inherit default values from generic-contact template (defined above)
alias Kedar ; Full name of user
email kedar@nitty-witty.com ; <<***** CHANGE THIS TO YOUR EMAIL ADDRESS ******

Step-10: Configuring Nagios to Monitor MySQL Server

vi /usr/local/nagios/etc/nagios.cfg
add following line:

Define check_mysql_health command as follows:

vi /usr/local/nagios/etc/objects/commands.cfg

define command{
command_name check_mysql_health
command_line $USER1$/check_mysql_health -H $ARG4$ --username $ARG1$ --password $ARG2$ --port $ARG5$ --mode $ARG3$

Enter services to be monitored in mysqlmonitoring.cfg:

vi /usr/local/nagios/etc/objects/mysqlmonitoring.cfg

define service{
use local-service
host_name localhost
service_description MySQL connection-time
check_command check_mysql_health!nagios!nagios!connection-time!!3306!

define service{
use local-service
host_name localhost
service_description MySQL slave-io-running
check_command check_mysql_health!nagios!nagios!slave-io-running!!3306!

define service{
use local-service
host_name localhost
service_description MySQL slave-sql-running
check_command check_mysql_health!nagios!nagios!slave-sql-running!!3306!

Here we’ve monitored 3 services: Connection-time, io thread and sql thread (replication) status. You can monitor more parameters described here: http://labs.consol.de/nagios/check_mysql_health/

Note: Every time you change configuration file, verify before starting nagios using command:
/usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg

Finally start nagios service and you’re done with nagios installation and configuration for monitoring MySQL.

Download PDF

I hope you’ve found this useful.

18 thoughts on “10 Steps: MySQL Monitoring through Nagios: Install & Configure

  1. You have been way to generous with the database permissions, do *not* do this:

    grant all privileges on *.* to 'nagios'@'localhost' identified by 'nagios';

    This gives your nagios permission to do *anything* to *all* of your databases. Rather than this you should only give as much permission as is required to do the checks you want. For instance, if all you want is the database statistics and to ensure that a user is able to log into the database you could do this:

    use mysql;
    insert into user (User, Host, Password) VALUES ('nagios', 'localhost', password('nagios'));
    flush privileges;

    This will allow your nagios user to log into mysql and access the database statistics (thread, qps, etc.) but not have any access to your databases. If you must provide access to a database you should only grant SELECT privileges, you certainly don’t want your nagios user to be doing INSERTS or worse yet dropping your database!

    • Ben,

      I definitely agree with you & thanks for pointing that out. I shouldn’t have been lazy!!
      USAGE privileges will suffice what you’re conveying.

      GRANT USAGE, REPLICATION CLIENT on *.* to 'nagios'@'localhost' IDENTIFIED BY 'nagios';

      Or for selects as you specified:

      GRANT USAGE, SELECT, REPLICATION CLIENT on *.* to 'nagios'@'localhost' IDENTIFIED BY 'nagios';

      Thanks again.

  2. Hi,
    Please let me know the steps which needs to be done on mysql server and the steps which needs to be done on nagios server.

    Krishna Rajesh

  3. Hi Kedar,

    Can we have a centralized server with Nagios installed and monitor mysql instances running on several hosts?

    What will be the load on the server if we monitor about 100 instances from this centralized server?

    Thanks in advance,

    • Hi Mohan,

      Sorry for the delayed reply.
      Well that’d be an ideal way of doing it.
      A well configured server Nagios won’t take much load.

      Thanks for visiting,

  4. How to change the alert level for no. of thereads connected like critical n warning level now its 10 n 20 seems , i need to change to 50 n 100

  5. Great write up, thanks for that, however I believe the plugin link (labs.consol.de/wp-content/uploads/2010/10/check_mysql_health-2.1.3.tar.gz) is broken? Or is it just me? I’d love to have this up and running! Thanks again.

  6. Hi

    I want to change the WARNING and CRITICAL parameter in check_mysql_health.

    Ex. Set 1 for WARNING and 3 for CRITICAL

    How can change it?

  7. Hi please add the package net-snmp which is the main for monitoring..Otherwise you will get a

    Error :
    “Return code of 127 is out of bounds – plugin may be missing”

    yum install net-snmp*

    Packages are below

  8. Hello All,

    I am totally new on Linux. And recently I have configured a Nagios 3.4.1 server on Ubuntu 12.04 Desktop version. My Nagios server is running and showing output on web console as well. At the moment I have configured two check_commands (Check_ping and Check_snmp) in which check_ping is working fine and showing output in web console. But check_snmp is not working and my host on web console showing this service as a “critical” service.

    And the status Information section of this critical service is showing this message “Service Check Timed Out”.

    I have try to find solution on internet but nothing works, maybe as I am totally new so I am missing some configure required for snmp.

    For your information:

    /usr/local/nagios/libexec is shwoing check_snmp

    On my server snmpd is running (I have checked with service snmpd status command)

    and I have already installed and complied nagios-plugin-1.4.15 (with the help of commands available in nagios documentation)

    Could any one suggest me how could I fix this issue. And if possible can someone share with me the step-by-step setting of SNMP for all the parameters in Nagios/Ubuntu. So that I can cross check my snmp settings.

    Many Thanks in advance.


  9. Hi ALL,
    I configured nagios successfully and didnt get any error and nagios home page loading fine but remaining pages like services hosts, ets not loading and shows “The server encountered an internal error or misconfiguration and was unable
    to complete your request.

    Please contact the server administrator, root@localhost and inform them of
    the time the error occurred, and anything you might have done that may have
    caused the error.

    More information about this error may be available in the server error

    i issue below command but didn’t get any warning or errors …what could be the reason..

    /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg

    Apache/2.2.15 (Red Hat) Server at localhost Port 80 am facing this issue

Leave a Reply

Your email address will not be published. Required fields are marked *


You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

-- Kedar Vaijanapurkar --