This page is similar to an F.A.Q. but is devoted to providing answers on how to get certain things done with polliwog.
If you can't find the answer to your question below then please
contact me (Gary) for further assistance.
How do I run polliwog?
polliwog doesn't find any visitors, what am I doing wrong?
There are various reasons as to why polliwog won't find any visitors. As of
version 0.7 polliwog will try and diagnose why no visitors can be found and give tips on how to remedy it. Please follow the advice that polliwog provides first and if that still doesn't work you can
contact me (Gary) for further assistance.
How do I process multiple/rolling log files?
How do I create page titles?
The date/times aren't in my time zone, how do I set it?
To set the time zone modify
properties file adding a property named:
timeZone
with the appropriate value.
For example:
<property name="timeZone"
type="string">
<description>The time zone that polliwog will use for date/times. Note: this will be set as the default time zone for the JVM running polliwog.</description>
<value>Australia/Brisbane</value>
</property>How do I filter out hits from a certain IP address?
If you are using the default
hit filter that is supplied with polliwog then use the following
rule element:
<rule type="josql"
action="reject">
hostname = '__IP_ADDRESS__'
</rule>Where
__IP_ADDRESS__ is replaced with the ip address you want to filter.
See the
hit filtering page for full details on how to filter hits.
How do I specify what is a page?
It all depends upon what constitutes a page for your website. Is it the file extension, such as
html,
jsp,
php,
cgi? Or is it more complex and based on query parameters etc? For full details on how specify what is a page see the
page resolution page.
How do I process a log for a certain date range?
If you using the default
hit filter that is supplied with polliwog then use one of the following
rule elements:
Hits for a certain month<rule type="josql"
action="accept">
month (date, '__MON__')
</rule>Where
__MON__ is the 3 letter code (in your locale) for the month, for example, Apr, Jan, Mar, Dec and so on.
Hits between certain months (in the current year)<rule type="josql"
action="accept">
timeField (date, "m") BETWEEN month ('__FROM_MON__') AND month ('__TO_MON__')
</rule>Where
__FROM_MON__ and
__TO_MON__ are the 3 letter codes (in your locale) for the months, for example, Apr, Jan, Mar, Dec and so on.
Hits from this week<rule type="josql"
action="accept">
currentWeek (date)
</rule>
date >= toDate ('__FROM_YEAR_MON__', 'MMM/yyyy')
AND
date <= toDate ('__TO_YEAR_MON__', 'MMM/yyyy')
The date formats specified must conform to the specification laid out in
SimpleDateFormat.
How can I see what city/town my visitors are from?
See the
GeoIP integration page for details on determining what city/town your visitors are from.
How do I process a file that has to be accessed using http/https?
Just specify the full url of the log file in the build.xml file, see the
getting started page for details on how to specify which log file polliwog should process.
How do I process compressed (gzipped) log files?
polliwog will automatically handle compressed log files if they have a
.gz file extension. Also, if you have a
.zip log file (zipped archive) then polliwog will automatically handle them as long as there is a file in the archive that has the same name as the log file specified, i.e. if your log file name is:
my_log_file.txt.zip
then polliwog will expect the file to be a zipped archive and contain a file called:
my_log_file.txt
