Xymondash - because it's not 1997 any more
- for each test, we have a two-dimensional coordinate defined by the test's priority (P1 to P3 or none) and the result of the test (red, yellow, green..). So it makes sense to display the test results in a matrix with the most important stuff in the upper left corner and the least important items in the lower right. We decided on prio for the x axis and color for the y axis
- if a hosts has multiple non-green entries (say P2/yellow and P1/red), we only want to see it once in our matrix, at P1/red. The P2/yellow entry will be added to the P1/red and "jumps back" to P2/yello once P1/red has been resolved, disabled or acknowledged
- we want to make acknowledging and disabling tests fast and easy in order to encourage team members to let their colleagues know they're working on something and get the corresponding entry off of everybody's matrix. You can acknowledge and disable individual tests or all tests of a host. Tests will also be acknowledged on the critical view
- we want to show as much information as possible as unobtrusively as possible. Hence we use mouse-over tooltips a lot
- if you're like us, you're looking at the monitoring interface a lot of times during the day. There might be tests that shouldn't be acknowledged, but you can't get rid of them right now either. In order not to have to "mentally parse" the whole matrix each time, you can hit the 'mark all as seen' button which will fade out all currently present tests so that all new ones will be very hard to miss
- there's a dynamic favicon and you can turn on desktop notifications
- you can override the URL parameters used to fetch the JSON data in order to modify which tests to fetch (see
- the interface should be usable on mobile devices ("responsive")
- everything is configurable: which colors and prios to see, display acknowledged/disabled tests or not, conditions for the overall background color etc
- you can search for hosts and display all their tests
- keyboard shortcuts:
mfor mark as seen,
In order to get Xymondash running on top of your Xymon monitoring, you'll have to do the following:
- check out the Xymondash folder on your monitoring server
config.inito the correct location in your file system
./config.shto configure the CGI scripts
- make sure the CGI scripts are working. They require Python >= 3.5 (if you need to support 3.4 you have to switch to the old subprocess API instead of the now recommended run method). If your web server is picky about CGI locations, you can copy the two CGIs to
<path-to>/xymon/cgi-bin/and run them from there. Open the URL of
xymon2jsonin your browser and make sure it generates JSON. Don't bother to proceed until this works!
- with the CGIs in place, edit
config.inito the correct URLs of
./config.shagain to configure the JS
- finally pick a
- point your web browser to the Xymondash URL and you should be good to go!
- after a
git pullupdate, you'll just have to run
./config.shagain to recover your settings
- hover tooltips on mobile devices: iOS seems to work around by doing 'first click -> hover, 2nd click -> real click', and on Android short press -> click, long press -> hover works most of the time.
- Safari and Edge don't render a nice color gradient on the background as they don't support
background-blend-mode: soft-light. Oh well, 2018 and some browsers still suck...