Monitor Plugin Specifications Version 0.01

Inro

A Monitor Plugin is any executable program that returns a report on the status of a specific thing. The Monitor Plugin should return a report via standard output in the format below.

Note that a single monitor may not produce multiple BEGIN - DONE blocks. 0.01 allowed this. 0.02 does not. It confuses the dmonitor logic.

Report Format

The report consists of these sections:

BEGIN #

Marks the start of the report. # is the format 
version of the report.

URGENCY #

Reports on the "urgency" or the situation. # is
a number from 1 to 8

LOG_EMERG - 8
       system is unusable

LOG_ALERT - 7
       action must be taken immediately

LOG_CRIT - 6
      critical conditions

LOG_ERR - 5
     error conditions

LOG_WARNING - 4
         warning conditions

LOG_NOTICE - 3
        normal, but significant, condition

LOG_INFO - 2
      informational message

LOG_DEBUG - 1
       debug-level message


REPORT

Marks the start of the diagnostic text. 

Between REPORT and DONE should be filled
with diagnostic text. The text can be
any ASCII text. All formatting will be
preserved.

DONE

Marks the end of the report.

Example Reports:

BEGIN
URGENCY 8
REPORT
/dev/hda1 just failed. 
DONE

BEGIN 
URGENCY 2
REPORT
CPU temperature 30 degrees.
DONE 
Index
© 1999 Peter Todd
Created on 09/12/1999 Last update - $Id: monitor.html,v 4.0 1999/10/07 22:57:36 pete Exp $