fnordpojk / merlin-dashboard

A dashboard for use with Nagios/Naemon and Merlin
12 stars 10 forks source link

README for merlin-dashboard

This dashboard for Nagios/Naemon using the Merlin backend was originally made by Morten Bekkelund bekkelund@gmail.com and made available at http://dingleberry.me/2010/04/our-new-dashboard/ and later at https://github.com/mortis1337/nagios-dashboard where several people forked it.

Meanwhile, I and a number of other people had been hacking on it in private, fixing bugs and adding features, but not publishing the additions.

This is, finally, a fork of Morten's code with the additional patches. I aim to continue maintaining this, possibly adding patches from other people's forks.

Authors

Original project by Morten Bekkelund bekkelund@gmail.com.

This project maintained by Mattias Bergsten mattias.bergsten@op5.com.

Patches from the following list of fine people and companies:

Some Livestatus socket code borrowed from the mklivestatus-slave project by Lars Michelsen at http://git.larsmichelsen.com/git/?p=mklivestatus-slave.git.

License

GPL v3

Requirements

and either

or

Installation for Merlin version 1.x

Put the files in a directory on your webserver. Edit merlin.php and change the server, username and password to fit your environment. Symlink nagios.php to index.php to save typing.

Installation for Merlin version 2.x

In Merlin 2.0, saving status data to the database is turned off by default. If you do not mind the performance penalty of writing status data to the database, you can turn it on again by adding "track_current = yes" and an import program to your merlin.conf, and then following the above instructions for version 1.x.

In Monitor 6, we instead use Livestatus to access status data, because it is significantly faster. To use the Livestatus version, put the files on your monitoring server (where Livestatus runs), then edit merlin2.php and set the path to the Livestatus socket. Symlink livestatus.php to index.php to save typing.

Installation for the op5 Monitor REST API

Put the files in a directory on your webserver, edit merlin-api.php and update the server, user and password to use to access the API. Symlink op5monitor.php to index.php.

Take a look at api-examples.html for some examples on how to define filters.