APERCU(1)APERCU(1)NAMEapercu - Summarizes web traffic based on Apache log files
SYNOPSISapercu [--format=FORMAT] [--users=FILTER] [--hits=INTERVAL]
[--referrers=FILTER] [--resources=FILTER] [--time=PERIOD]
[--lookup-ips] [--sort-by-name] [--quiet] [--verbose=LEVEL]
[--version | -v] [logfile]
DESCRIPTIONapercu is an application that extracts information from Apache log
files and summarizes it, showing activities and profiles of individuals
(users), numbers of requests and referrers, and hit counts over time.
By default, apercu displays, in order, users, hit counts, referrers,
and resources.
OPTIONS
--format=FORMAT
The format of the log file. The default is:
%h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-agent}i"
--users=FILTER
Display user history. The optional filter narrows the users dis‐
played to only those with matching IP addresses. Regular expres‐
sion escape sequences can be used.
--hits=INTERVAL
Display hit counts, using the given time interval, which by de‐
fault is "hour". Other valid intervals are "year", "mon", "day",
"hour", "min", and "sec".
--referrers=FILTER
Display referrers, optionally showing only those matching the
filter, which is a regular expression.
--resources=FILTER
Display resources, optionally showing only those matching the
filter, a regular expression.
--time=FILTER
Display hits by time, the optional filter narrows the hits to
the given time, in the format DD/MMM/YYYY: HH:MM:SS (or whatever
matches the format in the log file). Regular expression escape
sequences can also be used.
Time filter aliases exist: "today", "yesterday", "thisweek",
"thismonth", and "thisyear". Unless the interval has been ex‐
plicitly set (via --hits, these result in the interval being set
to "hour", "hour", "day", "day", and "mon", respectively.
--lookup-ips
Display IP names instead of addresses, when used with the
--users option. This adds significant processing time.
--sort-by-name
Sort resources and referrers by name instead of by count.
--quiet
Run with minimal output.
--verbose=LEVEL
Run with debugging output.
--version -v
Display the version and exit.
logfile
The log file to process. If not specified, standard input is
used as input.
EXAMPLES
To view the hit counts for January 2006:
% apercu --time=\d+/Jan/2006 --hits /var/log/apache2/access_log
To view the user profiles and activity for today, showing IP addresses:
% apercu --time=today --users --lookup-ips /var/log/apache2/ac‐
cess_log
To view RPM resources for this month:
% apercu --time=thismonth --resources='GET.*\.rpm.*'
/var/log/apache2/access_log
To view Google Spain referrers this month:
% apercu --time=thismonth --referrers='http://www.google.es\S*'
/var/log/apache2/access_log
CONFIGURATION
$HOME/.apercu
The run-control (configuration) file, of the form:
format: %h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-agent}i
lookup-ips: true
sort-by-name: true
quiet: true
The given parameters match the --format, --lookup-ips, --sort-by-name,
and --quiet options.
AUTHOR
Jeff Pace <jpace@incava.org>.
The Apercu web site is at http://www.incava.org/projects/apercu.
BUGS
Bugs and issues should be emailed to the author: Jeff Pace <jpace@inca‐
va.org>
COPYRIGHT
Copyright (c) 2006, Jeff Pace.
All Rights Reserved. This module is free software. It may be used, re‐
distributed and/or modified under the terms of the Apache License:
http://www.apache.org/licenses/LICENSE-2.0
APERCU(1)
