https://github.com/poblabs/Nagios-Dashboard

A clean and simple overview of your Nagios environment optimized for wall mounted TV displays.
https://github.com/poblabs/Nagios-Dashboard

Last synced: 3 months ago
JSON representation

A clean and simple overview of your Nagios environment optimized for wall mounted TV displays.

• Host: GitHub
• URL: https://github.com/poblabs/Nagios-Dashboard
• Owner: poblabs
• License: mit
• Archived: true
• Created: 2016-12-16T14:10:21.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2016-12-16T16:24:41.000Z (almost 8 years ago)
• Last Synced: 2024-05-29T09:00:59.695Z (6 months ago)
• Language: PHP
• Homepage:
• Size: 43.9 KB
• Stars: 3
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Nagios Dashboard

A clean and simple overview of your Nagios environment optimized for wall mounted TV displays. 

I designed this dashboard **in my spare time** as a way to have quick visibility into the health of the Nagios environment from a TV mounted on the wall in our public space - or on a tablet on your desk. It offers a color coded system which helps stand out any troubles that are going on and automatic background updates mean you don't have to constantly refresh the page.

![alt text](http://i.imgur.com/BmZ4CxB.jpg "Nagios Dashboard")

![alt text](http://i.imgur.com/3rRqL51.png "Nagios Dashboard - All clear")

![alt text](http://i.imgur.com/hxQxzkQ.png "Nagios Dashboard - All acknowledged or OK")

## Requirements

* You need to have a working installation of MK LiveStatus for this dashboard to work. MK LiveStatus is available as a package on many Linux distributions for easy installation. More details on their website: https://mathias-kettner.de/checkmk_livestatus.html

* Apache

* Apache mod_rewrite module if you wish to use the Team Filtering (see below)

* PHP 5.3.3 or newer

## Focused on alerts

* Any host or service in trouble will show on the dashboard

* A clear top banner which is red if any active troubles, or green if all troubles have been acknowledged or no troubles exist

* If there are any active troubles, and acknowledged troubles, the top banner will only focus on those which have not been acknowledged

* If a host is OK, it will not show on the dashboard

* If a host has notifications disabled, it will not show on the dashboard

* Separation of active versus acknowledged for a quick glance on what troubles need to be focused on

## Background AJAX updates

Set it and forget it. The dashboard will constantly refresh the body content with new alerts. Default is 5 seconds, but it is configurable. 

## Team filtering

The dashboard is also hostgroup aware. If you have multiple teams that use your Nagios system, group their items into a hostgroup and give them the URL for their items ( e.g. https://nagios/ops/hostgroup/ ). Each team can have their own wall display, or monitor/tablet which shows them only the items they are responsible for. 

## Mobile responsive design

You can check the dashboard from your mobile devices, the design will change to try and fit everything in. 

![alt text](http://i.imgur.com/Q60DgLml.png "Nagios Dashboard Mobile")

## License

Licensed under the MIT License. A copy of the LICENSE is included with this project.

## Pull Requests Welcome

If you see something wrong - or you want to contribute - just fork the project make your changes and submit a pull request!