traumfewo/opsgenie-heartbeat-proxy

opsgenie-heartbeat-proxy

https://img.shields.io/docker/build/traumfewo/opsgenie-heartbeat-proxy.svg](https://hub.docker.com/r/traumfewo/opsgenie-heartbeat-proxy/)

现已支持OpsGenie Heartbeats Version 2

随着OpsGenie Heartbeats v2版本的推出，本代理工具已过时。若您希望不使用此代理发送心跳，只需将现有v1心跳迁移至v2（过程简单），具体步骤请参考心跳设置页面的说明。

您可使用如下接收器定义（灵感来自https://github.com/prometheus/alertmanager/pull/444#issuecomment-428493861%EF%BC%89%EF%BC%9A

- name: opsgenie
  webhook_configs:
  - url: 'https://api.opsgenie.com/v2/heartbeats/<the-heartbeat-name>/ping'
    send_resolved: false
    http_config:
      basic_auth:
        password: 123e4567-e89b-12d3-a456-426655440000

镜像概述

本镜像用于将Prometheus Alertmanager的webhook请求代理至OpsGenie Heartbeat API，以解决https://github.com/prometheus/alertmanager/pull/444%E3%80%82

核心功能

• 代理Prometheus Alertmanager的webhook请求到OpsGenie Heartbeat API
• 支持通过环境变量配置OpsGenie API密钥和心跳名称
• 提供调试模式（通过DEBUG环境变量启用）

使用场景

适用于需要将Prometheus监控系统与OpsGenie心跳服务集成的场景，尤其是在无法直接使用v2版本心跳时。

配置说明

环境变量

• OPSGENIE_API_KEY: 必选，OpsGenie平台的API密钥
• HEARTBEAT_NAME: 必选，OpsGenie中配置的心跳名称
• DEBUG: 可选，启用调试模式（值为true时生效）

Docker部署示例

bash
docker run -e OPSGENIE_API_KEY='<您的API密钥>' -e HEARTBEAT_NAME='<您的心跳名称>' -d -p 8080:8080 traumfewo/opsgenie-heartbeat-proxy:latest

Prometheus告警规则配置

创建持续触发的告警以调用代理：

yaml
ALERT OpsGenieHeartBeat
      IF vector(1)
      LABELS { app = "opsgenie" }
      ANNOTATIONS {
        description = "Ping OpsGenie heartbeat api.",
      }

Alertmanager配置

路由规则

yaml
- match:
    app: opsgenie
  receiver: opsgenieproxy
  continue: false

接收器配置

yaml
- name: opsgenieproxy
  webhook_configs:
  - send_resolved: false
    url: http://<容器IP>:8080/proxy

Kubernetes部署

若您在Kubernetes集群中运行Prometheus，可使用示例中的YAML文件部署本代理。若Prometheus在集群内运行，Service类型设为"ClusterIP"即可；若需外部访问，可将Service类型改为"Load***"以获取公网IP。