[doc] provide an example

[dadoonet]

As I hit that "issue", I think we should document the Twitter input with an example and also write clearly that Strings must be wrapped with ".

Instead of:

twitter {
    consumer_key => ...
    consumer_secret => ...
    keywords => ...
    oauth_token => ...
    oauth_token_secret => ...
}

write:

twitter {
    consumer_key => "..."
    consumer_secret => "..."
    keywords => [ "...", "..." ]
    oauth_token => "..."
    oauth_token_secret => "..."
}

or

twitter {
    consumer_key => "CONS_KEY"
    consumer_secret => "CONS_SECRET"
    keywords => [ "KEY1", "KEY2" ] 
    oauth_token => "OAUTH_TOKEN"
    oauth_token_secret => "OAUTH_SECRET"
}

Also, can we add a link to Twitter dev console so it's easy for users to set it up? https://dev.twitter.com/apps/new

[mobcdi]

Maybe include use_samples = > true and some elastic, logstash accounts, tags and keywords to show use_samples = > true also disables those

[wathmal]

an example can be found in here. 😄
https://github.com/elastic/examples/tree/master/ELK_twitter