combostatus - Xymon combination test tool
Contents
Description
combostatus is a Xymon extension script that runs on the Xymon server. It combines the results of one or
more of the normal Xymon test results into a combined test result, using standard arithmetic og logical
operators.
The resulting tests are sent to the Xymon display server as any normal test - so all of the standard
Xymon functions (history, statistics etc.) are available for the combined tests.
The tool was born from the need to monitor systems with built-in redundancy and automatic failover - e.g.
load-balanced web servers. But other uses are possible.
Files
$XYMONHOME/etc/combo.cfg
Configuration file for combostatus, where the combined tests are defined
$XYMONHOME/etc/tasks.cfg
Configuration file controlling when combostatus is run.
Name
combostatus - Xymon combination test tool
Options
--error-colors=COLOR[,COLOR]
Specify which colors trigger an error status. By default only a "red" status counts as an error
color - all other colors, including yellow, will count as "green" when evaluating the combined
status. COLOR is "red", "yellow", "blue", "purple" or "clear".
--quiet
Normally, the test status sent by combostatus includes information about the underlying test
results used to determine the current value of the combined test. "--quiet" eliminates this
information from the test status page.
--debug
Provide debugging output for use in troubleshooting problems with combostatus.
--no-update
Don't send any status messages - instead, the result of the combotests is simply dumped to stdout.
Useful for debugging.
See Also
combo.cfg(5), hosts.cfg(5), xymonserver.cfg(5), tasks.cfg(5) Xymon Version 4.3.30: 4 Sep 2019 COMBOSTATUS(1)
Synopsis
combostatus--helpcombostatus--versioncombostatus[--debug][--quiet]
