Here are the requirements to run Access Log Viewer:
- UNIX web server
- Perl4 or higher
- The absolute path to your servers access log. Look in your main login directory for a directory called "logs" and a file called "access_log" for starters.
- Server log must be readable. Setting a CHMOD of 766 will usually accomplish this.
Please read the Perl Services Licensing Agreement
By downloading, purchasing, acquiring and/or implementing any PerlServices software, you agree to be bound by the terms and conditions of the distribution policy.
What log format will it read?
This script is written to read a standard distribution access log format and combined access/referer log format on an Apache web server.
The two formats this script will parse are:
- 1.) Access Log Format:
i.e.: 126.96.36.199 - - [29/Oct/2001:01:52:44 -0700] "GET /images/common/banner.gif HTTP/1.1" 200 3678
ip.ip.ip.ip - - [dd/mm/yyyy:hh:mm:ss -offset] "METHOD /file/requested.file Compliancy" code size
- 1.) Combined Access/Referer Log Format:
188.8.131.52 - - [29/Oct/2001:01:52:44 -0700] "GET /images/common/banner.gif HTTP/1.1" 200 3678 "http://www.thebeaches.to/somepage.html" "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; Mozilla/4.0 (compatible; MSIE 5.0; Windows 95/NT; UUNET-DE))"
ip.ip.ip.ip - - [dd/mm/yyyy:hh:mm:ss -offset] "METHOD /file/requested.file Compliancy" code size "http://www.somereferer.com/" "UserAgent"
If your access log is in a different format than one of the two above, we can modify the script
to read your access logs format. The fee for this modification is US$40. Please contact our
Support Department to arrange the modification and payment. If you feel like
tempting fate, however, you can modify the format yourself below line 430. Just modify the
Regexp to match the pattern of your access log. Such modifications are permitted so long as
that modification exists ONLY on the server for which it was modified.
How to install the program
You need to do two things to install this program.
- Make sure the path to Perl is correct on the first line of the script.
- Around line #41 you will see the variable $ACC_LOG. You must set this variable to the
absolute path to the server's access log. You can find out what this absolute path is by
asking your SysAdmin or support personel. Some servers may not give you access to the
servers/domains access log.
How to exclude your own domain from the referer report.
The "Analyze" function can create a very LARGE page and take a long time to download. You
can decrease the size of the page and increase the speed of the download by excluding your
own domain from the referer reporting (if your access log is using a combined log format).
To do this, in the script around line #52 you will see the variable: $exclude_referers
All you need to do is set the domain in this variable you want excluded. You can set more
than one domain. For example, on the Perl Services Access Log, we exclude both www.perlservices.net
and perlservices.net. This is done like this:
my $exclude_referers = qq~
What if I can't get the path to the access log?
Some server administrators will not turn on the access logging on the web server unless
you pay for it. Additionally, some will not allow you to have direct access to the access log.
There is nothing you can do in these circumstances.
However, you can first have poke around your web space on the server. Look for a directory
named "logs" or similar and see if there is a file in there called "access_log". That is the
standard name for an access log on an Apache server. You just may find it on your own.
I don't recommend you go outside of your own name space. That's just wrong.
If you are unable to set-up this program or are uncomfortable setting up the program then please contact our support department via the Support Centre Page
We offer an installation service for a fee, details of which are available at the Support Center. Note that due to the unpredictable nature of NT and Mac servers, we do not offer support or installation services for programs being installed on these types of servers. This program was written for a UNIX server.
If you do not receive a response from our support centre within 24 hours, please contact us