quintoandar/spot-termination-exporter

Spot实例终止通知Exporter

该镜像为Prometheus exporter工具，用于抓取AWS Spot实例的终止通知信息，并将其导出为Prometheus可识别的指标，支持与Hollowtrees集成以实现Spot实例的生命周期管理。

核心功能

• 定期查询AWS实例元数据端点，获取Spot实例的终止通知信息
• 将终止通知转换为Prometheus指标（如实例是否即将终止、剩余终止时间等）
• 支持配置监听地址、日志级别、元数据端点及指标路径
• 提供本地测试用的模拟元数据服务器，方便开发调试

使用场景

• AWS Spot实例的实时监控，及时发现即将终止的实例
• 与Hollowtrees集成，自动处理Spot实例中断事件（如迁移工作负载）
• 纳入Prometheus监控体系，构建Spot实例稳定性告警规则

配置说明

启动exporter时可通过命令行参数配置以下选项：

• --bind-addr：指标服务器绑定地址（默认：":9189"）
• --log-level：日志级别（默认："info"）
• --metadata-endpoint：元数据查询端点（默认："[***]"）
• --metrics-path：指标端点路径（默认："/metrics"）

Docker部署示例

基础运行

bash
docker run -d -p 9189:9189 --name spot-termination-exporter quintoandar/spot-termination-exporter

自定义配置

bash
docker run -d -p 9189:9189 --name spot-termination-exporter \
  quintoandar/spot-termination-exporter \
  --log-level debug \
  --bind-addr ":9189"

指标示例

# HELP aws_instance_termination_imminent 实例是否即将终止
# TYPE aws_instance_termination_imminent gauge
aws_instance_termination_imminent{availability_zone="us-east-1a",hostname="ip-10-23-24-150.ec2.internal",instance_id="i-05f2236177d4ba9ca",instance_type="m4.2xlarge",instance_action="terminate"} 1
# HELP aws_instance_termination_in 实例剩余终止时间（秒）
# TYPE aws_instance_termination_in gauge
aws_instance_termination_in{availability_zone="us-east-1a",hostname="ip-10-23-24-150.ec2.internal",instance_id="i-05f2236177d4ba9ca",instance_type="m4.2xlarge",instance_action="terminate"} 119.888545