New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« Cloudtrail 编解码插件 Csv 编解码插件 »
Elastic 文档 ›Logstash 参考 [8.17] ›编解码插件

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。

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 编解码插件 »