NAME
webv
- reports the the number of unique visitors for the current month to date.
SYNOPSIS
webv
[
-c
<config_file>
]
[
-d
]
[
-s
]
[
-v
]
<config_id>
[
<config_id> ...
] |
-V
AVAILABILITY
webv
is a Bourne/Bash shell script which should work equally well on all versions of UNIX,
Linux and Mac OS X.
DESCRIPTION
webv
uses the configuration id(s) as the lookup key(s) to the configuration file
/usr/local/etc/webv.cf
and finds the locaton(s) of the
awstats
report(s) on a remote web server.
The locations are used by
wget
to fetch the report(s) to put on a pipe to a
bash
script which extracts the total number of unique visitor in the month
to date and calculates the average number of visitors per minute
and the predicted total(s) for the month end.
The script was written to monitor a number of websites where changes were
being made in order to routinely check the impact of the changes.
OPTIONS
-c
Use the specified configuration file in preference to the default
"/usr/local/etc/webv.cf"
.
If no configuration file is found the
script will terminate with an error message.
-d
Set debug mode on.
The
-x
option is set within the shell
and each command in the script is echoed to the console.
-s
The output is sorted in reverse numerical order.
-v
The usual output is just the 3 numbers repesenting the total number of
unique visitors so far in the month, the daily average and the
predicted outturn. With the
-v
option the output is formated and
labled. This is particularly useful when used with cron to report on a
number of different sites.
<
config_id
>
The configuration identity is the key to the stanza in the configuration
file which will be used to determine the required
URI
for the stats
report.
-V
Print version details and exit.
FILES
webv.cf.
EXAMPLES
$: webv -v ai cl fc fs t4l
Website Visitors Average Prediction
www.amharic-interpreter.com 46 5.33 165
www.citylinux.com 319 37.58 1165
fcl.fulford.net 432 50.83 1576
www.flare-support.co.uk 3543 417.89 12955
www.training4linux.com 44 5.18 161
Each id is looked up in the default configuration file
/usr/local/etc/webv.cf
. Using the location found the script
fetches the awstats reports, extracts the number of unique visitors for
the month to date, calculates the daily average for the month and the
predicted totals for the month end.
$: webv -v -s ai cl fc fs t4l
Website Visitors Average Prediction
www.flare-support.co.uk 3543 417.89 12955
fcl.fulford.net 432 50.83 1576
www.citylinux.com 319 37.58 1165
www.amharic-interpreter.com 46 5.33 165
www.training4linux.com 44 5.18 161
Each id is looked up in the default configuration file
/usr/local/etc/webv.cf
. Using the
location
found the script
fetches the awstats reports, extracts the number of unique visitors in
the current month, calculates the daily average and the predicted total
for the month end as above but sorts the result is reverse numerical
order.
BUGS
The script calculate the predicted total from the average number of visits
per minute at the time of invocation. At the start of the month the
number of unique visitors is close to the total number of visits. As the
month progress the difference between visitor and unique visitors increaes.
It is for this reason that the predicted numbers tends to be exagerated
at the month start and becomes progressively more accurate.
The script is utilitarian and has very little, if any, error checking.
The consequences of unexpected input are untested.
SEE ALSO
webupd.
AUTHOR
Clifford W Fulford, City Linux. Contact fulford@fulford.net or +44 (0)709 229 5385.
