› ›

Collectd 编解码器插件

编辑

Collectd 编解码器插件

编辑

插件版本：v3.1.0
发布日期：2021-08-04
变更日志

其他版本，请参见版本化插件文档。

获取帮助

编辑

如有任何关于插件的问题，请在 Discuss 论坛中发起主题讨论。如发现错误或有功能需求，请在 Github 中提交问题。如需查看 Elastic 支持的插件列表，请参考 Elastic 支持矩阵。

描述

编辑

通过 UDP 网络读取 collectd 二进制协议的事件。请参见 https://collectd.org/wiki/index.php/Binary_protocol

Logstash 配置文件中的配置可以很简单，例如：

    input {
      udp {
        port => 25826
        buffer_size => 1452
        codec => collectd { }
      }
    }

一个发送到 Logstash 的示例 collectd.conf 文件如下：

    Hostname    "host.example.com"
    LoadPlugin interface
    LoadPlugin load
    LoadPlugin memory
    LoadPlugin network
    <Plugin interface>
        Interface "eth0"
        IgnoreSelected false
    </Plugin>
    <Plugin network>
        Server "10.0.0.1" "25826"
    </Plugin>

请务必将 10.0.0.1 替换为您 Logstash 实例的 IP 地址。

Collectd 编解码器配置选项

编辑

设置	输入类型	必填
`authfile`	字符串	否
`nan_handling`	字符串，可选值：`["change_value", "warn", "drop"]`	否
`nan_tag`	字符串	否
`nan_value`	数字	否
`prune_intervals`	布尔值	否
`security_level`	字符串，可选值：`["None", "Sign", "Encrypt"]`	否
`target`	字符串	否
`typesdb`	数组	否

`authfile`

编辑

值类型为字符串
此设置没有默认值。

身份验证文件的路径。此文件应与 collectd 中的 AuthFile 格式相同。只有当 security_level 设置为 Sign 或 Encrypt 时，才需要设置此选项。

`nan_handling`

编辑

可选值：change_value、warn、drop
默认值为 "change_value"

当事件中的值为 NaN（非数字）时该怎么办

change_value (默认)：将 NaN 更改为 nan_value 选项的值，并添加 nan_tag 作为标签
warn：将 NaN 更改为 nan_value 选项的值，向日志打印警告并添加 nan_tag 作为标签
drop：删除包含 NaN 的事件（这只会删除单个事件，而不是整个数据包）

`nan_tag`

编辑

值类型为字符串
默认值为 "_collectdNaN"

如果发现 NaN 值，则添加到事件中的标签。如果您不想添加标签，请将其设置为空字符串 ('')

`nan_value`

编辑

值类型为数字
默认值为 0

仅当 nan_handling 设置为 change_value 时才相关。将 NaN 更改为此配置的值。

`prune_intervals`

编辑

值类型为布尔值
默认值为 true

修剪间隔记录。默认为 true。

`security_level`

编辑

可选值：None、Sign、Encrypt
默认值为 "None"

安全级别。默认为 None。此设置与 collectd 网络插件中的设置相同。

`target`

编辑

值类型为字符串
此设置没有默认值。

定义用于放置解码值的 target 字段。如果未设置此设置，则数据将存储在事件的根（顶层）。

例如，如果您想将数据放在 document 字段下：

    input {
      udp {
        port => 12345
        codec => collectd {
          target => "[document]"
        }
      }
    }

`typesdb`

编辑

值类型为数组
此设置没有默认值。

要使用的 collectd types.db 文件路径。如果在多个文件中具有相同的模式名称，则最后一个匹配的模式优先。如果没有提供 types.db，则将使用包含的 types.db (当前版本为 5.4.0)。

« Cloudtrail 编解码器插件 Csv 编解码器插件 »