1. Start
  2. About
  3. Features
  4. Requirements
  5. Installation
  6. Settings
  7. Usage
  8. Change Log
  9. Credits

wmon

web server monitor


About


wmon is web based server monitor for one or more Linux servers.

Features


Requirements


Installation


Extract the zip file to web path you desire. Edit the config.php and set 'log' setting to some writable location,
for instance to '/tmp/wmon.log'.After that you need to add wmon to crontab this way:

*/5 * * * * /path/to/php /path/to/wmon/index.php &> /dev/null

You can find /path/to/php executable with "which php" executing in command line. Navigate to your web browser and you should see wmon report. Chart may be empty on start, because measurements are made every 5min and there is not anything to draw jet. Give it some time or run crontab command manually to get some data quicker (must be run in command line). To include other servers to report, just repeat the same installations steps for each machine and then add their uri to config.php to external property (see example in the file).

Email notifiacations are sent by native php mail function, so your server must be properly setup to send it correctly, otherwhise it will probably end up in spam or not be sent. If you desire you can use your own method (smtp or what ever) for mail sending, just search for "send mail" in index.php and replace it with you own function.

Settings


All wmon settings are in config.php file.

Usage


Load chart displays 3 series of data representing 1min, 5min and 15 min load average. Mouse over chart will give you detailed measurements of each load average numbers on top left corner. In the same time top processes table below turns yellow, what will show you top processes for the pointed time. When the table is white it show the current data form last refresh of the page. Service status changes are also indicated on chart. When the red annotation show it means that some of services changed state. Mouse over the annotation show you the exact services status in pointed time. Chart allows also vertical and horizontal zooming, by mouse click and drag over over it. Double click will zoom out.

Chart data is stored in cvs format and its size will grow to more then 200kb in 7 days. This can relay slow chart loading, so it is advised to run web server with gzip or deflate support which compress files up to 10 times during transfer.

Note:
Notifications and status changes are stored by position index in config.php so if you are re-ordering services you may get wrong notifications or statues in web view. This will only happen right after your change and will go away after some time. Good pratice is to add new services on the end. Once it is setup, configuration usually don't change a lot so it shudn't be a problem.

Change Log


2.0 - Mar. 2013
- responsive layout
- updated chart libn now supports touch events
- email notifications on service status changes and on disk usage limits
- added internet connection checking
- various fixes

1.0 - Aug. 2011
- first release

Credits


dygraphs chart - http://dygraphs.com/
mootools javascript framework - http://mootools.net/
Mustache.php
twitter bootstrap - http://twitter.github.com/bootstrap/
favicon.ico by Tango project