Difference between revisions of "Nagios"

From ArchWiki
Jump to: navigation, search
(Features)
(Nagios Configuration)
Line 46: Line 46:
 
# cp /etc/nagios/objects/templates.cfg.sample /etc/nagios/objects/templates.cfg
 
# cp /etc/nagios/objects/templates.cfg.sample /etc/nagios/objects/templates.cfg
 
# cp /etc/nagios/objects/timeperiods.cfg.sample /etc/nagios/objects/timeperiods.cfg
 
# cp /etc/nagios/objects/timeperiods.cfg.sample /etc/nagios/objects/timeperiods.cfg
 +
</pre>
 +
 +
Make owner/group for all the files you just copied and belong to root equal to nagios/nagios:
 +
 +
<pre>
 +
chown -R nagios:nagios /etc/nagios
 
</pre>
 
</pre>
  

Revision as of 23:34, 10 January 2010

Template:Article summary start Template:Article summary text Template:Article summary heading Template:I18n entry Template:Article summary end

Nagios is an open source host, service and network monitoring program. It monitors specified hosts and services, alerting you to any developing issues, errors or improvements. This article describes the installation and configuration of Nagios.

Features

Some of Nagios' features include:

  • Monitoring of network services (SMTP, POP3, HTTP, NNTP, PING, etc.)
  • Monitoring of host resources (processor load, disk usage, etc.)
  • Simple plugin design that allows users to easily develop their own service checks
  • Parallelized service checks
  • Ability to define network host hierarchy using "parent" hosts, allowing detection of and distinction between hosts that are down and those that are unreachable
  • Contact notifications when service or host problems occur and get resolved (via email, pager, or user-defined method)
  • Ability to define event handlers to be run during service or host events for proactive problem resolution
  • Automatic log file rotation
  • Support for implementing redundant monitoring hosts
  • Optional web interface for viewing current network status, notification and problem history, log file, etc.

The following installation and configuration were tested using nagios 3.2.0-1, Apache web server 2.2.14-2, and PHP5 5.3.1-3 by awayand.

Requirements

From the PKGBUILD: freetype2 gd glib2 libtool. According to the official documentation a webserver is not required, but if you wish to use any of the CGI features then a webserver (apache preferred) and the gd library are required. This is assumed for this installation

Installation

Nagios can be found in AUR (see AUR and AUR User Guidelines), and any of the AUR Helpers can be used to build and install Nagios. The below example assumes Yaourt is installed.

$ yaourt -S nagios nagios-plugins

Nagios Configuration

Copy the sample config files as root:

# cp /etc/nagios/cgi.cfg.sample /etc/nagios/cgi.cfg
# cp /etc/nagios/nagios.cfg.sample /etc/nagios/nagios.cfg
# cp /etc/nagios/objects/commands.cfg.sample /etc/nagios/objects/commands.cfg
# cp /etc/nagios/objects/contacts.cfg.sample /etc/nagios/objects/contacts.cfg
# cp /etc/nagios/objects/localhost.cfg.sample /etc/nagios/objects/localhost.cfg
# cp /etc/nagios/objects/templates.cfg.sample /etc/nagios/objects/templates.cfg
# cp /etc/nagios/objects/timeperiods.cfg.sample /etc/nagios/objects/timeperiods.cfg

Make owner/group for all the files you just copied and belong to root equal to nagios/nagios:

chown -R nagios:nagios /etc/nagios

Create htpasswd.users file with a username and password, eg. nagiosadmin and secretpass

# htpasswd -c /etc/nagios/htpasswd.users nagiosadmin

If the owner/group of the nagios-plugins you installed are root:root, as encountered by andaway the following needs to be done:

# chown -R nagios:nagios /usr/share/nagios

Once Nagios is configured, it is time to configure the webserver.

Apache Configuration

Edit /etc/httpd/conf/httpd.conf, add the following to the end of the file:

# nagios
Include /etc/httpd/conf/extra/nagios.conf

Add the apache user http to the group nagios, otherwise you will get the following error when using nagios:

Could not open command file '/var/nagios/rw/nagios.cmd' for update!: 
# usermod -G nagios -a http

PHP Configuration

Edit /etc/php/php.ini to include /usr/share/nagios in the open_basedir directive.

Example configuration:

open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps:/etc/webapps:/usr/share/nagios

Start nagios:

/etc/rc.d/nagios start

Start/Restart apache:

/etc/rc.d/httpd restart

Now you should be able to access nagios through your webbrowser using the username and password you have created above using htpasswd:

http://localhost/nagios

Have fun!

External Links

  1. nagios.org Official website
  2. Nagios Plugins the home of the official plugins
  3. wikipedia.org Wikipedia article
  4. NagiosExchange overview of plugins, addons, mailing lists for Nagios
  5. NagiosForge a repository for ad
  6. libgd.org GD Library homepage, required for image manipulation