SURVIVOR: History Files Specification
About History Records `alerthistory` `checkhistory` `commandhistory` `fixhistory`
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 (`/`): A human readable timestamp, in any local format. The time in seconds since the Unix Epoch. 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 timestamp When the alert was transmitted. alert return value The return value generated by the transmit module, as defined in the transmit module specification. check return value The return value from the check module that originated this alert, as defined in the check module specification. recipient addresses A comma separated list of addresses notified of this alert. module The alert stanza used, as defined in `calllist.cf`.
`checkhistory`
syntax |
     <timestamp>:<number>:<number>:<string>
### Fields timestamp When the check was executed. check return value The return value from the check module that was executed, as defined in the check module specification. scalar value The scalar value from the check module that was executed, as defined in the check module specification. comment The comment from the check module that was executed, as defined in the check module specification.
`commandhistory`
syntax |
     <timestamp>:<name>:<name>:<string>
### Fields timestamp When the command was executed. command What command was executed. who Who executed the command. comment Results of the command.
`fixhistory`
syntax |
     <timestamp>:<number>:0:<name>:<string>
### Fields timestamp When the fix was executed. fix return value The return value generated by the fix module, as defined in the fix module specification. who Who executed the fix. comment Results of the fix. $Date: 2006/11/20 00:07:34 $ $Revision: 0.6 $ | keywords