prom/cloudwatch-exporter

CloudWatch Exporter

镜像概述与主要用途

CloudWatch Exporter是一款用于Amazon CloudWatch的Prometheus导出器，能够将CloudWatch指标转换为Prometheus可识别的格式，以便通过Prometheus进行监控和分析。适用于需要集中收集、存储和分析AWS资源（如EC2、ELB、DynamoDB等）监控指标的场景。

核心功能与特性

• 指标转换：将CloudWatch指标转换为Prometheus兼容格式，支持标准统计数据（Sum、Average等）和扩展统计数据（如p95）。
• 灵活配置：通过YAML配置文件定义需导出的指标，支持维度过滤（aws_dimension_select）和标签过滤（aws_tag_select）。
• AWS集成：使用AWS Java SDK，支持多种凭证方式（环境变量、IAM角色等），支持跨账号指标获取（通过role_arn）。
• 性能优化：可选启用实验性GetMetricData API（替代默认的GetMetricStatistics），提升大规模指标获取性能。
• 缓存机制：支持ListMetrics API结果缓存，减少重复请求。

使用场景与适用范围

• 监控AWS云资源（EC2、ELB、RDS、DynamoDB等）的CloudWatch指标。
• 构建基于Prometheus+Grafana的AWS监控 dashboard。
• 对AWS资源指标进行告警配置（结合Prometheus Alertmanager）。
• 适用于需要统一监控混合云环境的企业，或需要长期存储AWS指标的场景。

详细使用方法与配置说明

前提条件

• AWS账号及具有相应权限的IAM用户/角色。
• Docker环境（用于容器化部署）。
• Prometheus实例（用于抓取导出的指标）。

IAM权限要求

需以下IAM权限：

• cloudwatch:ListMetrics：列出可用指标。
• cloudwatch:GetMetricStatistics/cloudwatch:GetMetricData：获取指标数据。
• tag:GetResources：使用aws_tag_select功能时需此权限。

Docker部署示例

基本运行命令

bash
docker run -p 9106:9106 -v /本地路径/config.yml:/config/config.yml prom/cloudwatch-exporter

• -p 9106:9106：映射容器端口9106（默认导出端口）到主机。
• -v /本地路径/config.yml:/config/config.yml：挂载本地配置文件到容器内默认路径。

指定自定义配置文件路径

bash
docker run -p 9106:9106 -v /本地路径/us-west-1.yml:/config/us-west-1.yml prom/cloudwatch-exporter /config/us-west-1.yml

构建包含配置的自定义镜像

创建Dockerfile：

Dockerfile
FROM prom/cloudwatch-exporter
ADD config.yml /config/

构建并运行：

bash
docker build -t my-cloudwatch-exporter .
docker run -p 9106:9106 my-cloudwatch-exporter

配置说明

配置文件为YAML格式，用于定义需导出的CloudWatch指标及相关参数。

配置参数说明

配置示例

使用维度过滤（aws_dimension_select）：

yaml
---
region: eu-west-1
metrics:
  - aws_namespace: AWS/ELB
    aws_metric_name: RequestCount
    aws_dimensions: [AvailabilityZone, LoadBalancerName]
    aws_dimension_select:
      LoadBalancerName: [myLB]
    aws_statistics: [Sum]

使用标签过滤（aws_tag_select）：

yaml
---
region: eu-west-1
metrics:
  - aws_namespace: AWS/ELB
    aws_metric_name: RequestCount
    aws_dimensions: [AvailabilityZone, LoadBalancerName]
    aws_tag_select:
      tag_selections:
        Monitoring: ["enabled"]
      resource_type_selection: "elasticloadbalancing:loadbalancer"
      resource_id_dimension: LoadBalancerName
    aws_statistics: [Sum]

环境变量

• AWS_ACCESS_KEY_ID：AWS访问密钥ID（用于凭证认证）。
• AWS_SECRET_ACCESS_KEY：AWS密钥（用于凭证认证）。
• 其他AWS SDK支持的环境变量（如AWS_REGION）。

注意事项

• 指标时间戳：默认delay_seconds=600s，确保数据收敛，Prometheus查询时需使用offset 10m访问历史数据。
• DynamoDB特殊处理：部分DynamoDB指标（如ConsumedReadCapacityUnits）采用特殊命名格式（aws_dynamodb_<METRIC>_index_<STATISTIC>）。
• 成本控制：使用GetMetricStatistics按API请求计费，GetMetricData按指标数量计费，通过cloudwatch_requests_total监控请求量。