riak
editriak
editThis is a community-maintained plugin! It does not ship with Logstash by default, but it is easy to install by running bin/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 |
|
||
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_search
edit- Value type is boolean
-
Default value is
false
Search Enable search on the bucket defined above
exclude_tags
(DEPRECATED)
edit- DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
- Value type is array
-
Default value is
[]
Only handle events without any of these tags. Optional.
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
tags
(DEPRECATED)
edit- DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
- Value type is array
-
Default value is
[]
Only handle events with all of these tags. Optional.
type
(DEPRECATED)
edit- DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
- Value type is string
-
Default value is
""
The type to act on. If a type is given, then this output will only
act on messages with the same type. See any input plugin’s type
attribute for more.
Optional.