Metadata-Version: 1.0
Name: TinyLogAnalyzer
Version: 0.1.0
Summary: Simple bash utility for analyse HTTP access log with enabled response time
Home-page: https://kpython-utils.svn.sourceforge.net/svnroot/kpython-utils/TinyLogAnalyzer/
Author: keul
Author-email: luca@keul.it
License: GPL
Description: .. contents:: **Table of contents**
        
        Tiny Log Analizer
        =================
        
        This project adds to your system a new utility command: ``tinylogan``. This utility only works with
        Apache-like access HTTP log where the response time data is enabled.
        
        To know how to do this, see `this blog post`__ or, in brief change the configuration of your log format
        from something like::
        
            LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
        
        To this::
        
            LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %T/%D" combined
        
        The log record will change to something like this::
        
            [31/Jan/2008:14:19:07 +0000] "GET / HTTP/1.1" 200 7918 ""
            ... "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.1.11) Gecko/20061201 Firefox/2.0.0.11 (Ubuntu-feisty)" 0/95491
        
        __ http://www.ducea.com/2008/02/06/apache-logs-how-long-does-it-take-to-serve-a-request/ 
        
        Seconds and microsends
        ----------------------
        
        The utility only cares about microsends (`%D`) so you need to have Apache 2.
        
        How to use
        ==========
        
        Here the complete guide::
        
            Usage: tinylogan [options] logfile
            
            Simple bash utility for analyse HTTP access log with enabled response time
            
            Options:
              --version             show program's version number and exit
              -h, --help            show this help message and exit
              -s SIZE, --size=SIZE  choose the number of record to store in every log
              -i INCLUDE_REGEX, --include=INCLUDE_REGEX
                                    a regexp expression that all URLs must match of will
                                    be discarded. Can be called multiple times
              -e EXCLUDE_REGEX, --exclude=EXCLUDE_REGEX
                                    a regexp expression that all URLs must not match of
                                    will be discarded. Can be called multiple times
              --skip-timeperiod-start=SKIP_TIME_START
                                    do not analyse after the given time
              --skip-timeperiod-end=SKIP_TIME_END
                                    do not analyse before the given time
            
              Date filters:
                For those kind of filters you need to specify a date. You are free to
                use a specific date in the format dd/mmm/aaaa, like "24/May/2011", but
                also some keyword for relative date like "today", "yesterday",
                "tomorrow".
            
                --start-date=START_DATE
                                    date where to start analyze and record
                --end-date=END_DATE
                                    date where to end analyze and record
            
              Time filters:
                When a time is needed, you must enter it in the format hh:mm:ss or
                simply hh:mm, like "09:21:30" or "09:21". Those filter are used for
                skip record that are registered "too late at night" or "too early in
                the morning".
        
        
        Changelog
        =========
        
        0.1.0 (2011-04-27)
        ------------------
        
        * Initial release
        
Keywords: file apache log analyser http access
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Utilities
Classifier: Topic :: Internet :: Log Analysis
Classifier: Topic :: Internet :: WWW/HTTP
