Adagios

Adagios - Web Based Nagios Configuration

About

Adagios is a web based Nagios configuration interface build to be simple and intuitive in design, exposing less of the clutter under the hood of nagios. Additionally adagios has a rest interface for both status and configuration data as well a feature complete status interface that can be used as an alternative to nagios web interface.

Project website is at http://adagios.org

Live Demo

http://adagios.opensource.is/

Features

Design principals

Components

Source Code

git clone http://github.com/opinkerfi/adagios.git

Install Instructions

These installation instructions apply for rhel6. If running Fedora, please modify yum repos as needed.

For RHEL6/CentOS6 you must install epel yum repository (fedora users skip this step):

rpm -Uvh http://download.fedoraproject.org/pub/epel/6/$HOSTTYPE/epel-release-6-8.noarch.rpm

Next step is to install OK yum repository:

rpm -Uhv http://opensource.is/repo/ok-release-10-1.el6.noarch.rpm

Install needed packages:

yum --enablerepo=ok-testing install -y nagios git adagios

Install okconfig (optional). Okconfig is a collection of plugins and templates for monitoring enterprise equipment. If installed Adagios will have options such as network scan and remote installation of clients.

yum --enablerepo=ok-testing install -y okconfig

Adagios will not work unless you turn off selinux:

sed -i "s/SELINUX=enforcing/SELINUX=permissive/" /etc/sysconfig/selinux
setenforce 0

If you plan to access adagios through apache, make sure it is started:

service httpd restart
chkconfig httpd on

Same goes for nagios, start it if it is ready

service nagios restart
chkconfig nagios on

It is strongly recommended that you create a git repository in /etc/nagios/ and additionally give ownership of everything in /etc/nagios to the nagios user.

cd /etc/nagios/
git init
git add .
git commit -a -m "Initial commit"
# Make sure nagios group will always have write access to the configuration files:
chown -R nagios /etc/nagios/* /etc/nagios/.git
setfacl -R -m group:nagios:rwx /etc/nagios/
setfacl -R -m d:group:nagios:rwx /etc/nagios/

By default objects created by adagios will go to /etc/nagios/adagios so make sure that this directory exists and nagios.cfg contains a reference to this directory.

mkdir -p /etc/nagios/adagios
pynag config --append cfg_dir=/etc/nagios/adagios

Congratulations! You are now ready to browse through adagios through http://$servername/adagios/. By default it will use same authentication mechanism as nagios. (on rhel default is nagiosadmin/nagiosadmin and can be changed in /etc/nagios/passwd)

Using the Status view

Adagios has an experimental status view intended to partially replace the classical nagios web interface. If you want to try it out hen you need mk_livestatus and pnp4nagios broker modules installed:

yum install -y pnp4nagios mk-livestatus
pynag config --append "broker_module=/usr/lib64/nagios/brokers/npcdmod.o config_file=/etc/pnp4nagios/npcd.cfg"
pynag config --append "broker_module=/usr/lib64/mk-livestatus/livestatus.o /var/spool/nagios/cmd/livestatus"
pynag config --set "process_performance_data=1"

# Add nagios to apache group so it has permissions to pnp4nagios's session files
usermod -G apache nagios

# We need to restart both apache and nagios so new changes take effect
service nagios restart
service httpd restart
service npcd restart
chkconfig npcd on

Contact us

If you need any help with getting adagios to work, feel free to open up an issue on github issue tracker. If you want to chat you can contact us on: