如何将GCP告警接入Opsgenie告警系统实现自动告警流转

没有官方直接集成的情况下，有两种可落地的实现路径，优先推荐云函数中转方案，自定义程度和稳定性更高。

方案1：GCP Cloud Function 中转（推荐） #

核心思路是用云函数作为中间层，做GCP告警到Opsgenie API的格式转换和请求转发：

• 第一步：在Opsgenie侧生成API密钥
  进入Opsgenie集成配置页，创建API类型的集成，勾选告警创建权限后生成密钥，保存好密钥后续会用到。
• 第二步：编写云函数代码
  运行环境可选择Python/Node.js等常用语言，核心逻辑是接收GCP告警的POST请求，解析告警核心字段后按照Opsgenie API要求格式化，再发起请求推送。以下是Python版本的核心代码示例：

  import requests
  import os
  
  # 密钥存在云函数环境变量里，不要硬编码
  OPSGENIE_API_KEY = os.environ.get('OPSGENIE_API_KEY')
  OPSGENIE_ALERT_API = "https://api.opsgenie.com/v2/alerts"
  
  def forward_gcp_alert(request):
      gcp_alert_data = request.get_json()
      incident_info = gcp_alert_data.get("incident", {})
      # 格式化Opsgenie告警请求体
      opsgenie_payload = {
          "message": f"GCP VM高CPU告警：{incident_info.get('resource_display_name', '未知实例')}",
          "description": f"告警策略：{incident_info.get('policy_name', '未知策略')}\n触发时间：{incident_info.get('started_at', '未知时间')}\n实例ID：{incident_info.get('resource_id', '未知ID')}",
          "priority": "P3",
          "tags": ["GCP", "VM", "CPU使用率告警"]
      }
      req_headers = {
          "Content-Type": "application/json",
          "Authorization": f"GenieKey {OPSGENIE_API_KEY}"
      }
      resp = requests.post(OPSGENIE_ALERT_API, json=opsgenie_payload, headers=req_headers)
      return {"status": "forward success", "opsgenie_resp": resp.json()}, resp.status_code
  

• 第三步：配置云函数触发器
  触发器类型选择HTTP触发器，可根据安全需求选择允许未认证调用或者配置GCP服务账号鉴权，复制生成的云函数触发URL。
• 第四步：修改GCP告警通知配置
  找到已配置的VM高CPU使用率告警策略，在通知渠道中新增Webhook类型，填入上一步复制的云函数触发URL后保存。
• 第五步：测试验证
  可以手动拉高测试VM的CPU触发告警，或者使用GCP自带的告警测试功能，确认Opsgenie侧可以正常接收告警、字段展示正常。

方案2：直接Webhook对接（轻量但自定义程度低） #

如果不想额外维护云函数，也可以直接把GCP告警的Webhook对接Opsgenie的告警API，仅适合简单告警场景：

• 在GCP告警的Webhook配置里，直接填Opsgenie的告警API地址，额外添加请求头Authorization: GenieKey 你的Opsgenie API密钥
• 该方案不需要额外资源，但GCP原生告警字段和Opsgenie要求的格式不完全匹配，可能出现字段展示混乱的问题，需要提前做字段映射测试。

常见问题排查 #

• 告警推送失败优先查看云函数运行日志，确认是参数解析错误还是API鉴权错误
• Opsgenie侧收不到告警先检查API密钥的权限，确保已经开启告警创建权限
• 重复告警可以在Opsgenie侧配置去重规则，使用GCP告警的incident ID作为去重key即可

内容的提问来源于stack exchange，提问作者Poobalan