welf2dlf(1) [debian man page]
WELF2DLF.IN(1) LogReport's Lire Documentation WELF2DLF.IN(1) NAME
welf2dlf - convert firewall logs in WebTrends Enhanced Log Format to DLF SYNOPSIS
welf2dlf file DESCRIPTION
welf2dlf converts firewall logs in the WebTrends Enhanced Log Format into the firewall DLF. That format is defined at the following URL: http://www.netiq.com/partners/technology/welf.asp This converter also supports the SonicWall extensions. A list of firewall products that supports that format can be found at the following URL: http://www.netiq.com/products/fwr/compatible.asp IMPLEMENTATION NOTES
Since the firewall DLF only supports packet filters, not all records will be mapped to DLF. Dropped packets messages (those with a field msg="XXX packet dropped") will be mapped to denied DLF packet. (As well as all msg="TCP connection dropped" records). Those packets will have a length of 0 (that's a limitation of the format which don't log that information on dropped packet). Messages with a proto= field set will be interpretted as "permitted" "packet". That's not exactly "right" because this message really represent a "packets flow" and not a single packet. Other records will be ignored. You may use the welf_proxy service in the proxy superservice to extract proxy level information from WELF logs. EXAMPLES
To process a log as produced by WebTrends: $ welf2dlf < welf.log welf2dlf will be rarely used on its own, but is more likely called by lr_log2report: $ lr_log2report welf < /var/log/welf.log THANKS
Mark D. Nagel, for giving feedback and supplying patches. SEE ALSO
Lire::WELF(3) welf_proxy2dlf(1) AUTHORS
Francis J. Lacoste <flacoste@logreport.org> VERSION
$Id: welf2dlf.in,v 1.14 2006/07/23 13:16:35 vanbaal Exp $ COPYRIGHT
Copyright (C) 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. Lire 2.1.1 2006-07-23 WELF2DLF.IN(1)
Check Out this Related Man Page
WELF(3pm) LogReport's Lire Documentation WELF(3pm) NAME
Lire::WELF - Base implementation of a WebTrends(tm) Enhanced Log Format parser SYNOPSIS
use Lire::WELF; my $parser = new Lire::WELF; my $welf_rec = $parser->parse( $line ); DESCRIPTION
This module defines an object able to parse WebTrends(tm) Enhanced Log Format. That log format was defined by WebTrends(tm) for its Firewall Suite. It defines an extensible format that is now used by several packet filter and/or proxy firewall. The document describing that format is available from http://www.webtrends.com/partners/welfOverview.htm A list of products/vendor that supports this format can be found at http://www.webtrends.com/partners/firewall.htm You create a WELF parser object using the new() method: my $parser = new Lire::WELF(); To parse a WELF record you invoke the parser() method with the line containing the record as parameter: my $rec = $parser->parse( $line ); The $rec is an hash reference with the WELF field name used as keys and the value of the records as values. No value are interpreted or checked in any except for the following: time The time field will be converted to epoch time quotation The quotation marks used when the value contains spaces are removed. WELF EXTENSIONS The parser also supports "extensions" to the format found in the field. port We will interpret correctly src and dst fields that have the port embededded in them: src=192.168.1.1:1037 interface A possible :IFNAME will also be interpreted as the interface name: dst=192.168.100.10:23:WAN timezone The time field may contains a time zone identifier: time="2001-12-02 12:34:12 UTC" Derived Fields The parser will generate a few 'derived' to complete the format. src_port Will contain the src port portion of the dst field when SonicWall extensions are used. dst_port Will contain the interface portion of the dst field when SonicWall extensions are used. src_if Will contain the interface portion of the src field when SonicWall extensions are used. dst_if Will contain the interface portion of the dst field when SonicWall extensions are used. AUTHOR
Francis J. Lacoste <flacoste@logreport.org> VERSION
$Id: WELF.pm,v 1.11 2006/07/23 13:16:30 vanbaal Exp $ COPYRIGHT
Copyright (C) 2001 Stichting LogReport Foundation LogReport@LogReport.org This file 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-07-23 WELF(3pm)