cycloid/alertmanager-cycloid-events-receiver

alertmanager-cycloid-events-receiver

镜像概述

alertmanager-cycloid-events-receiver是一个基于Alertmanager webhook通知在Cycloid平台（[***] API信息创建对应的平台事件。

核心功能

• 接收Alertmanager的webhook告警通知并解析
• 通过告警中的UUID标签匹配对应的Cycloid配置
• 使用Cycloid API向指定组织发送事件

使用场景

适用于需要将Prometheus/Alertmanager监控系统的告警事件同步到Cycloid平台的场景，实现监控告警与Cycloid事件系统的集成，便于统一事件管理和处理。

使用方法

提供配置文件

接收器使用Cycloid API用户访问权限发送事件，需通过配置文件定义不同UUID对应的Cycloid访问信息。接收器会从告警的UUID标签读取信息以匹配相应配置。

配置文件格式（YAML）：

yaml
---
uuids:
  12-34-56-78:  # UUID标识，需与告警标签中的UUID对应
    api_url: "https://http-api.cycloid.io"  # Cycloid API地址
    organization: "..."  # Cycloid组织名称
    api_key: ".."  # Cycloid API访问密钥

配置Prometheus规则

需在Prometheus告警规则中添加UUID标签，确保告警携带与配置文件匹配的UUID。

Prometheus告警规则示例：

alert: NodeCPUUsage
expr: (100
  - (avg by(instance) (irate(node_cpu_seconds_total{mode="idle",name="node-exporter"}[5m])) * 100)) > 90
for: 5m
labels:
  UUID: 12-34  # 与配置文件中的UUID匹配
  severity: critical
annotations:
  description: '{{$labels.instance}}: CPU usage is above 90% (current value is: {{ $value }})'
  summary: '{{$labels.instance}}: High CPU usage detected'

配置Alertmanager Webhook插件

在Alertmanager配置中添加webhook接收器，指向cycloid-events-receiver服务地址。

Alertmanager配置示例：

- name: 'cycloid-events-receiver'
  webhook_configs:
  - url: 'http://localhost:5000'  # 接收器服务地址，根据实际部署调整
    send_resolved: true  # 是否发送已解决状态的告警

手动测试Cycloid事件接收器

启动接收器容器

本地启动接收器服务：

bash
docker run -p 5000:5000 -it cycloid/alertmanager-cycloid-events-receiver:latest

发送测试通知

使用curl发送测试告警数据：

bash
msg='{
  "version": "4",
  "groupKey": "fakegroupkey",
  "status": "firing",
  "receiver": "cycloid_alert",
   "groupLabels":{  
      "alertname":"FooBar",
      "customer":"cycloid",
      "env":"infra",
      "project":"monitoring"
   },
  "externalURL": "http://localhost:9093",
  "alerts": [
      {  
         "status":"firing",
         "labels":{  
            "Name":"prometheus",
            "alertname":"OpsgenieHeartbeat",
            "branch":"HEAD",
            "client":"cycloid",
            "customer":"cycloid",
            "env":"infra",
            "goversion":"go1.10.3",
            "instance":"localhost:9090",
            "job":"prometheus",
            "project":"monitoring",
            "receiver":"alert_cycloid",
            "revision":"71af5e29e815795e9dd***ee7725682fa14b7b",
            "role":"prometheus",
            "severity":"critical",
            "version":"2.3.2"
         },
         "annotations":{  
            "description":"Test if prometheus and alert manager still working",
            "summary":"Prometheus and alertmanager service working"
         },
         "startsAt":"2018-11-30T09:13:59.926854139Z",
         "endsAt":"0001-01-01T00:00:00Z",
         "generatorURL":"[***]"
      }
  ],
  "commonLabels" : {
     "UUID" : "12-34"  # 需与配置文件中的UUID匹配
  }
}'
curl -X POST --header "Content-Type: application/json" --data "${msg}" http://localhost:5000/