XYMOND_CAPTURE(8)

💖 XYMOND_CAPTURE 💖

okay bestie, welcome to xymond_capture — it's a page from the System Manager's Manual (section 8, system admin girlies only) and it is, no cap, the little gremlin that catches messages off a xymond channel 🎀

✨ NAME ✨

xymond_capture — catch selected messages from a xymond channel 🦋

✨ SYNOPSIS ✨

xymond_channel --channel=status xymond_capture [options]

✨ DESCRIPTION ✨

So xymond_capture is a worker module for xymond, which means it does not run on its own like a main character — it's normally launched through the xymond_channel(8) program. That's its whole thing. It's a supporting role and it slays at it 💅

Here's the vibe: it gets messages from xymond over stdin, then filters them so you only keep the ones you actually care about — based on the hostname, the testname, or the color of the status. Vibe check passed ✅

By default, the messages that survive the filter get printed on stdout. But you can also pipe them into a command for further processing if you want to get fancy 🍓

Oh and it's flexible, periodt — xymond_capture supports the status, data, client and hostdata channels 🌈

✨ OPTIONS ✨

• --hosts=PATTERN — only let through messages from hosts matching PATTERN (regular expression). Selective queen behavior 👑
• --exhosts=PATTERN — kick out messages from hosts matching PATTERN. And if you use this one together with --hosts, then the hostname has to match the --hosts pattern but NOT the --exhosts pattern. Both conditions, no shortcuts 💅
• --tests=PATTERN — only let through messages from tests matching PATTERN (regular expression).
• --extests=PATTERN — exclude messages from tests matching PATTERN. Used with --tests, the testname must match the --tests pattern but NOT the --extests pattern. Same energy as the host pair 🫶
• --colors=COLOR[,color] — pick messages based on the color of the status message. You can list multiple colors, separated by commas. Default: accept all colors 🌈
• --batch-command=COMMAND — instead of printing messages to stdout, feed them to COMMAND on stdin. COMMAND can be literally any command that accepts the message on standard input. Go off, delegate 💖
• --batch-timeout=SECONDS — collect messages until no messages have arrived for SECONDS seconds, and only then send them off to the --batch-command COMMAND. Patience is a virtue bestie ⏳
• --client — grab data from the "client" channel instead of the default "status" channel. Plot twist ✨
• --debug — turn on debugging output. For when you need to know everything 🔍

✨ SEE ALSO ✨

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

fr fr, that's the whole page. Go filter something cute 🌸

okay that's a wrap, bestie — this was Xymon, Version 4.3.30: 4 Sep 2019, brought to you by the XYMOND_CAPTURE(8) girlies. mwah 💋💖