SURVIVOR: History Files Specification
About History Records
syntax
  • Entries consists of one line of data, terminated with a newline (\n).
  • boldface denotes keywords.
  <name> : [a-zA-Z0-9\.+%@_-]+
  <names> : [a-zA-Z0-9,\.+%@_-]+
  <number> : [0-9]+
  <string> : [^\n]*
  <timestamp> : [^/\n]+/<number>[/<number>]
  

All history records consist of a timestamp followed by the record data. The timestamp generally indicates the time the record was cut, which may not exactly correspond to the initiation or completion of the event described by the record, but will generally be reasonably close.

The timestamp of a history record consists of the following parts, each separated by a slash (/):

  1. A human readable timestamp, in any local format.
  2. The time in seconds since the Unix Epoch.
  3. An optional duration, in milliseconds. (ie: the amount of time the event described by the record took to complete.)

History record formats are subject to change between releases. Use of programmatic methods to access history (such as via the command interface) is recommended.

alerthistory
syntax

 <timestamp>:<number>:<number>:<names> via <name>
 

Fields

  1. timestamp
    When the alert was transmitted.

  2. alert return value
    The return value generated by the transmit module, as defined in the transmit module specification.

  3. check return value
    The return value from the check module that originated this alert, as defined in the check module specification.

  4. recipient addresses
    A comma separated list of addresses notified of this alert.

  5. module
    The alert stanza used, as defined in calllist.cf.

checkhistory
syntax

 <timestamp>:<number>:<number>:<string>
 

Fields

  1. timestamp
    When the check was executed.

  2. check return value
    The return value from the check module that was executed, as defined in the check module specification.

  3. scalar value
    The scalar value from the check module that was executed, as defined in the check module specification.

  4. comment
    The comment from the check module that was executed, as defined in the check module specification.

commandhistory
syntax

 <timestamp>:<name>:<name>:<string>
 

Fields

  1. timestamp
    When the command was executed.

  2. command
    What command was executed.

  3. who
    Who executed the command.

  4. comment
    Results of the command.

fixhistory
syntax

 <timestamp>:<number>:0:<name>:<string>
 

Fields

  1. timestamp
    When the fix was executed.

  2. fix return value
    The return value generated by the fix module, as defined in the fix module specification.

  3. who
    Who executed the fix.

  4. comment
    Results of the fix.


$Date: 2006/11/20 00:07:34 $
$Revision: 0.6 $
keywords