PagerDuty v1 事件处理器

PagerDuty 是一个事件管理平台，可帮助团队快速检测和修复基础设施问题。Kapacitor 可以配置为向 PagerDuty 发送告警消息。

配置

Kapacitor v1 事件处理器的配置以及默认 选项 值在 kapacitor.conf 中设置。下面是一个示例配置

[pagerduty]
  enabled = true
  service-key = ""
  url = "https://events.pagerduty.com/generic/2010-04-15/create_event.json"
  global = false

enabled

设置为 true 以启用 PagerDuty v1 事件处理器。

service-key

您的 PagerDuty 服务密钥。

url

PagerDuty API v1 URL。通常不需要更改此项。

global

如果设置为 true，所有告警都将发送到 PagerDuty，而无需在 TICKscripts 中显式指定 PagerDuty。

选项

以下 PagerDuty v1 事件处理器选项可以在 处理程序文件 中设置，或者在使用 TICKscript 中的 .pagerDuty() 时设置。

示例：处理程序文件

id: handler-id
topic: topic-name
kind: pagerduty
options:
  service-key: 'myservicekey'

示例：TICKscript

|alert()
  // ...
  .pagerDuty()
    .serviceKey('myservicekey')

PagerDuty 设置

为了让 Kapacitor 向 PagerDuty 发送告警，请启用新的“Generic API”集成。使用生成的“Integration Key”作为 kapacitor.conf 中 [pagerduty] 部分下的 service-key。

使用 PagerDuty v1 事件处理器

在 kapacitor.conf 中启用 PagerDuty v1 事件处理器后，请在 TICKscripts 中使用 .pagerDuty() 属性将告警发送到 PagerDuty，或者定义一个订阅主题并将已发布告警发送到 PagerDuty 的 PagerDuty v1 处理程序。

以下示例使用了在 kapacitor.conf 中定义的以下 PagerDuty v1 配置

kapacitor.conf 中的 PagerDuty v1 设置

[pagerduty]
  enabled = true
  service-key = "myservicekey"
  url = "https://events.pagerduty.com/generic/2010-04-15/create_event.json"
  global = false

从 TICKscript 发送告警到 PagerDuty

以下 TICKscript 使用 .pagerDuty() 事件处理器，每当空闲 CPU 使用率降至 10% 以下时，都会发送消息“Hey，check your CPU”。

pagerduty-cpu-alert.tick

stream
  |from()
    .measurement('cpu')
  |alert()
    .crit(lambda: "usage_idle" < 10)
    .message('Hey, check your CPU')
    .pagerDuty()

从已定义处理程序发送告警到 PagerDuty

以下设置将告警发送到 cpu 主题，消息为“Hey，check your CPU”。添加了一个 PagerDuty v1 处理程序，该处理程序订阅 cpu 主题并将所有告警消息发布到 PagerDuty。

创建一个将警报消息发布到主题的 TICKscript。下面的 TICKscript 在 CPU 空闲使用率低于 10% 时（或 CPU 使用率高于 90%）向 cpu 主题发送警报消息。

cpu_alert.tick

stream
  |from()
    .measurement('cpu')
  |alert()
    .crit(lambda: "usage_idle" < 10)
    .message('Hey, check your CPU')
    .topic('cpu')

添加并启用 TICKscript

kapacitor define cpu_alert -tick cpu_alert.tick
kapacitor enable cpu_alert

创建一个订阅 cpu 主题并使用 PagerDuty v1 事件处理器将告警发送到 PagerDuty 的处理程序文件。

pagerduty_cpu_handler.yaml

topic: cpu
id: pagerduty-cpu-alert
kind: pagerduty
options:
  service-key: 'myservicekey'

添加处理器

kapacitor define-topic-handler pagerduty_cpu_handler.yaml