No commit activity in last 3 years
No release in over 3 years
parsing by referer-parser. See: https://github.com/snowplow/referer-parser
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 3.2

Runtime

< 2, >= 0.14.15
 Project Readme

fluent-plugin-referer-parser, a plugin for Fluentd

Build Status

RefererParserFilter

'fluent-plugin-referer-parser' is a Fluentd plugin to parse Referer strings, based on tagomoris/fluent-plugin-woothee. 'fluent-plugin-referer-parser' uses snowplow/referer-parser.

Requirements

fluent-plugin-referer-parser fluentd ruby
>= 0.1.0 >= v0.14.15 >= 2.4
< 0.1.0 >= v0.12.0 >= 1.9

fluent-plugin-referer-parser >= 0.1.0 works on ruby >= 2.1, but referer-parser(0.3.0) does not work properly for non-UTF-8 search terms with ruby < 2.4. You use fluent-plugin-referer-parser >= 0.1.0, so we recommend to use ruby 2.4 or later.

Configuration

To add referer-parser result into matched messages:

<filter>
  @type referer_parser
  key_name referer
</match>

Output messages with tag 'merged.**' has 'referer_known', 'referer_referer' and 'referer_search_term' attributes. If you want to change attribute names, write configurations as below:

<filter>
  @type referer_parser
  key_name ref
  out_key_known        ref_known
  out_key_referer      ref_referer
  out_key_host         ref_host
  out_key_search_term  ref_search_term
</match>

If you want to use your own referers definition, you can use 'referers_yaml' attribute. 'referers_yaml' should be referers.yaml format of snowplow/referer-parser.

Copyright

  • Copyright (c) 2012- TAGOMORI Satoshi (tagomoris)
  • Copyright (c) HARUYAMA Seigo
  • License
    • Apache License, Version 2.0