Nagios 输出插件

编辑
  • 插件版本:v3.0.6
  • 发布日期:2018-04-06
  • 变更日志

对于其他版本,请参见 版本化插件文档

获取帮助

编辑

有关插件的问题,请在 Discuss 论坛中发起主题。对于错误或功能请求,请在 Github 中提交问题。有关 Elastic 支持的插件列表,请参阅 Elastic 支持矩阵

描述

编辑

Nagios 输出用于通过 Nagios 命令文件将被动检查结果发送到 Nagios。此输出当前支持 Nagios 3。

为了使此输出工作,您的事件必须具有以下 Logstash 事件字段

  • nagios_host
  • nagios_service

这些 Logstash 事件字段受支持,但可选

  • nagios_annotation
  • nagios_level(覆盖 nagios_level 配置选项)

有两个配置选项

  • commandfile - Nagios 外部命令文件的位置。默认为 /var/lib/nagios3/rw/nagios.cmd
  • nagios_level - 指定要发送的检查级别。默认为 CRITICAL,并且可以通过将“nagios_level”字段设置为“OK”、“WARNING”、“CRITICAL”或“UNKNOWN”之一来覆盖。

        output{
          if [message] =~ /(error|ERROR|CRITICAL)/ {
            nagios {
              # your config here
            }
          }
        }

Nagios 输出配置选项

编辑

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

设置 输入类型 必需

commandfile

<<,>>

nagios_level

字符串,其中之一为 ["0", "1", "2", "3"]

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

 

commandfile

编辑
  • 值类型为 字符串
  • 默认值为 "/var/lib/nagios3/rw/nagios.cmd"

Nagios 命令文件的完整路径。

nagios_level

编辑
  • 值可以是以下任何一个:0123
  • 默认值为 "2"

Nagios 检查级别。应为以下之一:0=OK、1=WARNING、2=CRITICAL、3=UNKNOWN。默认为 2 - CRITICAL。

通用选项

编辑

这些配置选项受所有输出插件支持

设置 输入类型 必需

codec

codec

enable_metric

布尔值

id

字符串

codec

编辑
  • 值类型为 codec
  • 默认值为 "plain"

用于输出数据的编解码器。输出编解码器是在数据离开输出之前对其进行编码的一种便捷方法,而无需在 Logstash 管道中使用单独的过滤器。

enable_metric

编辑

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

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

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

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

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