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
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 Jul 13 14:59:27 -0700 2009 Added links to Railsdoctors.com [barttenbrinke]
file Rakefile Wed Sep 02 03:56:26 -0700 2009 New gem release scripts using more robust git gem [wvanbergen]
directory bin/ Mon Jul 13 14:59:27 -0700 2009 Added links to Railsdoctors.com [barttenbrinke]
directory lib/ Wed Sep 02 04:18:25 -0700 2009 Released request-log-analyzer gem version 1.2.6 [wvanbergen]
file request-log-analyzer.gemspec Loading commit data...
directory spec/ Tue Sep 01 23:47:13 -0700 2009 Added specs for database inserter's ORM module ... [wvanbergen]
directory tasks/
README.rdoc

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