XYMOND_HOSTDATA(8)

💖 XYMOND_HOSTDATA 💖

okay bestie, gather round, because we're talking about xymond_hostdata from the Xymon manual pages (section 8, system manager's manual, very official very demure) and honestly? she's lowkey a lifesaver.

✨ NAME ✨

xymond_hostdata — a xymond worker module whose whole personality is storing historical client data. that's it. that's the job. 💅

🦋 SYNOPSIS 🦋

xymond_channel --channel=clichg xymond_hostdata

literally just that. one line. slay.

🌸 DESCRIPTION 🌸

so xymond_hostdata is a worker module for xymond, and because of that it's normally run through the xymond_channel(8) program. that's her ride-or-die. 🫶

here's the vibe: whenever a status column in Xymon changes to an alert state — usually red, yellow or purple — this module gets a copy of the latest Xymon client data that the host sent, and it stores it on disk. periodt.

and why do we care?? because that means you can go back and review all of the data collected by the Xymon client on the server around the time that a problem occurred. it's giving time machine. it's giving receipts. 🔥

this makes troubleshooting incidents easier, because you get a snapshot of the host status shortly before a problem became apparent. like, the host was being weird and you have the evidence from right before it all went down. iconic.

⚠️ note, bestie, this one is important: this module requires that xymond(8) is launched with the --store-clientlogs option enabled. no option, no data, no vibes. don't skip it. 🙈

💅 OPTIONS 💅

• --minimum-free=N — sets the minimum percentage of free filesystem space on the $CLIENTLOGS directory. if there's less than N% free space, xymond_hostdata will not save the data. she's not about to fill up your disk, she has boundaries. ✋ Default: 5
• --debug — enable debugging output. for when you need to see what's going on in there. 🔍

🎀 FILES 🎀

all of the host data gets stored in the $CLIENTLOGS directory, and by default that's the $XYMONVAR/hostdata/ directory. that's where the lore lives. 📁

👑 SEE ALSO 👑

xymond(8), xymond_channel(8), xymon(7)

and that's the whole page, bestie!! 💖 this one shipped with Xymon Version 4.3.30, dated 4 Sep 2019 — so yeah, she's been holding down the historical-client-data game for a minute and she's still that girl. go forth and troubleshoot with receipts. ✨🦋🌸