qmail2dlf(1) [debian man page]
QMAIL2DLF.IN(1) LogReport's Lire Documentation QMAIL2DLF.IN(1) NAME
qmail2dlf - convert sanitized qmail-send logs to dlf SYNOPSIS
qmail2ldf DESCRIPTION
qmail2dlf reads qmail-send logs from stdin, writes dlf to stdout, and, in case of errors, complains on stderr. TIMESTAMPS
We expect timestamps which look like e.g. `977359048.466280500' in our log: number of seconds since the epoch, in any precision. The log should feature lines which look something like: 982584201.511524 info msg 6426: bytes 3537 from <qmail-return-63074-joostvb=mdcc.cx@list.cr.yp.to> qp 21089 uid 70 splogger, as distributed with qmail, writes `a numerical timestamp', ie something like 972802273.627578, indicating seconds and nanoseconds since the beginning of 1970. multilog, as distributed with daemontools, http://cr.yp.to/daemontools.html, if invoked with action t, writes a `@' and a tai64n format timestamp. These timestamps look like e.g. 4000000039ef8532346bb35c. Note that 0x400000000000000000000000 is 2^62. One can get the current time in tai64 format by doing: echo 40000000`(echo obase = 16; date +%s) | bc`00000000 (assuming GNU date is installed) To convert tai64n to numerical timestamps, one can use Russ Allbery's tai64nfraq. It's in the public domain, available from http://www.qmail.org/tai64nfrac. EXAMPLE
To process a log as produced by splogger: $ lr_desyslog qmail < mail.log | qmail2dlf To process a log as produced by multilog: $ tai64nfrac < current | qmail2dlf qmail2dlf(1) will be rarely used on its own, but is more likely called by lr_log2report: $ tai64nfrac < /service/qmail-send/log/main/current | lr_log2report qmail BUGS
We don't deal with bounces: email qmail none qmail2dlf info skipping line '986244190.800217 bounce msg 6306 qp 28445': first field should be one of 'new', 'info', 'starting', 'delivery', 'end' or 'status:', not 'bounce' qmail2dlf doesn't use any information from the qmail-smtpd(1) logs. (These look like 2002-06-16 09:34:57.798038500 tcpserver: pid 19385 from 100.61.24.7 2002-06-16 09:34:58.114198500 tcpserver: ok 19385 foo.example.com:100.163.25.11:25 logreport.iae.nl:212.61.24.7:postfix:1189 .) VERSION
$Id: qmail2dlf.in,v 1.24 2006/07/23 13:16:34 vanbaal Exp $ COPYRIGHT
Copyright (C) 2000, 2001 Stichting LogReport Foundation LogReport@LogReport.org This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html. AUTHOR
Joost van Baal <joostvb@logreport.org> Lire 2.1.1 2006-07-23 QMAIL2DLF.IN(1)
Check Out this Related Man Page
LR_LOG2REPORT.IN(1) LogReport's Lire Documentation LR_LOG2REPORT.IN(1) NAME
lr_log2report - generates a report from a log file SYNOPSIS
lr_log2report [options] dlf_converter [ logfile ] [ output_file ] lr_log2report --version lr_log2report --help [dlf-converters|output-formats|report-templates] OPTIONS
--help [section] If no argument is given, prints usage information and exits. Argument can be one of the following: dlf-converters Prints the list of available DLF converters and exits. output-formats Prints the list of available output formats and exits. report-templates Prints the list of available report templates and exits. --version Prints Lire's version and exits. --output-format|-o output format Selects the ouput format in which to generate the report. --template|-t name Uses the report configuration named name to generate the report. DESCRIPTION
lr_log2report reads a log file from STDIN or the specified argument and will output a formatted Lire report on STDOUT or in the output_file argument. The format of the log file is specified using the dlf_converter argument. Use the --help dlf-converters option to get a list of all currently available DLF converters. In case the log is passed in a compressed format, it's uncompressed on the fly, using gzip(1). WARNING: This command outputs binary data on the terminal for all output formats except txt and xml. You should redirect stdout to a file when using those output formats. In the case where output format is html, the output_file argument will be interpreted as a directory name. This directory will get created if needed, and will hold the various html files. In case this argument is omitted, a tar(1) file should be output on STDOUT (but see the BUGS section). WARNING: Running this command on big logfiles generally means you'll need lots of free diskspace. See Lire::LrCommand(3pm) for details. EXAMPLES
To process a Postfix log and display the report as text, use $ lr_log2report postfix /var/log/mail.log To process a Postfix log and create an HTML report in a directory, use $ lr_log2report -o html postfix /var/log/mail.log postfix-report BUGS
If --output html is specified, both logfile and output_file need to be specified. Specifying "-" (or "/dev/stdin") as logfile is supported. So this $ tai64nfrac < /var/log/qmail-send/current | lr_log2report qmail --output html - /tmp/report will work. SEE ALSO
lr_log2mail(1), lr_xml2report(1), lr_xml2mail(1), lire(1), lire(7), Lire::LrCommand(3pm), documentation in the Lire User Manual AUTHORS
Joost van Baal <joostvb@logreport.org> Francis J. Lacoste <flacoste@logreport.org> VERSION
$Id: lr_log2report.in,v 1.100 2006/10/04 10:19:17 vanbaal Exp $ COPYRIGHT
Copyright (C) 2000-2004 Stichting LogReport Foundation LogReport@LogReport.org This program is part of Lire. Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html. Lire 2.1.1 2006-10-04 LR_LOG2REPORT.IN(1)