› ›

Collectd 编解码插件

编辑

Collectd 编解码插件

编辑

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

对于其他版本，请参阅版本化的插件文档。

获取帮助

编辑

有关该插件的问题，请在Discuss论坛中开一个主题。对于错误或功能请求，请在Github中开一个 issue。有关 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_handeling 设置为 change_value 时才相关。将 NaN 更改为此配置的值。

`prune_intervals`

编辑

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

删除间隔记录。默认值为 true。

`security_level`

编辑

值可以是以下任何一个：None、Sign、Encrypt
默认值为 "None"

安全级别。默认为 None。此设置镜像了 collectd Network 插件中的设置。

`target`

编辑

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

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

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

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

`typesdb`

编辑

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

要使用的 collectd types.db 的文件路径。如果在多个文件中具有相同的模式名称，则最后一个匹配的模式胜出。如果未提供 types.db，则将使用包含的 types.db（当前为 5.4.0）。

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