Hi Adam,
On 1/3/26 4:42 AM, Adam Thorn via Xymon wrote:
There's not really any difference between server-side and client-side plugins: if you know how to write the latter, you're nearly there with the former!
Cool!
One source of examples is the debian "hobbit-plugins" package, and specifically the ..../server/ext dir:
Okay.
https://salsa.debian.org/debian/hobbit-plugins/-/tree/master/src/usr/ lib/xymon/server/ext?ref_type=heads
Thank you for that link as it makes such research very convenient. :-)
The xymongrep command can be used to parse your hosts.cfg file and extract a list of tagged hosts that you want to run your test against:
https://xymon.sourceforge.io/xymon/help/manpages/man1/xymongrep.1.html
I'm aware of xymongrep and I think I understand it's intended use case.
Implement whatever test you want, and then just make sure to set the "hostname" parameter in the message sent to xymon. You'll see lines like
my $bb = new Hobbit( { test => 'tftp', hostname => $destination } );
That looks like it's instantiating $bb as a new Hobbit object with some parameters. Standard Perl methodology.
in the examples.
I will.
To run the script on your xymon server, drop a cfg file in /etc/xymon/ tasks.d/ which is just like the config files you'd put in /etc/xymon/ clientlaunch.d/ for a client-side script. So far I've added stanzas to the singular clientlauch.config (from memory) file. But I can see how those could go in separate files in a directory therefor.
If memory serves, the extensions run their test and output results that get added to the client log that's sent to the Xymon server. The Xymon server then parses them as necessary.
I'm sending a few clear alerts with values (encoded in the way / with the tags that Xymon wants) so that the server can key on the values and standard alerting rules to alter the color. One mail server might alert on 10 messages in the mail queue while another might alert on 250 messages in the mail queue.
I think the most germane thing from the SMTP+STARTTLS or IMAP+STARTTLS or POP3+STARTTLS perspective is passing TLS certificate information to Xymon so that germane details show up on the sslcert page.
I'll definitely be doing some digging as time permits.
Thank you Adam!
-- Grant. . . .