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

academia-edu/what

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What? A simple server monitoring tool.

What is a modular, easily-extensible server monitoring tool which is still in the early stages of development.

What do I install?

$ gem install what

What does it do?

Right now, the example config file monitors Unicorn workers. Observe:

$ what -c example/what.yml >/dev/null 2>&1 &
[1] 2392
$ curl localhost:9428
{"unicorn":{"details":[{"cpu_time":"0:00.02","pid":"11023"},{"cpu_time":"0:00.02","pid":"11022"}],"health":"ok","workers":2},"health":"ok"}
$ sudo /etc/init.d/unicorn stop
$ curl localhost:9428
{"unicorn":{"details":[],"health":"alert","workers":0},"health":"alert"}

When the health value of any module is set to "alert" instead of "ok", the HTTP request returns 503 instead of 200. This means What can easily be used in conjunction with monitoring tools like Pingdom.

Writing monitoring modules is easy: the only requirement is that they implement a health method, which returns 'ok', 'warning', or 'alert'. They can also implement a details method, which returns the hash that's included in the HTTP response. See the included What::Modules::Base and What::Modules::Unicorn classes for the implementation details.