doc/log.texi

   1 @node Log
   2 @unnumbered Log format
   3
   4 Log is a plaintext file with single log entry per line. Lines are "\n"
   5 separated. It is not intended to be read by human -- use @ref{nncp-log}
   6 utility.
   7
   8 Each line has the following format:
   9
  10 @verbatim
  11 LEVEL | DATETIME | SD | MSG
  12 @end verbatim
  13
  14 Example log records:
  15
  16 @verbatim
  17 I 2017-01-09T08:41:54.751732131Z [nncp-xfer node="VHMTRWDOXPLK7BR55ICZ5N32ZJUMRKZEMFNGGCEAXV66GG43PEBQ" pkt="KMG6FO5UNEK7HWVFJPWQYC7MOZ76KEZ4FWCGM62PWA2QE5755NPA" size="4162548" xx="tx"]
  18 I 2017-01-09T08:42:18.990005394Z [sp-infos node="BYRRQUULEHINPKEFN7CHMSHR5I5CK7PMX5HQNCYERTBAR4BOCG6Q" pkts="0" size="0" xx="tx"]
  19 I 2017-01-09T08:48:59.264847401Z [call-finish duration="10" node="BYRRQUULEHINPKEFN7CHMSHR5I5CK7PMX5HQNCYERTBAR4BOCG6Q" rxbytes="60" rxspeed="60" txbytes="108" txspeed="108"]
  20 @end verbatim
  21
  22 @table @emph
  23 @item |
  24     Space character.
  25 @item LEVEL
  26     Is single character log level. As a rule is is either @verb{|I|}
  27     (informational message), or @verb{|E|} (error message).
  28 @item DATETIME
  29     UTC datetime in @url{https://tools.ietf.org/html/rfc339, RFC 3339}
  30     @verb{|2006-01-02T15:04:05.999999999Z|} format.
  31 @item SD
  32     Structured data as in @url{https://tools.ietf.org/html/rfc5424, RFC 5424}.
  33 @item MSG
  34     Arbitrary UTF-8 encoded text data.
  35 @end table