Skip to content
This repository has been archived by the owner on Jun 25, 2023. It is now read-only.

Latest commit

 

History

History
41 lines (29 loc) · 2.59 KB

README.md

File metadata and controls

41 lines (29 loc) · 2.59 KB

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

alt text

alt text

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

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!