README.md in fluent-plugin-twitter-0.0.1 vs README.md in fluent-plugin-twitter-0.1.1

- old
+ new

@@ -1,10 +1,10 @@ fluent-plugin-twitter ===================== -## Overview -create your own twitter bot with fluentd +## Component +Fluentd Input/Output plugin. You can create your own "Twitter Bot" with fluentd messaging system. ## Installation ### native gem @@ -15,24 +15,69 @@ ### td-agent gem ````` /usr/lib64/fluent/ruby/bin/fluent-gem install fluent-plugin-twitter ````` -## Configuration +## Input Configuration -### Sample +### Input Sample ````` +<source> + type twitter + consumer_key YOUR_CONSUMER_KEY # Required + consumer_secret YOUR_CONSUMER_SECRET # Required + oauth_token YOUR_OAUTH_TOKEN # Required + oauth_token_secret YOUR_OAUTH_TOKEN_SECRET # Required + tag input.twitter.sampling # Required + timeline sampling # Required (sampling or userstream) + keyword Ruby,Python # Optional (userstream not supported yet) + lang ja,en # Optional +</source> + +<match input.twitter.sampling> + type stdout +</match> +````` + +### Debug +````` +$ tail -f /var/log/td-agent/td-agent.log +````` + +## Output Configuration + +### Output Sample +````` +<source> + type http + port 8888 +</source> + <match notify.twitter> type twitter consumer_key YOUR_CONSUMER_KEY consumer_secret YOUR_CONSUMER_SECRET - oauth_token YOUR_OAUTH_TOEKN - oauth_token_secret YOUR_OAUTH_TOEKN_SECRET + oauth_token YOUR_OAUTH_TOKEN + oauth_token_secret YOUR_OAUTH_TOKEN_SECRET </match> ````` +### Debug +````` +$ curl http://localhost:8888/notify.twitter -F 'json={"message":"foo"}' +````` + +## Reference + +### Twitter OAuth Guide +http://pocketstudio.jp/log3/2012/02/12/how_to_get_twitter_apikey_and_token/ + ## TODO patches welcome! + +## Known Issue +On starting fluentd, appearing alert message below. Please tell me how to fix up. +`/usr/lib64/fluent/ruby/lib/ruby/gems/1.9.1/gems/eventmachine-1.0.0/lib/eventmachine.rb:1530: warning: already initialized constant EM` ## Copyright Copyright © 2012- Kentaro Yoshida (@yoshi_ken)