Apache Log Tail : LabradorData

Apache Log Tail (cPanel Only)

Current version: 0.2 released 16 May 2006 (changelog)

If you find this script useful, you may make a small donation to help support further development. Thanks!

Screenshot, with one log line clicked to expose the 'raw' view.
(larger version)

Apache Log Tail is a set of PHP scripts which allow a server administrator to tail and grep domain access logs from a browser window.

Features:

List of domains (left pane) sortable by name, date, or size (of the log file);
Logs that have been updated since last refresh of the list pane are marked by an asterisk;
Tail display is a simplified view of log entries, for easy reading (right pane);
Colour-coding of log entries that distinguishes:
- POST requests (foreground red);
- Images (foreground green);
- Return codes: different background colours for 200s, 300s, 400s & 500s
Display the 'raw' view by clicking on any entry in the tail list (right pane);
Grep (search) the current domain log for a string;
Adjust settings for screen display:
- Width of domain list frame;
- Default sort order (domain name, date, size);
- No. of lines to tail;
- Max. display length of a request (for the simplified view);
- Local time offset -- adjust displayed date/times to that of your local computer.

Requirements:

A cPanel^® server.
Root access to Web Host Manager™ (WHM).

The scripts utilize WHM root authentication to access the domain logs.

Environment:

Apache Log Tail was developed with PHP 4.4.2, Apache 1.3.34 and cPanel 10.8.2.

Installation

Get the tarball (below) and extract the files to a directory. Put them in your primary account -- the domain you usually use to access WHM, for example: /home/MYNAME/alt. (Note that the files do NOT go in public_html.)
'Plug in' to WHM, so the scripts run as root (they must run as root in order to access the domain logs). All you need to do is create a symbolic link as root in SSH:

[root@server] cd /usr/local/cpanel/whostmgr/docroot [root@server] ln -s /home/MYNAME/alt alt
Access the scripts by going to:
https://DOMAIN:2087/alt/index.php
or:
https://IPADDRESS:2087/alt/index.php

(where of course DOMAIN or IPADDRESS is where you usually access WHM).

Login in root and it should work....

Download

Get the scripts here: Apache Log Tail.

Terms & Conditions

You are free to use, modify and redistribute these scripts. If you improve on them I'd appreciate hearing about it!

Liability:

The author assumes no liability for damage or loss that might be associated with the use of these scripts.

Bug Reports & Feedback

Bug reports and general comments are always welcome. Please address them to drobbins

labradordata