opensourceelectrolux/aws-cost-exporter

镜像概述

该Docker镜像用于从AWS获取成本相关数据，并将其转换为标准Prometheus指标格式暴露，支持集成到Prometheus监控体系，实现AWS成本的实时监控、分析与可视化。

核心功能和特性

• AWS Cost Explorer集成：通过AWS Cost Explorer API获取成本、使用量等详细数据
• 标准Prometheus指标：输出符合Prometheus数据模型的指标，支持直接抓取
• 可配置抓取频率：自定义数据更新间隔，平衡监控精度与API调用成本
• 多维度指标：涵盖总成本、服务级成本、标签维度成本、预测成本等关键指标
• 多账户支持：通过IAM配置支持监控多个AWS账户的成本数据

使用场景和适用范围

• AWS成本实时监控：7x24小时监控AWS资源支出，替代手动查询Cost Explorer
• 成本异常检测：结合Prometheus Alertmanager配置告警规则，及时发现成本突增
• 资源优化分析：通过历史成本指标分析资源使用效率，识别优化空间
• 成本可视化：与Grafana集成构建多维度成本仪表盘（按服务、区域、标签等）
• DevOps成本治理：嵌入CI/CD流程，实现成本与开发流程的联动管理

使用方法和配置说明

前提条件

• AWS账户需具备Cost Explorer API访问权限（推荐附加AmazonCostExplorerReadOnlyAccess策略）
• 已安装Docker环境
• 运行Prometheus服务（用于指标抓取）

环境变量配置

Docker Run命令示例

bash
docker run -d \
  --name aws-cost-exporter \
  -p 9090:9090 \
  -e AWS_ACCESS_KEY_ID="AKIAXXXXXXXXXXXX" \
  -e AWS_SECRET_ACCESS_KEY="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -e AWS_REGION="us-east-1" \
  -e SCRAPE_INTERVAL="30" \
  aws-cost-prometheus-exporter:latest

Docker Compose配置示例

yaml
version: '3'
services:
  aws-cost-exporter:
    image: aws-cost-prometheus-exporter:latest
    container_name: aws-cost-exporter
    ports:
      - "9090:9090"
    environment:
      - AWS_ACCESS_KEY_ID=AKIAXXXXXXXXXXXX
      - AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
      - AWS_REGION=us-east-1
      - SCRAPE_INTERVAL=30
      - INCLUDE_TAGS=true
    restart: unless-stopped

Prometheus抓取配置

在Prometheus配置文件中添加如下job：

yaml
scrape_configs:
  - job_name: 'aws-cost'
    static_configs:
      - targets: ['aws-cost-exporter:9090']  # 容器IP或服务名:端口
    scrape_interval: 60s  # 建议与SCRAPE_INTERVAL保持一致

指标验证

容器启动后，可通过http://<容器IP>:9090/metrics访问指标端点，示例输出：

aws_cost_total{account_id="123456789012",region="us-east-1"} 1560.85
aws_cost_service{service="AmazonEC2",account_id="123456789012"} 890.50
aws_cost_forecast{account_id="123456789012"} 6200.00
aws_cost_tag{tag_key="env",tag_value="prod",account_id="123456789012"} 950.20