micado/prometheus_executor

micado/prometheus_executor镜像说明

镜像概述

micado/prometheus_executor是基于Prometheus监控体系的警报执行器镜像，用于接收Prometheus触发的警报信息，执行用户自定义脚本并发送REST API调用，实现警报的自动化响应与处理。

核心功能

1. 接收Prometheus警报数据
2. 执行用户放置在指定目录的自定义脚本
3. 为脚本注入包含警报状态、标签、注释等信息的环境变量
4. 通过REST API调用完成警报后续处理

使用场景

适用于Prometheus监控场景下的自动化响应需求，例如：

• 发送警报通知（邮件、短信、即时通讯工具）
• 触发系统故障自动恢复操作
• 记录警报日志到指定存储系统
• 联动其他运维工具进行问题排查

配置说明

1. 准备自定义脚本：将处理警报的脚本放置到宿主机的/etc/prometheus_executor目录
2. 挂载卷映射：通过Docker卷将宿主机的脚本目录映射到容器内的/etc/prometheus_executor路径

部署示例

Docker Run命令

bash
docker run -d -p 9095:9095 -v /etc/prometheus_executor/:/etc/prometheus_executor docker.xuanyuan.run/micado/prometheus_executor

脚本可用环境变量

执行脚本时会自动注入以下环境变量：

• AMX_RECEIVER: 触发警报的接收器名称
• AMX_STATUS: 警报状态（如firing、resolved）
• AMX_EXTERNAL_URL: Alertmanager的访问URL
• AMX_ALERT_LEN: 警报数量（用于遍历AMX_ALERT_<n>系列变量）
• AMX_LABEL_<label>: 警报的标签键值对（为实际标签名）
• AMX_GLABEL_<label>: 用于分组警报的标签键值对
• AMX_ANNOTATION_<key>: 警报的注释键值对（为实际注释键）
• AMX_ALERT_<n>_STATUS: 第n个警报的状态
• AMX_ALERT_<n>_START: 第n个警报的开始时间（纪元秒）
• AMX_ALERT_<n>_END: 第n个警报的结束时间（触发中为0）
• AMX_ALERT_<n>_URL: 第n个警报对应的Prometheus指标URL
• AMX_ALERT_<n>_LABEL_<label>: 第n个警报的标签键值对
• AMX_ALERT_<n>_ANNOTATION_<key>: 第n个警报的注释键值对