clfmerge(1) [debian man page]

clfmerge(1)							     logtools							       clfmerge(1)

NAME

       clfmerge - merge Common-Log Format web logs based on time-stamps

SYNOPSIS

       clfmerge [--help | -h] [-b size] [-d] [file names]

DESCRIPTION

       The  clfmerge program is designed to avoid using sort to merge multiple web log files.  Web logs for big sites consist of multiple files in
       the >100M size range from a number of machines.	For such files it is not practical to use a program such as gnusort  to  merge	the  files
       because	the  data is not always entirely in order (so the merge option of gnusort doesn't work so well), but it is not in random order (so
       doing a complete sort would be a waste).  Also the date field that is being sorted on is not particularly easy to specify  for  gnusort	(I
       have seen it done but it was messy).

       This  program is designed to simply and quickly sort multiple large log files with no need for temporary storage space or overly large buf-
       fers in memory (the memory footprint is generally only a few megs).

OVERVIEW

       It will take a number (from 0 to n) of file-names on the command line, it will open them for reading and read CLF format web log data  from
       them  all.   Lines  which don't appear to be in CLF format (NB they aren't parsed fully, only minimal parsing to determine the date is per-
       formed) will be rejected and displayed on standard-error.

       If zero files are specified then there will be no error, it will just silently output nothing, this is for scripts which use the find  com-
       mand to find log files and which can't be counted on to find any log files, it saves doing an extra check in your shell scripts.

       If  one file is specified then the data will be read into a 1000 line buffer and it will be removed from the buffer (and displayed on stan-
       dard output) in date order.  This is to handle the case of web servers which date entries on the connection time but write them to the  log
       at  completion  time  and  thus	generate  log files that aren't in order (Netscape web server does this - I haven't checked what other web
       servers do).

       If more than one file is specified then a line will be read from each file, the file that had the earliest time stamp  will  be	read  from
       until  it  returns  a time stamp later than one of the other files.  Then the file with the earlier time stamp will be read.  With multiple
       files the buffer size is 1000 lines or 100 * the number of files (whichever is larger).	When the buffer becomes full the first	line  will
       be removed and displayed on standard output.

OPTIONS

       -b buffer-size
	      Specify the buffer-size to use, if 0 is specified then it means to disable the sliding-window sorting of the data which improves the
	      speed.

       -d     Set domain-name mangling to on.  This means that if a line starts with as the name of the site that was requested then that would be
	      removed  from  the start of the line and the GET / would be changed to GET http://www.company.com/ which allows programs like Webal-
	      izer to produce good graphs for large hosting sites.  Also it will make the domain name in lower case.

EXIT STATUS

       0 No errors

       1 Bad parameters

       2 Can't open one of the specified files

       3 Can't write to output

AUTHOR

       This program, its manual page, and the Debian package were written by Russell Coker <russell@coker.com.au>.

SEE ALSO

       clfsplit(1),clfdomainsplit(1)

Russell Coker <;russell@coker.com.au>				       0.06							       clfmerge(1)

Check Out this Related Man Page

ncab2clf(1)							   User Commands						       ncab2clf(1)

NAME

       ncab2clf - convert binary log file to Common Log File format

SYNOPSIS

       /usr/bin/ncab2clf [-Dhv] [-i input-file] [-o output-file] [-b size] [-n number] [-s datetime]

DESCRIPTION

       The  ncab2clf command is used to convert the log file generated by the Solaris Network Cache and Accelerator ("NCA") from binary format, to
       Common Log File ("CLF") format. If no input-file is specified, ncab2clf uses stdin. If no output-file is specified, the output goes to std-
       out.

OPTIONS

       -b	       Specifies the binary-log-file blocking in kilobytes; the default is 64 Kbyte.

       -D	       Specifies that direct I/O be disabled.

       -h	       Prints usage message.

       -i input-file   Specifies the input file.

       -n number       Output number CLF records.

       -o output-file  Specifies the output file.

       -s datetime     Skip  any records before the date and time specified in datetime. You can specify the date and time in CLF format or in the
		       format specified by the touch(1) utility. CLF format is the dominant format, so ncab2clf first analyzes	datetime  assuming
		       CLF.

       -v	       Provides verbose output.

EXAMPLES

       Example 1: Converting a Binary File to a Common Log File Format

       The following example converts the binary file /var/nca/logs/nca.blf to a file /var/nca/logs/nca.clf, which is in Common Log File format.

       example% ncab2clf -D -i /var/nca/logs/nca.blf -o /var/nca/logs/nca.clf

       Example 2: Converting Multiple Log Files

       The following script may be used to convert multiple log files. The directory designated by "*" must only contain log files.

       !/bin/ksh
       for filename in *
       do
	   ncab2clf -D < $filename > $filename.clf
       done

       Example 3: Using -s and -n on a Raw Device

       The  following  example	shows  how ncab2clf can be used on a raw device. If not using the -n option, the default is to convert all records
       from the starting location to the end of the file. The date and time specified with -s, below, is in CLF format.

       example% ncab2clf -s '10/Apr/2001:09:23:13' -n 100 < /dev/dsk/c2t1d0s6

EXIT STATUS

       The following exit values are returned:

       0	       The file converted successfully

       >0	       An error occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWncau			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       nca(1), ncakmod(1), nca.if(4), ncakmod.conf(4), ncalogd.conf(4), attributes(5)

       System Administration Guide: IP Services

NOTES

       The binary log files generated by NCA can become very large. When converting these large binary files, use the -b option  to  the  ncab2clf
       command to help performance.

       Direct  I/O is a benefit to the user if the data being written does not come in as large chunks. However, if the user wishes to convert the
       log file in large chunks using the -b option, then direct I/O should be disabled by using the -D option.

SunOS 5.10							    28 Sep 2001 						       ncab2clf(1)

Linux and UNIX Man Pages

clfmerge(1) [debian man page]

Check Out this Related Man Page