wvanbergen / request-log-analyzer fork watch download tarball
public
Rubygem
Forks10Right
Watchers218Right
Description: A command line tool that analyzes request logfiles (e.g. Rails, Merb) to produce a performance report.
Homepage: http://wiki.github.com/wvanbergen/request-log-analyzer
Clone URL: git://github.com/wvanbergen/request-log-analyzer.git
Click here to lend your support to: request-log-analyzer and make a donation at www.pledgie.com !
name age
history
message
file .gitignore Fri Jun 12 04:09:02 -0700 2009 Added rcov and added specs [barttenbrinke]
file DESIGN.rdoc Wed Jun 24 10:52:06 -0700 2009 Cleaned up design file [barttenbrinke]
file LICENSE Thu Aug 14 11:16:37 -0700 2008 Added MIT License [barttenbrinke]
file README.rdoc Mon Jun 22 11:34:49 -0700 2009 Small README adjustments [wvanbergen]
file RELEASE_NOTES.rdoc Mon Jun 22 13:09:46 -0700 2009 Fixed rails rake tasks [barttenbrinke]
file Rakefile Fri Jun 12 04:09:02 -0700 2009 Added rcov and added specs [barttenbrinke]
directory bin/ Mon Jun 22 12:26:39 -0700 2009 Implemented basic dumping of results to YAML us... [wvanbergen]
directory lib/ Mon Jun 22 13:32:19 -0700 2009 Merge branch 'master' of git@github.com:wvanber... [wvanbergen]
file request-log-analyzer.gemspec Mon Jun 22 13:09:46 -0700 2009 Fixed rails rake tasks [barttenbrinke]
directory spec/ Mon Jun 22 13:40:57 -0700 2009 Fixed tmp folder location [wvanbergen]
directory tasks/ Mon Jun 22 13:11:24 -0700 2009 Cleaned up rake task [barttenbrinke]

Request-log-analyzer

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

  • Analyzes Rails log files (all versions), Merb logs, or any other log format you specify
  • Combines multiple files and decompresses compressed 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 statuses, Rails action cache statistics, etc.) (Sample output: wiki.github.com/wvanbergen/request-log-analyzer/sample-output)
  • Low memory footprint and reasonably fast (server-safe)
  • MIT licensed

Request log analyzer was designed and built by Willem van Bergen and Bart ten Brinke.

Installation

Install request-log-analyzer as a Ruby gem: 

  $ sudo gem install request-log-analyzer

Alternatively, use the gem from the GitHub gem server: 

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

To get the best results out of request-log-analyzer, make sure to set up logging correctly: wiki.github.com/wvanbergen/request-log-analyzer/configure-logging for your application.

Usage

To analyze a log file and produce a performance report, run request-log-analyzer like this: 

  $ request-log-analyzer log/production.log

For more details and available command line options, see the project’s wiki: wiki.github.com/wvanbergen/request-log-analyzer/basic-usage

Additional information

Do you have a rails application that is not performing as it should? If you need an expert to analyze your application, feel free to contact either Willem van Bergen (willem@vanbergen.org) or Bart ten Brinke (info@retrosync.com).