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 (e.g. /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 nameNotes
1date-timeThe format is: Fri Feb 22 12:44:22 2002
2clicker-ipThe IP address of the request.
3referrer-URIThe 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
4rankThe rank the clicked result was presented at (beginning from 1, 0 means a featured page)
5target-URIThe URI that the click should take the browser to. i.e. the actual search result
6type of result identifierAn identifier where "FP" indicates a click on a featured page, whereas "CLICK" indicates a click on a regular search result.
7User identifierUnique 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