prom/cloudwatch-exporter Docker Image Overview

prom/cloudwatch-exporter

自动构建

prom

用于Amazon CloudWatch的Prometheus导出器，可将CloudWatch指标转换为Prometheus可抓取的格式，支持维度和标签过滤、多种AWS凭证方式及可选的高性能API。

9 次收藏下载次数: 0状态：自动构建维护者：prom仓库类型：镜像最近更新：3 个月前

轩辕镜像，加速的不只是镜像。点击查看

中文简介版本下载

轩辕镜像，加速的不只是镜像。点击查看

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指标及相关参数。

配置参数说明

参数名	描述
region	可选，AWS区域。未指定时，通过默认区域提供链自动获取。
role_arn	可选，需扮演的AWS角色ARN，用于跨账号获取指标。
metrics	必选，需导出的CloudWatch指标列表。
aws_namespace	必选（metrics内），CloudWatch指标命名空间（如AWS/ELB）。
aws_metric_name	必选（metrics内），指标名称（如RequestCount）。
aws_dimensions	必选（metrics内），指标维度列表（需包含该指标所有可用维度）。
aws_dimension_select	可选（metrics内），维度值过滤，格式为`{维度名: [值列表]}`。
aws_dimension_select_regex	可选（metrics内），维度值正则过滤，格式为`{维度名: [正则列表]}`。
aws_tag_select	可选（metrics内），基于资源标签过滤，包含`tag_selections`等子参数。
tag_selections	可选（aws_tag_select内），标签过滤，格式为`{标签键: [标签值列表]}`。
resource_type_selection	必选（aws_tag_select内），资源类型（如elasticloadbalancing:load***）。
resource_id_dimension	必选（aws_tag_select内），映射资源ID的CloudWatch维度名。
arn_resource_id_regexp	可选（aws_tag_select内），从ARN提取资源ID的正则表达式。
aws_statistics	可选，需获取的统计数据列表（Sum、Average等），默认获取所有统计数据。
aws_extended_statistics	可选，扩展统计数据列表（如p95）。
delay_seconds	可选，请求最新数据的延迟时间（秒），默认600s，避免数据未收敛。
range_seconds	可选，数据请求时间范围（秒），默认600s。
period_seconds	可选，指标周期（秒），默认60s。
set_timestamp	可选，是否使用CloudWatch原始时间戳，默认true。
use_get_metric_data	可选，是否使用GetMetricData API，默认false（实验性功能）。

配置示例

使用维度过滤（aws_dimension_select）：

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

使用标签过滤（aws_tag_select）：

yaml
---
region: eu-west-1
metrics:
  - aws_namespace: AWS/ELB
    aws_metric_name: RequestCount
    aws_dimensions: [AvailabilityZone, Load***Name]
    aws_tag_select:
      tag_selections:
        Monitoring: ["enabled"]
      resource_type_selection: "elasticloadbalancing:load***"
      resource_id_dimension: Load***Name
    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监控请求量。