« Cloudtrail 编解码器插件 Csv 编解码器插件 »
Elastic 文档 ›Logstash 参考 [8.14] ›编解码器插件

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_handeling 设置为 change_value 时才相关。将 NaN 更改为此配置的值。

prune_intervals编辑

修剪间隔记录。默认值为 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 编解码器插件 »