cashapp/yet-another-aws-exporter

AWS Prometheus指标导出器

镜像概述和主要用途

该镜像提供一个与Prometheus兼容的AWS指标导出器，专为填补Amazon CloudWatch监控覆盖盲区设计。它能够采集CloudWatch未提供的AWS服务指标，帮助用户构建更全面的AWS云环境监控体系，适用于需要深入监控AWS资源和服务的场景。

核心功能和特性

• 补充CloudWatch覆盖：采集CloudWatch未原生支持的AWS服务指标
• Prometheus兼容：输出Prometheus标准格式指标，无缝集成Prometheus监控系统
• 灵活配置：支持通过环境变量或配置文件自定义指标采集规则
• 资源自动发现：自动发现AWS账户内的资源，减少手动配置工作量
• 低资源消耗：轻量级设计，对AWS资源和本地系统资源占用低
• 多服务支持：覆盖EC2、S3、RDS、Lambda等多种AWS核心服务

使用场景和适用范围

• AWS云环境的全面监控需求
• Prometheus监控体系下的AWS指标采集
• 需要CloudWatch未提供的精细化指标的场景
• DevOps团队构建AWS服务监控看板
• 云资源优化和成本分析的指标数据采集
• 微服务架构中AWS服务依赖的性能监控

使用方法和配置说明

前置条件

• AWS账户访问权限（需配置IAM权限允许读取相关服务指标）
• Prometheus服务器（用于抓取导出的指标）
• Docker环境

基本使用（docker run）

bash
docker run -d \
  -p 9100:9100 \
  -e AWS_ACCESS_KEY_ID=your_aws_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret_key \
  -e AWS_REGION=us-east-1 \
  -e EXPORTED_SERVICES=ec2,s3,rds \
  --name aws-metrics-exporter \
  aws-metrics-exporter:latest

环境变量配置

Docker Compose配置

yaml
version: '3'
services:
  aws-metrics-exporter:
    image: aws-metrics-exporter:latest
    container_name: aws-metrics-exporter
    ports:
      - "9100:9100"
    environment:
      - AWS_ACCESS_KEY_ID=your_aws_access_key
      - AWS_SECRET_ACCESS_KEY=your_aws_secret_key
      - AWS_REGION=us-west-2
      - EXPORTED_SERVICES=ec2,s3,rds,lambda
      - SCRAPE_INTERVAL=30
      - LOG_LEVEL=info
    restart: unless-stopped

指标访问

启动容器后，可通过 http://<容器IP>:9100/metrics 访问导出的Prometheus指标。在Prometheus配置中添加如下job以抓取指标：

yaml
scrape_configs:
  - job_name: 'aws-metrics'
    static_configs:
      - targets: ['aws-metrics-exporter:9100']

高级配置（配置文件）

对于复杂需求，可通过挂载配置文件进行详细配置：

bash
docker run -d \
  -p 9100:9100 \
  -v /path/to/config.yaml:/app/config.yaml \
  -e CONFIG_FILE=/app/config.yaml \
  --name aws-metrics-exporter \
  aws-metrics-exporter:latest

配置文件示例（config.yaml）：

yaml
aws:
  region: us-east-1
  access_key_id: your_aws_access_key
  secret_access_key: your_aws_secret_key
services:
  ec2:
    enabled: true
    metrics:
      - cpu_usage
      - memory_usage
      - disk_io
  s3:
    enabled: true
    buckets:
      - my-bucket-1
      - my-bucket-2
    metrics:
      - object_count
      - size
scrape_interval: 30
log_level: info