Kapacitor 告警概述

Kapacitor 允许以两种不同的方式处理告警消息。

• 消息可以直接推送到通过 Alert 节点暴露的事件处理程序。
• 消息可以发布到一个主题命名空间，一个或多个告警处理程序可以订阅该命名空间。

无论使用哪种方法，处理程序都需要在 配置文件 中启用和配置。如果处理程序需要敏感信息，如令牌和密码，它也可以使用 Kapacitor HTTP API 进行配置。

推送到处理程序

将消息推送到处理程序是《Kapacitor 入门》指南中介绍的基本方法。这只需要调用 alert 节点提供的相关链接方法即可。消息可以推送到 log() 文件、email() 服务、httpOut() 缓存以及许多 第三方服务。

发布和订阅

告警主题只是一个用于对告警进行分组的命名空间。当触发告警事件时，它可以发布到一个主题。多个处理程序可以订阅（可以绑定）到该主题，并且所有处理程序都会处理该主题的每个告警事件。处理程序通过 kapacitor 命令行客户端和处理程序绑定文件绑定到主题。处理程序绑定文件可以用 yaml 或 json 编写。它们包含四个主要字段和一个可选字段。

• topic: 声明处理程序将订阅的主题。
• id: 声明绑定的身份。
• kind: 声明要使用的事件处理程序的类型。请注意，这需要在 kapacitord 配置文件中启用。
• match: (可选) 声明一个匹配表达式，用于过滤将要处理的告警事件。请参阅下面的 匹配表达式 部分。
• options: 特定于所讨论的处理程序的选项。这些在下面的 处理程序列表 部分列出。

示例 1：用于 slack 处理程序和 cpu 主题的处理程序绑定文件

topic: cpu
id: slack
kind: slack
options:
  channel: '#kapacitor'

示例 1 可以保存到名为 slack_cpu_handler.yaml 的文件中。

然后可以使用命令行客户端将其生成为 Kapacitor 主题处理程序。

$ kapacitor define-topic-handler slack_cpu_handler.yaml

也可以通过 HTTP API 创建处理程序绑定。请参阅 HTTP API 文档的 创建处理程序 部分。

有关定义和使用告警主题的演练，请参阅 使用告警主题 演练。

处理程序

处理程序会对特定主题的传入告警事件执行操作。每个处理程序只处理一个主题。

处理程序列表

以下是可用的告警事件处理程序列表

匹配表达式

告警处理程序支持匹配表达式，用于过滤处理程序将处理的告警事件。

匹配表达式是 TICKscript lambda 表达式。触发告警的数据对匹配表达式可用，包括所有字段和标签。

除了触发告警的数据之外，还可以获取有关告警的元数据。此告警元数据可通过各种函数访问。

此外，还定义了变量 OK、INFO、WARNING 和 CRITICAL，以对应 level 函数的返回值。

例如，要只将 critical 告警发送到处理程序，请使用此匹配表达式

match: level() == CRITICAL

示例

仅将更改的事件发送到处理程序

match: changed() == TRUE

仅将 WARNING 和 CRITICAL 事件发送到处理程序

match: level() >= WARNING

将标签 “host” 等于 s001.example.com 的事件发送到处理程序

match: "\"host\" == 's001.example.com'"

告警事件数据

发送到处理程序的每个告警事件都包含以下告警数据

此数据由 事件处理程序 在处理告警事件时使用。

告警消息使用 Golang Template，并且可以访问告警数据。

|alert()
  // ...
  .message('{{ .ID }} is {{ .Level }} value:{{ index .Fields "value" }}, {{ if not .Recoverable }}non-recoverable{{ end }}')