wvanbergen / request-log-analyzer
watch download tarball
public
Forks19Right
Watchers513Right
Description: A command line tool that analyzes request logfiles (e.g. Rails, Merb, Apache) to produce a performance report.
Homepage: http://www.railsdoctors.com
Clone URL: git://github.com/wvanbergen/request-log-analyzer.git
README.textile

Request log analyzer

This is a simple command line tool to analyze request log files of both Rails and
Merb. Its purpose is to find what actions are best candidates for optimization.

  • Analyzes Rails log files (all versions)
  • Can combine multiple files (handy if you are using logrotate)
  • Uses several metrics, including cumulative request time, average request time, process blockers, database and rendering time, HTTP methods and states, Rails action cache statistics, etc.) (Sample output)
  • Low memory footprint (server-safe)
  • MIT licensed
  • Fast

Additional information

Installation

sudo gem install wvanbergen-request-log-analyzer --source http://gems.github.com

Usage

  Usage: request-log-analyzer [LOGFILES*] <OPTIONS>

  Input options:
    --format <format>, -f:     Uses the specified log file format. Defaults to rails.
    --after <date>             Only consider requests from <date> or later.
    --before <date>            Only consider requests before <date>.
    --select <field> <value>   Only consider requests where <field> matches <value>.
    --reject <field> <value>   Only consider requests where <field> does not match <value>.

  Output options:
    --boring, -b               Output reports without ASCII colors.
    --database <filename>, -d: Creates an SQLite3 database of all the parsed request information.
    --debug                    Print debug information while parsing.
    --file <filename>          Output to file.

  Examples:
    request-log-analyzer development.log
    request-log-analyzer mongrel.0.log mongrel.1.log mongrel.2.log 
    request-log-analyzer --format merb -d requests.db production.log

  To install rake tasks in your Rails application, 
  run the following command in your application's root directory:

    request-log-analyzer install rails