 |
|
| |
| Introduction
| |
Analog
is one of the oldest and fastest web-log analyzers. It reads your Apache access log and produces a
single, self-contained HTML report — tables and small bar charts showing how many requests your
site served, which pages were most popular, where visitors came from, which browsers and search terms
they used, and which requests returned errors.
Analog is far less interactive than a modern dashboard and less detailed than some alternatives, but
it is extremely lightweight: it processes very large logs quickly and with minimal memory, which makes
it a good fit for a small VPS. It has been a dependable staple of Unix web hosting for decades. If you
would prefer a live, interactive dashboard, GoAccess is the modern choice; for monthly summaries,
AWStats is popular — both are mentioned on the
Web Server Logs page.
| |
| Installation
| |
On FreeBSD 15, Analog is packaged —
connect to your VPS, become root,
and install it:
# pkg install analog
|
On Rocky Linux 10: Analog is a very old program and is not carried in
the standard Rocky/EPEL repositories. You can still build it from source (see
Installing Software),
but most Rocky users choose a packaged equivalent instead — dnf install webalizer
gives you the same kind of lightweight, single-config-file, static-HTML report. The
configuration ideas below map directly onto Webalizer's
/etc/webalizer.conf.
|
| |
| Configuration
| |
Analog is driven by a single configuration file, /usr/local/etc/analog.cfg, where you set the
log to read, where to write the report, and which breakdowns to include. A minimal, useful starting
point:
# /usr/local/etc/analog.cfg
LOGFILE /var/log/httpd-example.com-access.log
OUTFILE /usr/home/youruser/public_html/stats/analog.html
HOSTNAME "example.com"
LOGFORMAT COMBINED
The LOGFORMAT COMBINED line matches the "combined" log format used by the virtual hosts
in Virtual Hosting. Point
LOGFILE at the access log for the site you want to analyze, and OUTFILE at a path inside
your web space so the finished report is reachable in a browser.
| |
| Generating the Report
| |
Run analog with no arguments — it reads analog.cfg automatically and writes the
HTML file named by OUTFILE:
$ analog # writes the OUTFILE named in analog.cfg
Statistics are most useful when they refresh on their own. Schedule the command with
cron so the report rebuilds on a
regular basis — for example, nightly:
# Rebuild the web statistics every night at 3:30 AM
30 3 * * * /usr/local/bin/analog
| |
| Keep the Report Private
| |
Visitor statistics include IP addresses and the search terms people used to find your site —
not something to publish openly. Put the stats/ directory behind HTTP Basic authentication, as
described under "Password-Protected Directories" on the
Apache page, so only you can
read it:
# FreeBSD: create the password file (first user)
# htpasswd -c /usr/local/etc/apache24/passwords/stats.htpasswd youruser
# Rocky Linux:
# htpasswd -c /etc/httpd/passwords/stats.htpasswd youruser
Then require that login for the stats/ location in your virtual host, and reload Apache.
| |
| Documentation
| |
The packaged analog(1) manual page and the bundled documentation cover the full set of
configuration commands and report types:
|
Toll Free 1-866-GSP-4400 • 1-301-464-9363 • service@gsp.com
Copyright © 1994-2026 GSP Services, Inc.
|