VictorOps 事件处理程序

VictorOps 是一个事件管理平台，提供可观测性、协作和实时警报。Kapacitor 可以配置为向 VictorOps 发送警报消息。

配置

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

[victorops]
  enabled = true
  api-key = "xxxx"
  routing-key = "xxxx"
  url = "https://alert.victorops.com/integrations/generic/20131114/alert"
  json-data = false
  global = false

enabled

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

api-key

您的 VictorOps API 密钥。

routing-key

默认的 VictorOps 路由密钥，可以针对每个警报进行覆盖。

url

VictorOps API URL。通常不需要更改。

json-data

将“data”字段设置为 JSON。

新安装的 VictorOps 会希望将其设置为 true，因为它使触发警报的数据在 VictorOps 中可用。默认值为 false 以保持向后兼容性。

global

如果设置为 true，所有警报都将发送到 VictorOps，而无需在 TICKscript 中显式指定 VictorOps。路由密钥仍然可以被覆盖。

选项

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

示例：处理程序文件

id: handler-id
topic: topic-name
kind: victorops
options:
  routing-key: ops_team

示例：TICKscript

|alert()
  // ...
  .victorOps()
    .routingKey('team_rocket')

VictorOps 设置

要允许 Kapacitor 向 VictorOps 发送警报，请执行以下操作

1. 在 VictorOps 仪表板的“集成”部分启用“警报摄取 API”。
2. 使用提供的 API 密钥作为 kapacitor.conf 中 [victorops] 部分的 api-key。

使用 VictorOps 事件处理程序

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

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

kapacitor.conf 中的 VictorOps 设置

[victorops]
  enabled = true
  api-key = "mysupersecretapikey"
  routing-key = "team_rocket"
  url = "https://alert.victorops.com/integrations/generic/20131114/alert"
  json-data = true
  global = false

从 TICKscript 将警报发送到 VictorOps 房间

以下 TICKscript 使用 .victorOps() 事件处理程序，每当空闲 CPU 使用率低于 10% 时，将消息“Hey, check your CPU”发送到 VictorOps。

victorops-cpu-alert.tick

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

从已定义处理程序将警报发送到 VictorOps 房间

以下设置将警报发送到 cpu 主题，消息为“Hey, check your CPU”。添加了一个 VictorOps 处理程序，该处理程序订阅 cpu 主题，并使用 kapacitor.conf 中定义的默认设置将所有警报消息发布到 VictorOps。

创建将警报消息发布到主题的 TICKscript。当空闲 CPU 使用率低于 10% 时，下面的 TICKscript 将警报消息发送到 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 主题并使用 VictorOps 事件处理程序将警报发送到 VictorOps 的处理程序文件。

victorops_cpu_handler.yaml

topic: cpu
id: victorops-cpu-alert
kind: victorops
options:
  routing-key: 'team_rocket'

添加处理器

kapacitor define-topic-handler victorops_cpu_handler.yaml