We use cookies to ensure that we give you the best experience on our website.  Visit our Privacy Policy to learn more. If you continue to use this site, we will assume that you are okay with it.

Your choices regarding cookies on this site.
Your preferences have been updated.
In order for the changes to take effect completely please clear your browser cookies and cache. Then reload the page.

Werk #0016: Linux+Windows agent: allow spooling plugin outputs via files

ComponentChecks & Agents
TitleLinux+Windows agent: allow spooling plugin outputs via files
Date2013-12-04 12:16:45
Checkmk EditionCheckmk Raw Edition (CRE)
Checkmk Version1.2.3i7
LevelProminent Change
ClassNew Feature
CompatibilityCompatible - no manual interaction needed

The Windows and Linux agent now have a new feature for sending the contents of files as a part of the agent output. This is useful for generating monitoring data asychronously, e.g. by a cron job.

Simply let the job create or update a file in the directory /etc/check_mk/spool (Linux) or in the subdirection spool of the agent directory (Windows). If that directory is missing, simply create it. The agent will then add the contents of all files contained in that directory to its output. You can use any filename you like. Just files beginning with a dot are ignored. This is an easy way to have applications on the host drop monitoring data into Check_MK. Especially conveniant is using a local <<<local>>> section here.

If you prefix the file name with a number (e.g. 600MyOutput or 3600_app_data.txt) then that number is interpreted as a number of seconds. If the last modification of the file is older than that number, it will be ignored. This will usually set the corresponding services in the monitoring to UNKNOWN. That way you can make sure that you will be alarmed if no fresh monitoring data is available.

Here is an example for a spool file using a local section:

C:\Program Files\Check_MK\spool\600_foobar.txt
0 Service_FOO V=1 This Check is OK
1 Bar_Service - This is WARNING and has no performance data
2 NotGood V=120;50;100;0;1000 A critical check