Funnelback logo

Documentation

Click logs

Introduction

The Funnelback click logs record collection search results that users have clicked on, providing information on popular results.

Usage

Set click_tracking=true in a collection's collection.cfg file to enable click logging.

Log locations

Live Funnelback logs are located at:

data_root/collection_name/live/log/*.log
Example: /opt/funnelback/data/shakespeare/live/log/clicks.log

This log file is updated for each click. Note that older versions of Funnelback store "clicks" in queries.log whereas later versions use clicks.log.

When the collection is updated, these files are then archived by moving them to the directory:

data_root/collection_name/live/archive

The archived file is named according to the current date e.g. /opt/funnelback/data/collection/archive/clicks.log.20040715.

Log Format

Click logs have the following format: one line in the logfile per click processed and each line contains fields separated by commas. Some example lines from a clicks log:

...
Mon Sep 8 14:51:23 2008,2.4.6.8,http://site/search.cgi?collection=test&query=ona,1,http://www.ona.gov.au/,CLICK
Mon Sep 8 14:52:29 2008,1.2.3.4,http://site/search.cgi?collection=test&query=jobs,0,http//www.jobsearch.gov.au/,FP
...

The individual fields in each line are described in the following table:

Field no. Field name Notes
1 date-time The format is: Fri Feb 22 12:44:22 2002
2 clicker-ip The IP address of the request.
3 referrer-URI The page that this click was made from. e.g http://govsearch.australia.gov.au/search/search.cgi?collection=gov&fqp=1&fscope=512&num_ranks=20&query=citizenship
4 rank The rank the clicked result was presented at (beginning from 1, 0 means a featured page)
5 target-URI The URI that the click should take the browser to. i.e. the actual search result
6 type of result identifier An identifier where "FP" indicates a click on a featured page, whereas "CLICK" indicates a click on a regular search result.
7 User identifier Unique identifier of a user, if Search session and history is enabled. If not, then a dash "-" will be written to this field.

See also

top ⇑