X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Flog.texi;fp=doc%2Flog.texi;h=3c91f61454e2fb3b96756f5ce8996c052b649149;hb=ff2139ccf41d72a3c1c4b56c2106effd1ef2e841;hp=9bcff527b69f3a25612fed12449cd5332283b72f;hpb=561313b1994a8fadac5152bbdc7a980881fd93e0;p=nncp.git diff --git a/doc/log.texi b/doc/log.texi index 9bcff52..3c91f61 100644 --- a/doc/log.texi +++ b/doc/log.texi @@ -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.