Setting up WebLog 2THE PERL SCRIPTS ARE NO LONGER BEEING SUPPORTED - PLEASE GO TO TETRABB.COM FOR THE NEWEST VERSION OF THE WEBBBS FORUM
$PrintFullAgentLists: If this variable is set to 1, and if you have
a DBM file containing a full list of agents, instead of printing out
its normal reports, WebLog will print two lists, showing exactly which
agents fall into the various agent and platform categories listed on
your agents report. Again, this is of little or no interest to most
of those using WebLog, and can quite safely be set to 0 and forgotten.
$EOMFile: An optional file which WebLog can “spin off” at the close
of each month, containing a full record of file access, etc., for the
month. This makes it easier for those who wish to keep permanent
“archive” reports to do so.
$SystemName: The name or description which you want to appear at the
top of your reports (e.g., “WebScripts”).
$OrgName and $OrgDomain: The name and domain of the “host” organization
(e.g., ISP and isp.com). If these variables are defined, accesses
from this organization/domain will be counted separately from other
accesses in the details report.
$GraphURL: The URL of the directory containing the bar graph images
(e.g., “http://awsd.com/graphs”). Do NOT include a trailing slash!
$GraphBase: This variable defines the information on which you want the
bar graphs in the main report to be based. It can be set either as
“hits”, “visits”, “pviews” or “bytes”; if left undefined (or defined
incorrectly), graphs will be based on bytes transferred.
$IncludeOnlyRefsTo and $ExcludeRefsTo: Regexs specifying files or
directories to include or ignore in the files lists. For example, to
include only files in a “scripts” subdirectory, $IncludeOnlyRefsTo =
“^/scripts” would suffice. Multiple entries should be “OR”ed
(e.g., $IncludeOnlyRefsTo = “(^/dir1|^/dir2)”).
$IncludeOnlyDomain and $ExcludeDomain: Regexs specifying domains to
include or ignore in the log file. If you want your log analysis to
ignore any visits by you to your own site, for example, set the
$ExcludeDomain variable to your own IP address. (Note that even if
you don’t ignore your own visits completely, you can still track them
separately in the details report by using the $OrgName and $OrgDomain
$IncludeQuery: If this variable is set to “0″ any query information
contained in a URL will be stripped as the log file is processed. If
it is set to “1″ the information will be retained.
$PrintFiles: A flag specifying whether the lists of accessed files
should be generated. (Normally, of course, you’d want to do so.
However, for example, if you generate a separate access report for
each site on a server, and also a report for the server as a whole,
you might want to suppress the files listings on the server-wide
report.) 0 = no; 1 = yes. As noted earlier, by defining a “full
list” report, you can put the full list “off to the side,” to keep
your main report’s size down, but still have WebLog generate the
“top N files” lists.
$Print404: A flag specifying whether the “Code 404″ file lists should
be printed. 0 = no; 1 = yes.
$PrintDomains: A flag specifying whether or not to print lists of
visiting IP addresses. 0 = no; 1 = yes. This variable can also be
set to “2″ to indicate that you want only second-level domains
tracked. (In other words, for example, one hit each from
user1.foo.com and user2.foo.com will show up simply as two hits
from foo.com, which can greatly reduce the size of your log file,
especially if your site is busy!)
$PrintUserIDs: A flag specifying whether the User ID list should be
generated. If no portion of your site is password protected, or if
you use a password system other than that which is integral to your
server software (.htaccess in the case of most UNIX systems), then
this list can be turned off, as your log file won’t contain any user
$PrintTopNFiles: The number of files to include in the “Top N Files”
lists. Set to 0 if you don’t want to print the lists. The script
cannot generate the “top N” list if the full list isn’t also being
$TopFileListFilter: Regex defining files to exclude from the “Top N
Files” lists. The default value of “(\.gif|\.jpg|\.jpeg|Code 404)”
will filter out most image files and any frequently-requested but non-
$PrintTopNDomains: The number of domains to include in the “Top N
Domains” lists. (This, of course, is irrelevant if you’re not
printing domain lists.)
$LogOnlyNew: Setting this variable to “1″ will instruct WebLog to
ignore any entries in the log file being analyzed which date from
before the end of the last log file analyzed. If you’re afraid that
you might accidentally run the script with the same log file twice in
a row, setting this to “1″ will prevent any data duplication. If, on
the other hand, you won’t necessarily be analyzing log files in strict
chronological order, you will want to keep this set to “0″ so that all
information is parsed.