Zabbix 输出插件编辑

  • 插件版本:v3.0.5
  • 发布时间:2018 年 4 月 6 日
  • 更新日志

有关其他版本,请参阅版本化插件文档

安装编辑

对于默认情况下未捆绑的插件,可以通过运行 bin/logstash-plugin install logstash-output-zabbix轻松安装。有关更多详细信息,请参阅使用插件

获取帮助编辑

有关该插件的问题,请在论坛中打开一个主题。对于错误或功能请求,请在Github中打开一个问题。有关 Elastic 支持的插件列表,请参阅Elastic 支持矩阵

描述编辑

Zabbix 输出用于将项目数据(键/值对)发送到 Zabbix 服务器。事件 @timestamp 将自动与 Zabbix 项目数据关联。

Zabbix 发送器协议在https://www.zabbix.org/wiki/Docs/protocols/zabbix_sender/2.0 中进行了描述。Zabbix 使用一种嵌套的键/值存储。

    host
      ├── item1
      │     └── value1
      ├── item2
      │     └── value2
      ├── ...
      │     └── ...
      ├── item_n
      │     └── value_n

每个“主机”都是一个标识符,每个项目都与该主机相关联。项目在 Zabbix 端进行类型化。您可以将数字作为字符串发送,Zabbix 会做正确的事情。

在 Zabbix UI 中,请确保您的主机名与 zabbix_host 引用的值相匹配。使用 zabbix_key 引用的字段中显示的键创建项目。在项目配置窗口中,请确保将类型下拉列表设置为 Zabbix Trapper。还要确保设置 Zabbix 应为此项目预期信息的类型。

此插件当前不批量发送。虽然可以这样做,但这不受支持。请注意不要用每秒过多的事件淹没您的 Zabbix 服务器。

如果缺少必要的字段,此插件将记录警告。如果 Zabbix 关闭,它不会尝试重新发送,但会记录一条错误消息。

Zabbix 输出配置选项编辑

此插件支持以下配置选项以及稍后描述的通用选项

另请参阅通用选项,以获取所有输出插件支持的选项列表。

 

multi_value编辑

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

使用 multi_value 指令发送多个键/值对。这可以被认为是一个数组,例如

[ zabbix_key1, zabbix_value1, zabbix_key2, zabbix_value2, ... zabbix_keyN, zabbix_valueN ]

…​其中 zabbix_key1zabbix_key 的实例,zabbix_value1zabbix_value 的实例。如果任何 zabbix_keyzabbix_value 引用的字段不存在,则该条目将被忽略。

此指令不能与单值指令 zabbix_keyzabbix_value 一起使用。

timeout编辑

  • 值类型为数字
  • 默认值为 1

尝试连接 Zabbix 服务器之前等待的秒数。此数字应该非常小,否则可能会导致其他输出的传送延迟。

zabbix_host编辑

  • 这是必填设置。
  • 值类型为字符串
  • 此设置没有默认值。

保存 Zabbix 主机名的字段名称。这可以是 @metadata 字段的子字段。

zabbix_key编辑

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

一个字段名称,用于保存您打算用作 Zabbix 项目键的值。这可以是 @metadata 字段的子字段。如果使用 multi_value,则此指令将被忽略。

如果未使用 multi_value,则 zabbix_key 是必需的。

zabbix_server_host编辑

  • 值类型为字符串
  • 默认值为 "localhost"

运行 Zabbix 服务器的 IP 或可解析主机名

zabbix_server_port编辑

  • 值类型为数字
  • 默认值为 10051

运行 Zabbix 服务器的端口

zabbix_value编辑

  • 值类型为字符串
  • 默认值为 "message"

保存要发送的值的字段名称。如果使用 multi_value,则此指令将被忽略。

通用选项编辑

以下配置选项受所有输出插件支持

设置 输入类型 必需

enable_metric

布尔值

id

字符串

enable_metric编辑

禁用或启用此特定插件实例的指标记录。默认情况下,我们会记录所有可以记录的指标,但您可以禁用特定插件的指标收集。

id编辑

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

向插件配置添加唯一的 ID。如果未指定 ID,Logstash 将生成一个。强烈建议在配置中设置此 ID。当您有两个或多个相同类型的插件时,这特别有用。例如,如果您有 2 个 zabbix 输出。在这种情况下,添加命名 ID 将有助于在使用监控 API 时监控 Logstash。

output {
  zabbix {
    id => "my_plugin_id"
  }
}

id 字段中的变量替换仅支持环境变量,不支持使用来自密钥存储的值。