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!!