Click logs
Introduction
The Funnelback click logs record collection search results and best bets that users have clicked on and provides 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-localhost.log
)
This log file is updated for each click. Note that older versions of Funnelback store clicks in queries.log
and 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 and hostname e.g. /opt/funnelback/data/collection/archive/clicks-localhost.20190827_022830.log.gz
.
Log format
Click logs have the following format: one line in the log file per click processed and each line contains fields separated by commas. Some example lines from a clicks.log
:
...
Tue Aug 27 03:08:03 2019,10.0.2.0,http://fake/?collection=foodista&profile=_default&query=cream,11,http://www.foodista.com/recipe/6QZTQFBY/bulgogi-kimchi-fries.html,CLICK,0d5f0777-8caf-4774-8d7f-f537b77e6c3c
Tue Aug 27 03:30:03 2019,10.0.2.0,http://fake/?collection=foodista&profile=_default&query=cream%20%7Ctags%3A%22%24%2B%2B%20cheese%20%24%2B%2B%22,2,http://www.foodista.com/recipe/3W34GRBC/asado-rolls.html,CLICK,0d5f0777-8caf-4774-8d7f-f537b77e6c3c
Tue Aug 27 03:30:39 2019,10.0.2.0,http://fake/?collection=foodista&profile=_default&query=foodista,0,https://en.wikipedia.org/wiki/Foodista.com,FP,0d5f0777-8caf-4774-8d7f-f537b77e6c3c
...
The individual fields in each line are described in the following table:
Field no. | Field name | Notes |
---|---|---|
1 | date-time | The format is: Tue Aug 27 03:08:03 2019 |
2 | clicker-ip | The IP address of the request. |
3 | referrer-URI | The page that this click was made from. e.g http://mysite.com/s/search.html?collection=examples&query=find |
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 best bet, 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. |