banzaicloud/spot-termination-exporter

Spot Instance Termination Exporter 镜像概述

该镜像为Prometheus exporter工具，用于从AWS实例元数据端点抓取Spot实例终止通知，并将指标导出为Prometheus兼容格式，支持与Hollowtrees集成实现自动化运维响应。

核心功能

1. 终止通知监控：定期查询AWS实例元数据端点，检测Spot实例是否被标记为终止。
2. 指标导出：生成元数据服务可用性、终止紧迫性、剩余终止时间等Prometheus指标。
3. 灵活配置：支持自定义绑定地址、日志级别、元数据端点及指标路径。

使用场景

• AWS Spot实例运维：提前2分钟获取终止通知，为工作负载迁移或备份争取时间。
• 自动化响应：与Hollowtrees集成，触发实例迁移、备份等自动化操作。
• 监控面板集成：将终止指标接入Prometheus仪表板，统一监控实例状态。

配置说明

可配置参数

启动时支持以下命令行参数：

• --bind-addr：指标服务绑定地址（默认:9189）。
• --log-level：日志级别（默认info，可选debug/warn/error）。
• --metadata-endpoint：元数据查询端点（默认AWS实例元数据地址http://169.254.169.254/latest/meta-data/）。
• --metrics-path：指标暴露路径（默认/metrics）。

Docker部署示例

基础运行命令：

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

带自定义配置的运行命令：

bash
docker run -d -p 9189:9189 banzaicloud/spot-termination-exporter \
  --log-level debug \
  --metadata-endpoint http://localhost:9092/latest/meta-data/

本地测试

使用工具目录中的测试服务器模拟元数据端点：

1. 启动测试服务器（需本地安装Go环境）：

   bash
   go run util/test_server.go
   

2. 启动exporter指向测试端点：

   bash
   docker run -d -p 9189:9189 banzaicloud/spot-termination-exporter \
     --metadata-endpoint http://host.docker.internal:9092/latest/meta-data/ \
     --log-level debug
   

导出指标说明

该exporter暴露以下Prometheus指标：

• aws_instance_metadata_service_available：元数据服务是否可用（gauge类型，1=可用）。
• aws_instance_termination_imminent：实例是否即将终止（gauge类型，1=是）。
• aws_instance_termination_in：实例剩余终止时间（秒，gauge类型）。

与Hollowtrees集成

该exporter是Hollowtrees默认关联的节点工具之一，可与以下组件配合使用：

• AWS Spot实例终止collector：https://github.com/banzaicloud/spot-termination-collector
• AWS自动扩缩容exporter：https://github.com/banzaicloud/aws-autoscaling-exporter