phillbaker/cloudwatchmetricbeat

Cloudwatchmetricbeat镜像说明

镜像概述

Cloudwatchmetricbeat是基于Elasticsearch Beat框架的工具，用于采集AWS CloudWatch中的指标数据，支持自定义配置维度筛选、统计类型等参数，可将数据发送至Elasticsearch等系统，帮助用户实现AWS资源的监控与分析。

核心功能

1. 从AWS CloudWatch获取指定命名空间的指标数据（如AWS/ELB、AWS/EC2）
2. 支持按维度筛选指标（如Load***Name、AvailabilityZone）
3. 可配置统计类型（Sum、Average、Maximum等）
4. 兼容Elasticsearch生态，便于后续可视化与分析

使用场景

1. 监控AWS ELB的请求量、延迟等关键指标
2. 跟踪EC2实例的CPU使用率、内存占用情况
3. 整合到ELK栈（Elasticsearch、Logstash、Kibana）进行统一监控分析

配置说明

示例配置（cloudwatchmetricbeat.yml）：

yaml
aws_region: us-east-1
metrics:
 - aws_namespace: AWS/ELB
   aws_metric_name: RequestCount
   aws_dimensions: [AvailabilityZone, LoadBalancerName]
   aws_dimension_select:
     LoadBalancerName: [myLB]
   aws_statistics: [Sum]

关键配置项说明：

• aws_region：必填，AWS区域（如cn-north-1）
• metrics：必填，需采集的指标列表
• aws_namespace：必填，CloudWatch指标命名空间
• aws_metric_name：必填，指标名称
• aws_dimensions：可选，维度列表（用于筛选指标）
• aws_statistics：可选，统计类型（默认Average）

Docker部署示例

单容器运行

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -v /local/path/to/cloudwatchmetricbeat.yml:/app/cloudwatchmetricbeat.yml \
  docker.xuanyuan.run/phillbaker/cloudwatchmetricbeat \
  ./cloudwatchmetricbeat -c cloudwatchmetricbeat.yml -e

Docker Compose示例

yaml
version: '3'
services:
  cloudwatchmetricbeat:
    image: docker.xuanyuan.run/phillbaker/cloudwatchmetricbeat
    environment:
      - AWS_ACCESS_KEY_ID=your_access_key
      - AWS_SECRET_ACCESS_KEY=your_secret_key
    volumes:
      - ./cloudwatchmetricbeat.yml:/app/cloudwatchmetricbeat.yml
    command: ["./cloudwatchmetricbeat", "-c", "cloudwatchmetricbeat.yml", "-e"]

注意事项

• 需确保容器拥有cloudwatch:ListMetrics和cloudwatch:GetMetricStatistics的IAM权限
• 配置文件中的aws_region需与实际AWS资源所在区域一致
• 根据AWS CloudWatch定价，频繁请求指标会产生费用，需合理设置采集周期
• 高分辨率指标（周期<60秒）仅保留3小时，需注意数据保留策略