README.md in fluent-plugin-geoip-0.0.4 vs README.md in fluent-plugin-geoip-0.0.5
- old
+ new
@@ -8,15 +8,27 @@
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))
+## Dependency
+
+before use, install dependent library as:
+
+```bash
+# for RHEL/CentOS
+$ sudo yum install geoip-devel --enablerepo=epel
+
+# for Ubuntu/Debian
+$ sudo apt-get install libgeoip-dev
+```
+
## Installation
install with `gem` or `fluent-gem` command as:
-```
+```bash
# for fluentd
$ gem install fluent-plugin-geoip
# for td-agent
$ sudo /usr/lib64/fluent/ruby/bin/fluent-gem install fluent-plugin-geoip
@@ -29,22 +41,26 @@
type geoip
# buffering time (default: 60s)
flush_interval 1s
+ # Queued chunks are flushed at shutdown process.
+ flush_at_shutdown yes
+
# tag settings
remove_tag_prefix access.
add_tag_prefix geoip.
include_tag_key false
# specify geoip lookup field (default: host)
+ # in the case of accessing nested value, delimit keys by dot like 'host.ip'.
geoip_lookup_key host
# specify geoip database (using bundled GeoLiteCity databse by default)
geoip_database 'data/GeoLiteCity.dat'
- # record settings (enable more than one keys required.)
+ # record settings (enable more than one keys are 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
@@ -96,13 +112,28 @@
$ 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}
```
+For more details of geoip data format is described at the page below in section `GeoIP City Edition CSV Database Fields`.
+http://dev.maxmind.com/geoip/legacy/csv/
+
## 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
+
+* [初の安定版 fluent-plugin-geoip v0.0.3 をリリースしました #fluentd- Y-Ken Studio](http://y-ken.hatenablog.com/entry/fluent-plugin-geoip-v0.0.3)
+http://y-ken.hatenablog.com/entry/fluent-plugin-geoip-v0.0.3
+
+* [fluent-plugin-geoip v0.0.4 をリリースしました。ElasticSearch＋Kibanaの世界地図に位置情報をプロットするために必要なFluentdの設定サンプルも紹介します- Y-Ken Studio](http://y-ken.hatenablog.com/entry/fluent-plugin-geoip-v0.0.4)
+http://y-ken.hatenablog.com/entry/fluent-plugin-geoip-v0.0.4
+
+* [Released GeoIP plugin to work together with ElasticSearch + Kibana v3](https://groups.google.com/d/topic/fluentd/OVIcH_SKBwM/discussion)
+https://groups.google.com/d/topic/fluentd/OVIcH_SKBwM/discussion
+
+* [Fluentd、Amazon RedshiftとTableauを用いたカジュアルなデータ可視化 | SmartNews開発者ブログ](http://developer.smartnews.be/blog/2013/10/03/easy-data-analysis-using-fluentd-redshift-and-tableau/)
+http://developer.smartnews.be/blog/2013/10/03/easy-data-analysis-using-fluentd-redshift-and-tableau/
## TODO
Pull requests are very welcome!!