riak
editriak
edit- Version: 3.0.0
- Released on: 2016-09-10
- Changelog
This plugin does not ship with Logstash by default, but it is easy to install by running bin/logstash-plugin install logstash-output-riak
.
Riak is a distributed k/v store from Basho. It’s based on the Dynamo model.
Synopsis
editThis plugin supports the following configuration options:
Required configuration options:
riak { }
Available configuration options:
Setting | Input type | Required | Default value |
---|---|---|---|
No |
|
||
No |
|||
No |
|
||
No |
|
||
No |
|
||
No |
|
||
No |
|||
No |
|||
No |
|||
No |
|
||
string, one of |
No |
|
|
No |
|||
<<,>> |
No |
|
Details
edit
bucket
edit- Value type is array
-
Default value is
["logstash-%{+YYYY.MM.dd}"]
The bucket name to write events to Expansion is supported here as values are passed through event.sprintf Multiple buckets can be specified here but any bucket-specific settings defined apply to ALL the buckets.
bucket_props
edit- Value type is hash
- There is no default value for this setting.
Bucket properties (NYI) Logstash hash of properties for the bucket i.e.
bucket_props => { "r" => "one" "w" => "one" "dw", "one } or [source,ruby] bucket_props => { "n_val" => "3" } Properties will be passed as-is
codec
edit- Value type is codec
-
Default value is
"plain"
The codec used for output data. Output codecs are a convenient method for encoding your data before it leaves the output, without needing a separate filter in your Logstash pipeline.
enable_metric
edit- Value type is boolean
-
Default value is
true
Disable or enable metric logging for this specific plugin instance by default we record all the metrics we can, but you can disable metrics collection for a specific plugin.
enable_search
edit- Value type is boolean
-
Default value is
false
Search Enable search on the bucket defined above
id
edit- Value type is string
- There is no default value for this setting.
Add a unique ID
to the plugin instance, this ID
is used for tracking
information for a specific configuration of the plugin.
output { stdout { id => "ABC" } }
If you don’t explicitely set this variable Logstash will generate a unique name.
indices
edit- Value type is array
- There is no default value for this setting.
Indices Array of fields to add 2i on e.g.
`indices => ["source_host", "type"] Off by default as not everyone runs eleveldb
key_name
edit- Value type is string
- There is no default value for this setting.
The event key name variables are valid here.
Choose this carefully. Best to let riak decide.
nodes
edit- Value type is hash
-
Default value is
{"localhost"=>"8098"}
The nodes of your Riak cluster This can be a single host or a Logstash hash of node/port pairs e.g
{ "node1" => "8098" "node2" => "8098" }
proto
edit-
Value can be any of:
http
,pb
-
Default value is
"http"
The protocol to use HTTP or ProtoBuf Applies to ALL backends listed above No mix and match
ssl_opts
edit- Value type is hash
- There is no default value for this setting.
SSL Options Options for SSL connections Only applied if SSL is enabled Logstash hash that maps to the riak-client options here: https://github.com/basho/riak-ruby-client/wiki/Connecting-to-Riak You’ll likely want something like this:
ssl_opts => { "pem" => "/etc/riak.pem" "ca_path" => "/usr/share/certificates" }
Per the riak client docs, the above sample options
will turn on SSL VERIFY_PEER