COMBOSTATUS(1)

💖 COMBOSTATUS 💖

okay bestie, welcome to combostatus — it's the Xymon combination test tool, and honestly? it's giving ✨main character energy✨ for anyone running redundant systems. 🫶

🌸 SYNOPSIS 🌸

combostatus --help
combostatus --version
combostatus [--debug] [--quiet]

🦋 DESCRIPTION 🦋

so. combostatus is a Xymon extension script, and it lives on the Xymon server (yes, the server, not the client, iykyk). what it does is literally the coolest thing: it takes the results of one or more of your normal Xymon test results and smooshes them together into one combined test result, using standard arithmetic and logical operators. math but make it monitoring 💅

and then — the way that it sends those resulting tests to the Xymon display server as any normal test? obsessed. that means all the standard Xymon functions (history, statistics, etc.) are available for your combined tests too. no special treatment, no weird caveats, they just work like every other test. periodt. 👑

where did this icon come from, you ask? it was born from the need to monitor systems with built-in redundancy and automatic failover — like, say, load-balanced web servers. 🌈 but other uses are possible, so go off, get creative.

✨ OPTIONS ✨

• --error-colors=COLOR[,COLOR] — tell it 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 info about the underlying test results used to figure out the current value of the combined test. --quiet eliminates that info from the test status page. 🤫
• --debug — provides debugging output for use in troubleshooting problems with combostatus. for when you're like "why is this doing that 😭" — this is your girl.
• --no-update — don't send any status messages at all! instead, the result of the combotests is simply dumped to stdout. super useful for debugging. 🙈

🎀 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. ⏰

💜 SEE ALSO 💜

combo.cfg(5), hosts.cfg(5), xymonserver.cfg(5), tasks.cfg(5)

fr fr, go read those other pages too. they're part of the lore. 📚

and that's the whole vibe check, bestie — this page is from Xymon, Version 4.3.30, dated 4 Sep 2019. slay, stay monitored, and don't forget your error colors. 💅✨🌸