Riemann 输出插件
编辑Riemann 输出插件编辑
- 插件版本:v3.0.7
- 发布时间:2020-07-15
- 更新日志
有关其他版本,请参阅版本化插件文档。
安装编辑
对于默认情况下未捆绑的插件,可以通过运行 bin/logstash-plugin install logstash-output-riemann
来轻松安装。有关更多详细信息,请参阅使用插件。
获取帮助编辑
如果您对该插件有任何疑问,请在论坛中发帖。对于错误或功能请求,请在Github中提交问题。有关 Elastic 支持的插件列表,请参阅Elastic 支持矩阵。
描述编辑
Riemann 是一个网络事件流处理系统。
虽然 Riemann 在概念上与 Logstash 非常相似,但它在作为监控系统替代品方面提供了更多功能。
Riemann 在 Logstash 中的使用方式与 statsd 或其他与指标相关的输出非常相似。
您可以在这里了解有关 Riemann 的信息:
您可以在这里观看作者的演讲:
Riemann 输出配置选项编辑
此插件支持以下配置选项以及稍后描述的通用选项。
设置 | 输入类型 | 必需 |
---|---|---|
否 |
||
否 |
||
否 |
||
否 |
||
字符串, |
否 |
|
否 |
||
否 |
另请参阅通用选项,以获取所有输出插件支持的选项列表。
map_fields
编辑
- 值类型为布尔值
- 默认值为
false
如果设置为 true,则自动将所有 Logstash 定义的字段映射到 Riemann 事件字段。所有嵌套的 Logstash 字段都将映射到包含所有父键(用点分隔)和最深层值的 Riemann 字段。
例如,Logstash 事件
{ "@timestamp":"2013-12-10T14:36:26.151+0000", "@version": 1, "message":"log message", "host": "host.domain.com", "nested_field": { "key": "value" } }
将映射到此 Riemann 事件
{ :time 1386686186, :host host.domain.com, :message log message, :nested_field.key value }
它可以与 riemann_event 选项一起使用,也可以独立于 riemann_event 选项使用。与 riemann_event 一起使用时,任何重复的键都将从 riemann_event 而不是 Logstash 事件本身接收其值。
protocol
编辑
- 值可以是以下任意一项:
tcp
、udp
- 默认值为
"tcp"
要使用的协议:UDP 是非阻塞的,TCP 是阻塞的。
Logstash 的默认输出行为是永远不会丢失事件。因此,我们在此处使用 tcp 作为默认值。
riemann_event
编辑
- 值类型为哈希
- 此设置没有默认值。
用于设置 Riemann 事件字段的哈希值(http://riemann.io/concepts.html)。
支持以下事件字段:description
、state
、metric
、ttl
、service
在 Logstash 事件中找到的标签将自动添加到 Riemann 事件中。
此处设置的任何其他字段都将作为事件属性传递给 Riemann。
示例
riemann { riemann_event => { "metric" => "%{metric}" "service" => "%{service}" } }
metric
和 ttl
值将被强制转换为浮点值。无法强制转换的值将为零 (0.0)。
默认情况下,description
将设置为事件消息,但可以在此处覆盖。