Find file History
#1 Compare This branch is 1023 commits behind pingdomserver:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
README
apache_analyzer.rb
apache_analyzer.yml
test.rb
utc.log

README

Apache Log Analyzer Plugin
======================
Created by [Scout](http://scoutapp.com)

Overview
------------

Provides statistics from an Apache access log: request distribution by hour, most popular URIs, traffic sorted by sum, and traffic sorted by mean. Just install this plugin in Scout and provide the full path to the Apache access log file. The plugin uses the [Request Log Analyzer gem](http://github.com/wvanbergen/request-log-analyzer/tree/master) to generate reports on Apache log every 24 hours. When first installed, it will generate the report immediately.

Note that the Apache Log Analyzer may take a couple of minutes to run on large log files.

Where to find your Apache access log
------------
The location of your Apache log file depends on your Apache configuration. In Ubuntu, the access log defaults to `/var/log/httpd/access_log`. Typically, you will configure a separate access log for each virtual host. Check in your virtual host config for a CustomLog directive.

Advanced: Specifying an Apache log format
------------
If you're not sure what your Apache log format is, it's probably the default [Common Log Format (CLF)](http://httpd.apache.org/docs/2.2/logs.html#accesslog) -- in which case you can safely skip this section.

By default, this plugin expects the Common Log Format. If you have specified a different format in your Apache configuration, you'll need to tell this plugin what format you're using. A format string looks something like `%h %l %u %t "%r" %>s %b`. Again, if you're not sure, just let the plugin run with the default settings.


Dependencies
------------

Requires:

[elif gem](http://elif.rubyforge.org/):

sudo gem install elif

[request-log-analyzer gem](http://github.com/wvanbergen/request-log-analyzer/tree/master)

sudo gem install request-log-analyzer

Compatibility
-------------

Tested on Linux, OSX, and Solaris. Requires the Scout Agent version 4.0 or greater.