PagerDuty v2 事件处理程序

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

此页面特定于 PagerDuty 的 v2 API。如果您仍在使用其 v1 API，请参阅 PagerDuty v1 事件处理程序 文档。

配置

PagerDuty v2 事件处理程序的配置以及默认 选项 值在您的 kapacitor.conf 文件中设置。下面是一个配置示例

[pagerduty2]
  enabled = true
  routing-key = ""
  url = "https://events.pagerduty.com/v2/enqueue"
  global = false

enabled

设置为 true 以启用 PagerDuty v2 事件处理程序。

routing-key

您的 PagerDuty 路由密钥。

url

PagerDuty API v2 URL。这通常不需要更改。

global

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

选项

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

示例：处理程序文件

id: handler-id
topic: topic-name
kind: pagerduty2
options:
  routing-key: 'myroutingkey'
  links:
    - href: 'https://chronograf.example.com/sources/1/dashboards/2'
      text: 'Overview Dashboard'
    - href: 'https://chronograf.example.com/'

示例：TICKscript

|alert()
  // ...
  .pagerDuty2()
    .routingKey('myroutingkey')
    .link('https://chronograf.example.com/sources/1/dashboards/2', 'Overview Dashboard')
    .link('https://chronograf.example.com/')

PagerDuty 设置

要允许 Kapacitor 向 PagerDuty 发送警报，请启用一个新的“Generic API”集成。将生成的“Integration Key”用作 kapacitor.conf 文件 [pagerduty2] 部分下的 routing-key。

使用 PagerDuty v2 事件处理程序

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

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

kapacitor.conf 中的 PagerDuty v2 设置

[pagerduty2]
  enabled = true
  routing-key = "myroutingkey"
  url = "https://events.pagerduty.com/v2/enqueue"
  global = false

从 TICKscript 发送警报到 PagerDuty

下面的 TICKscript 使用 .pagerDuty2() 事件处理程序，每当空闲 CPU 使用率降至 10% 以下时，都会发送消息“嘿，检查你的 CPU”。

pagerduty2-cpu-alert.tick

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

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

以下设置将警报消息“嘿，检查你的 CPU”发送到 cpu 主题。添加了一个 PagerDuty v2 处理程序，该处理程序订阅 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 v2 事件处理程序将警报发送到 PagerDuty 的处理程序文件。

pagerduty2_cpu_handler.yaml

topic: cpu
id: pagerduty2-cpu-alert
kind: pagerduty2
options:
  routing-key: 'myroutingkey'

添加处理器

kapacitor define-topic-handler pagerduty2_cpu_handler.yaml