]> Cypherpunks.ru repositories - nncp.git/blobdiff - doc/log.texi
recfile log format
[nncp.git] / doc / log.texi
index 9bcff527b69f3a25612fed12449cd5332283b72f..3c91f61454e2fb3b96756f5ce8996c052b649149 100644 (file)
@@ -1,35 +1,8 @@
 @node Log
 @unnumbered Log format
 
-Log is a plaintext file with single log entry per line. Lines are "\n"
-separated. It is not intended to be read by human -- use @ref{nncp-log}
-utility.
-
-Each line has the following format:
-
-@verbatim
-LEVEL | DATETIME | SD | MSG
-@end verbatim
-
-Example log records:
-
-@verbatim
-I 2017-01-09T08:41:54.751732131Z [nncp-xfer node="VHMTRWDOXPLK7BR55ICZ5N32ZJUMRKZEMFNGGCEAXV66GG43PEBQ" pkt="KMG6FO5UNEK7HWVFJPWQYC7MOZ76KEZ4FWCGM62PWA2QE5755NPA" size="4162548" xx="tx"]
-I 2017-01-09T08:42:18.990005394Z [sp-infos node="BYRRQUULEHINPKEFN7CHMSHR5I5CK7PMX5HQNCYERTBAR4BOCG6Q" pkts="0" size="0" xx="tx"]
-I 2017-01-09T08:48:59.264847401Z [call-finish duration="10" node="BYRRQUULEHINPKEFN7CHMSHR5I5CK7PMX5HQNCYERTBAR4BOCG6Q" rxbytes="60" rxspeed="60" txbytes="108" txspeed="108"]
-@end verbatim
-
-@table @emph
-@item |
-    Space character.
-@item LEVEL
-    Is single character log level. As a rule is is either @verb{|I|}
-    (informational message), or @verb{|E|} (error message).
-@item DATETIME
-    UTC datetime in @url{https://tools.ietf.org/html/rfc339, RFC 3339}
-    @verb{|2006-01-02T15:04:05.999999999Z|} format.
-@item SD
-    Structured data as in @url{https://tools.ietf.org/html/rfc5424, RFC 5424}.
-@item MSG
-    Arbitrary UTF-8 encoded text data.
-@end table
+Log is a plaintext file consisting of
+@url{https://www.gnu.org/software/recutils/, recfile} records. It can be
+read by human, but it is better to use either @ref{nncp-log}, or
+@command{recutils} utilities for selecting and formatting the required
+fields.