.werks/16

   1 Title: Linux+Windows agent: allow spooling plugin outputs via files
   2 Level: 2
   3 Component: checks
   4 Version: 1.2.3i7
   5 Date: 1386155805
   6 Class: feature
   7
   8 The Windows and Linux agent now have a new feature for sending the contents of
   9 files as a part of the agent output. This is useful for generating monitoring
  10 data asychronously, e.g. by a cron job.
  11
  12 Simply let the job create or update a file in the directory
  13 <tt>/etc/check_mk/spool</tt> (Linux) or in the subdirection <tt>spool</tt>
  14 of the agent directory (Windows). If that directory is missing, simply
  15 create it. The agent will then add the contents of all files contained in
  16 that directory to its output.  You can use any filename you like. Just files
  17 beginning with a dot are ignored.  This is an easy way to have applications
  18 on the host drop monitoring data into Check_MK. Especially conveniant is
  19 using a local <tt>&lt;&lt;&lt;local&gt;&gt;&gt;</tt> section here.
  20
  21 If you prefix the file name with a number (e.g. <tt>600MyOutput</tt>
  22 or <tt>3600_app_data.txt</tt>) then that number is interpreted as a
  23 number of seconds. If the last modification of the file is older than
  24 that number, it will be ignored. This will usually set the corresponding
  25 services in the monitoring to <b>UNKNOWN</b>. That way you can make sure
  26 that you will be alarmed if no fresh monitoring data is available.
  27
  28 Here is an example for a spool file using a [localchecks|<tt>local</tt>] section:
  29
  30 F+:C:\Program Files\Check_MK\spool\600_foobar.txt
  31 <<<local>>>
  32 0 Service_FOO V=1 This Check is OK
  33 1 Bar_Service - This is WARNING and has no performance data
  34 2 NotGood V=120;50;100;0;1000 A critical check
  35 F-: