告警接入

概述

1Duty 通过集成(Integration)和Webhook接入外部告警。集成是告警接入的顶层组织单元，一个集成可以包含多个 Webhook，每个 Webhook 对应一个监控源或告警通道。

通过这种设计，你可以灵活地将来自不同监控系统的告警统一汇聚到 1Duty 平台，实现集中管理和自动化处理。

支持的集成类型

1Duty 目前支持 20 种集成类型，覆盖主流监控和告警平台：

基础设施监控

云服务

APM (应用性能监控)

日志与数据库

国产监控

通用与第三方

创建集成

按照以下步骤创建一个新的集成：

1. 进入「告警管理」菜单，点击「告警接入」
2. 点击页面右上角的「新建集成」按钮
3. 填写集成的名称和描述信息
4. 选择需要关联的团队，将集成绑定到特定团队
5. 点击「保存」完成创建

创建 Webhook

集成创建完成后，需要在集成下添加 Webhook 来接收告警数据：

1. 进入集成详情页面
2. 点击「添加 Webhook」按钮
3. 选择 Webhook 类型（如 Prometheus、Grafana 等）
4. 系统将自动生成唯一的 Webhook URL 和 webhook_key
5. 将生成的 Webhook URL 配置到对应的监控系统中

配置监控系统

获取 Webhook URL 后，需要在监控系统中进行相应配置。以下是常见监控系统的配置示例。

Prometheus AlertManager

在 AlertManager 的配置文件 alertmanager.yml 中添加 Webhook 接收器：

receivers:
  - name: '1duty'
    webhook_configs:
      - url: 'https://api.1duty.com/webhook/your-webhook-url'
        send_resolved: true

route:
  receiver: '1duty'
  group_by: ['alertname', 'instance']
  group_wait: 30s
  group_interval: 5m
  repeat_interval: 4h

Grafana

在 Grafana 中配置 Webhook 告警通道：

1. 进入 Grafana 的 Alerting > Contact points
2. 点击「New contact point」
3. 选择 Integration 类型为「Webhook」
4. 在 URL 字段中填写 1Duty 生成的 Webhook URL
5. HTTP Method 选择 POST
6. 保存并在告警规则中使用该 Contact point

预处理规则

1Duty 支持在告警数据进入系统前通过预处理规则对其进行转换和调整。预处理规则分为两类：

固定值规则

通过预定义的操作对告警字段进行修改：

• 修改标题 - 替换或追加告警标题内容
• 修改描述 - 替换或追加告警描述内容
• 修改级别 - 强制将告警级别设置为指定值
• 过滤 - 根据条件丢弃不需要的告警

脚本规则

通过 Aviator 表达式编写自定义处理逻辑，适用于复杂场景。Aviator 是一个高性能的表达式引擎，支持字符串操作、逻辑判断、正则匹配等。

## 示例：根据告警来源修改级别
if string.contains(title, "OOM") then
  severity = "critical"
elsif string.contains(title, "CPU") then
  severity = "warning"
end

系统增强字段 (reserved_keys)

当告警数据进入 1Duty 后，系统会自动添加一组增强字段，用于后续的降噪和分派处理：