README.md in fluent-plugin-geoip-0.0.2 vs README.md in fluent-plugin-geoip-0.0.3

- old
+ new

@@ -1,9 +1,17 @@ # fluent-plugin-geoip Fluentd Output plugin to add information about geographical location of IP addresses with Maxmind GeoIP databases. +fluent-plugin-geoip has bundled cost-free [GeoLite City database](http://dev.maxmind.com/geoip/legacy/geolite/) by default. +Also you can use purchased [GeoIP City database](http://www.maxmind.com/en/city) ([lang:ja](http://www.maxmind.com/ja/city)) which costs starting from $50. + +The accuracy details for GeoLite City (free) and GeoIP City (purchased) has described at the page below. + +* http://www.maxmind.com/en/geolite_city_accuracy ([lang:ja](http://www.maxmind.com/ja/geolite_city_accuracy)) +* http://www.maxmind.com/en/city_accuracy ([lang:ja](http://www.maxmind.com/ja/city_accuracy)) + ## Installation install with `gem` or `fluent-gem` command as: ``` @@ -18,22 +26,25 @@ ``` <match access.apache> type geoip - # buffering time + # buffering time (default: 60s) flush_interval 1s # tag settings remove_tag_prefix access. add_tag_prefix geoip. include_tag_key false - # geoip settings + # specify geoip lookup field (default: host) geoip_lookup_key host - # record settings + # specify geoip database (using bundled GeoLiteCity databse by default) + geoip_database 'data/GeoLiteCity.dat' + + # record settings (enable more than one keys required.) enable_key_city geoip_city enable_key_latitude geoip_lat enable_key_longitude geoip_lon enable_key_country_code3 geoip_country3 enable_key_country_code geoip_country @@ -84,9 +95,14 @@ # check the result at stdout $ tail /var/log/td-agent/td-agent.log 2013-08-04 16:21:32 +0900 test.geoip: {"host":"66.102.9.80","message":"test"} 2013-08-04 16:21:32 +0900 debug.geoip: {"host":"66.102.9.80","message":"test","city":"Mountain View","lat":37.4192008972168,"lon":-122.05740356445312} ``` + +## Articles + +* [IPアドレスを元に位置情報をリアルタイムに付与する fluent-plugin-geoip v0.0.1をリリースしました #fluentd - Y-Ken Studio](http://y-ken.hatenablog.com/entry/fluent-plugin-geoip-has-released) +http://y-ken.hatenablog.com/entry/fluent-plugin-geoip-has-released ## TODO Pull requests are very welcome!!