dolevelad/aws-audit-exporter

Prometheus AWS计费信息导出器

镜像概述

该镜像提供Prometheus导出器功能，主要用于收集AWS各类资源的统计数据（如EC2实例、预留实例、Spot实例等），并将其转换为Prometheus可识别的监控指标，同时支持将数据持久化到关系型数据库，帮助用户监控AWS资源使用情况与计费成本。

核心功能

• 收集EC2实例的数量、归一化单位等指标，附带实例标签、可用区、实例类型等标签信息；
• 监控EC2预留实例的数量、单价、到期时间等指标，跟踪预留实例生命周期；
• 统计EC2市场预留实例的列表信息（价格、剩余时长等）；
• 跟踪Spot实例请求的竞价价格、实际支付价格及运行数量；
• 记录Spot实例当前市场价格；
• 支持将数据保存到PostgreSQL数据库，实现长期数据留存与聚合分析。

使用场景

• AWS资源成本监控与优化；
• 预留实例到期预警；
• Spot实例价格趋势分析；
• 多维度AWS资源使用情况统计。

配置说明

1. AWS凭证配置

• 方式一：将凭证存放在$HOME/.aws/credentials文件中；
• 方式二：通过环境变量AWS_ACCESS_KEY和AWS_SECRET_ACCESS_KEY设置。

2. 运行参数

• -addr: 监听端口（默认":9190"）；
• -duration: API查询间隔（默认4分钟）；
• -instance-tags: 作为指标标签的EC2实例标签键（逗号分隔）；
• -region: 查询的AWS区域（默认"us-east-1"）。

3. IAM角色权限

需具备以下EC2操作权限：

json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "ec2:DescribeInstances",
        "ec2:DescribeReservedInstances*",
        "ec2:DescribeSpot*",
        "ec2:DescribeVpcClassicLink"
      ],
      "Resource": ["*"],
      "Effect": "Allow"
    }
  ]
}

4. PostgreSQL数据库配置

• 启用hstore扩展：CREATE EXTENSION hstore;（需特权用户执行）；
• 支持PostgreSQL 9.6及以上版本（经RDS测试）。

Docker部署示例

单容器运行

bash
docker run -d \
  -p 9190:9190 \
  -e AWS_ACCESS_KEY=<你的访问密钥> \
  -e AWS_SECRET_ACCESS_KEY=<你的秘密密钥> \
  dolevelad/aws-audit-exporter \
  -region cn-north-1 \
  -duration 5m \
  -instance-tags Name,Environment

Docker Compose配置

yaml
version: '3'
services:
  aws-audit-exporter:
    image: dolevelad/aws-audit-exporter
    ports:
      - "9190:9190"
    environment:
      - AWS_ACCESS_KEY=<你的访问密钥>
      - AWS_SECRET_ACCESS_KEY=<你的秘密密钥>
    command: ["-region", "cn-north-1", "-duration", "5m", "-instance-tags", "Name,Environment"]