3. Opsgenie 集成方式总览

Opsgenie 提供了多种集成通道，用于将告警源、协作工具与值班编排系统连接起来。根据接入场景的不同，集成方式可分为邮件集成、API 集成、Webhook 集成以及第三方工具集成（PagerDuty、Slack、Jira）。本章将逐一梳理各集成方式的核心原理、适用场景与配置要点，帮助你在值班自动化基线核验中快速定位正确的集成路径。

3.1 邮件集成

邮件集成是最轻量的接入方式，Opsgenie 会为每个集成生成一个专属的收件邮箱地址。告警源将告警内容以邮件形式发送至该地址，Opsgenie 解析邮件正文并创建告警。

• 适用场景： 老旧监控系统、不支持 API 或 Webhook 的遗留工具、快速原型验证。
• 配置要点： 在 Opsgenie 中创建“Email Integration”，获取 team-domain@opsgenie.net 格式的邮箱；在告警源中配置邮件通知目标为此邮箱。
• 解析规则： 支持通过邮件主题、正文关键词提取告警标题、描述、优先级和标签。
• 局限性： 延迟较高（依赖邮件投递）、无法双向同步、不适合高频告警。

3.2 API 集成

API 集成通过 Opsgenie 的 RESTful API 直接创建、更新、关闭告警，是生产环境中最常用的集成方式。支持 JSON 格式的告警载荷，可携带丰富的自定义字段。

• 适用场景： 自研监控系统、CI/CD 流水线、需要精细控制告警属性的场景。
• 配置要点： 在 Opsgenie 中创建“API Integration”，获取 ；告警源通过 HTTP POST 请求发送至 https://api.opsgenie.com/v2/alerts。
• 认证方式： 在请求头中添加 Authorization: GenieKey YOUR_。
• 关键字段： message（必填）、alias（去重标识）、priority（P1-P5）、responders（指定值班人/团队）。

# 示例：通过 cURL 创建告警
curl -X POST "https://api.opsgenie.com/v2/alerts" \
  -H "Authorization: GenieKey 12345678-abcd-efgh-ijkl-9876543210" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "生产环境 CPU 使用率超过 90%",
    "alias": "cpu-high-prod-20250321",
    "priority": "P1",
    "source": "Prometheus",
    "responders": [{"type": "team", "id": "team-uuid-xxx"}]
  }'

3.3 Webhook 集成

Webhook 集成允许 Opsgenie 将告警状态变更（如创建、确认、关闭）实时推送到外部系统。与 API 集成相反，Webhook 是 Opsgenie 主动向外发送数据。

• 适用场景： 将告警同步到内部工单系统、自定义通知渠道、自动化故障响应流程。
• 配置要点： 在 Opsgenie 中创建“Webhook Integration”，配置目标 URL（需公网可达或内网代理可达）；可选添加自定义 Header 和 Secret 用于鉴权。
• 载荷格式： Opsgenie 发送 JSON 格式的告警对象，包含 alertId、message、action（Create/Acknowledge/Close 等）、timestamp。
• 重试机制： 若目标 URL 返回非 2xx 状态码，Opsgenie 会按指数退避策略重试最多 3 次。

3.4 第三方工具集成

Opsgenie 原生支持与 PagerDuty、Slack、Jira 等主流协作工具的集成，实现告警的双向同步与自动化流转。

3.5 集成方式对比与选型建议

3.6 集成基线核验清单

在完成任意一种集成配置后，建议按以下清单逐项核验，确保集成链路可用且符合值班自动化基线要求。