/plugin_monitor

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

/*******************************************************************************

    Author ......... Jimmy Conner
    Contact ........ jimmy@sqmail.org
    Home Site ...... http://cactiusers.org
    Program ........ Monitoring for Cacti
    Version ........ 2.0
    Purpose ........ Simple Whats-Up-Gold replacement

*******************************************************************************/


----[ Purpose

    This plugin allows you to view at a glance all your Cacti hosts, and will alert you audibly when something is down.
	In addition, you may receive notification if any critical host becomes unreachable.

	Some audio clips courtesy of SoundBible.com and licensed under Creative Common and other Free to use Licenses.
	If you create an MP3 file called 'First Order Chorus.mp3' and place it in the sound folder, you may get a surprise
	if you choose to use it.

----[ Features

    Audible alert
    Can set permissions on who can view
    Can disable monitoring of a host

----[ Installation

    Install just like any other plugin, just throw it in the plugin directory,
    in a folder called monitor.
    Edit your includes/config.php and add it to your $plugins list, and you are rolling
   
----[ Possible Bugs?
   
    If you figure out this problem, let me know!!!

----[ Future Changes
    
    Got any ideas or complaints, please e-mail me!

----[ Changelog
	---  2.0 ---
	feature: Support for Cacti 1.0
	feature: Complete redesign using font awesome
	feature: Allow specification of device criticality
	feature: Allow specification of warning and alert ping round trip latency number
	feature: All GUI interactions using ajax
	feature: Specification of settings using filter
	feature: Save user based settings
	feature: Using new Cacti permissions system
	feature: Generalized code cleanup
	feature: Integrate better with Thold and Syslog

	---  1.3 ---
	compat: Fix general header

	---  1.2 ---
	bug#0001654: a little update for monitor plugin 
	bug: Correct some undefined offset errors

	--- 1.1 ---
	compat: Allow proper navigation text generation
	bug: User would see console as a pick even if they were guest
	bug: Mute button does not work properly
	bug: Text fields in  MySQL can not include a default

	--- 1.0 ---
	feature: Add Grouping by Host Template
	feature: Adding 0.8.7f features

	--- 0.9 ---
	Monitor is now only PA 2.0 compatible
	Fix for mass enabling / disabling monitoring of hosts

	--- 0.8.2 ---
	Change from JS Status popup to pure CSS
	Remove "Details" view

	--- 0.8.1 ---
	Fix compatibility issue between monitor and thold v0.3.6

	--- 0.8 ---
	Add a muted icon to show what hosts are currently muted
	Only show hosts that have had at least 2 pollings.  This stops it from alerting on new hosts that haven't been properly polled yet.
	All the selecting of "None" as a sound to not have it play an alert
	Move from using cookies to using session variables
	Allow the display of a Host Down Message
	Add fix for not showing disabled thresholds
	Lots of code cleanup
	Add a patch by fri that allows grouping by tree / header and does user auth checking
	Use new "api_user_realm_auth" from Plugin Architecture
	Display host down time under the hostname
	Fix Cacti 0.8.7 compatibility


	--- 0.7 ---
	#0000044 - Modify device image to link to device's graphs
	#0000052 - If the Threshold plugin is running, change the host color to Orange if a threshold is breached
	Add option to select an different alarm sound from the available wav and mp3 files in the sounds directory
	Update tab image to better resemble the original cacti images
	Add option to add an icon legend to the Monitor display
	Moved sounds to their own folder
	Fixes to the fast poller

	--- 0.6 ---
	Allow guest access to the Monitor Tab
	#0000013 - Fix issues with database names with uncommon characters by enclosing in back-ticks

	--- 0.5 ---
	Fixed an issue with the mute button action url (thanks Tut'!)
	Fixed an issue with the monitor page and includes
	Fixed an issue with the Fast Poller paths

	--- 0.4 ---
	Added Javscript Mouseover Tooltips.  This replaces the title attribute which I used before (Newlines didn't work in Firefox)

	--- 0.3 ---
	Added Settings for Refresh Rate and Width of Hosts See Settings >> Misc
	Added Faster Poller so that you can know immediately if something is down
           
	--- 0.2 ---
	Fix for navigational line

	--- 0.1 ---
	Initial release