Kapacitor 事件处理程序

Kapacitor 可以通过将警报消息发送到支持的事件处理程序，集成到监控系统中。目前，Kapacitor 可以将警报消息发送到特定的日志文件和特定的 URL，以及许多第三方应用程序。

这些文档概述了官方支持的 Kapacitor 事件处理程序的配置选项、设置说明、处理程序文件和 TICKscript 语法。

配置事件处理程序

大多数事件处理程序的必需和默认配置选项在您的 Kapacitor 配置文件 kapacitor.conf 中配置。默认位置是 /etc/kapacitor/kapacitor.conf，但可能因您的 Kapacitor 设置而异。

许多事件处理程序提供可以在 TICKscript 或处理程序文件中定义的选项，而有些只能在处理程序文件中配置。这些可配置选项在每个处理程序的文档中概述。

添加和使用事件处理程序

如果适用，在您的 kapacitor.conf 中启用事件处理程序。启用后，执行以下操作之一

• 使用处理程序文件创建主题处理程序，然后添加处理程序。

• 在 TICKscript 中使用处理程序.

  注意： 并非所有事件处理程序都可以在 TICKscript 中使用。

使用处理程序文件创建主题处理程序

事件处理程序文件是一个简单的 YAML 或 JSON 文件，其中包含有关处理程序的信息。尽管可以在 TICKscript 中添加许多处理程序，但在 TICKscript 中管理多个处理程序可能很麻烦。处理程序文件允许您在 TICKscript 之外添加和使用处理程序。对于某些处理程序类型，使用处理程序文件是唯一的选择。

处理程序文件包含以下内容

• * ID：处理程序的唯一 ID。
• * Topic：处理程序订阅的主题。
• Match：用于筛选匹配警报的 Lambda 表达式。默认情况下，所有警报都匹配。了解更多关于匹配表达式的信息。
• * Kind：处理程序的类型。
• Options：由处理程序类型确定的可配置选项。如果未提供任何选项，则使用在 kapacitor.conf 中为处理程序定义的默认值。

id: handler-id
topic: topic-name
match: changed()
kind: slack
options:
  channel: '#oh-nos'

添加处理程序

使用 Kapacitor CLI 通过处理程序文件定义新的处理程序

# Syntax
kapacitor define-topic-handler <handler-file-name>

# Example
kapacitor define-topic-handler slack_cpu_handler.yaml

在 TICKscript 中使用处理程序

许多事件处理程序可以直接在 TICKscript 中使用以发送事件。这通常通过将消息发送到第三方的处理程序来完成。以下是使用 .slack() 事件处理程序将 CPU 警报发布到 Slack 的 TICKscript 示例

stream
  |from()
    .measurement('cpu')
  |alert()
    .crit(lambda: "idle_usage" < 10)
    .message('You better check your CPU usage.')
    .slack()