wvanbergen / request-log-analyzer
watch download tarball
public
Forks23Right
Watchers527Right
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
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 Oct 01 00:17:35 -0700 2009 Added 2009 to the LICENSE copyright notice [wvanbergen]
file README.rdoc Sat Oct 03 01:39:18 -0700 2009 Updated README [wvanbergen]
file Rakefile Sat Sep 05 10:40:24 -0700 2009 Added some comments to Rakefile [wvanbergen]
directory bin/ Mon Dec 14 06:53:48 -0800 2009 Updated documentation and fixed failing specs [barttenbrinke]
directory lib/ Mon Dec 21 11:08:50 -0800 2009 Variable name type fix [wvanbergen]
file request-log-analyzer.gemspec Thu Dec 17 13:26:42 -0800 2009 Released request-log-analyzer gem version 1.5.4 [wvanbergen]
directory spec/ Tue Dec 15 20:28:58 -0800 2009 Improved Delayed::Job file format and additiona... [wvanbergen]
directory tasks/ Sun Dec 20 07:15:45 -0800 2009 Updated to latest gem release management tasks. [wvanbergen]
README.rdoc

Request-log-analyzer

This is a simple command line tool to analyze request log files in various formats to produce a performance report. Its purpose is to find what actions are best candidates for optimization.

  • Analyzes Rails request logs, Merb request logs, Apache access logs and more, or parses any other log format you specify.
  • Combines multiple files and decompresses compressed files, which comes in handy if you are using logrotate.
  • Uses several metrics, including cumulative request time, mean 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, so it is safe to run on a production server.
  • MIT licensed

See the project wiki at wiki.github.com/wvanbergen/request-log-analyzer for documentation and additional information.

Installation & basic usage

Install request-log-analyzer as a Ruby gem (you might need to run this command as root by prepending sudo to it): 

  $ gem install request-log-analyzer

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

  $ request-log-analyzer log/production.log

For more details, other file formats, and available command line options, see the project’s wiki at wiki.github.com/wvanbergen/request-log-analyzer

Additional information

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

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@railsdoctors.com) or Bart ten Brinke (bart@railsdoctors.com).