pebbletech/cloudwatch-mon-scripts

镜像概述

pebbletech/cloudwatch-mon-scripts是一款将CloudWatch Linux监控脚本打包为Docker镜像的工具，基于Python实现，用于收集Linux实例的资源利用率数据并上报至Amazon CloudWatch，帮助用户监控EC2实例或其他Linux环境的运行状态。

核心功能

• 收集Linux实例的内存利用率、磁盘空间利用率等关键指标
• 将监控数据上报至Amazon CloudWatch平台
• 支持验证配置和查看详细日志的测试运行模式
• 可查询指定时间段内的资源利用率统计数据

使用场景

• EC2实例的日常资源监控与指标上报
• 自动扩展组（ASG）环境下的实例状态跟踪
• 需要定期收集Linux系统资源数据并可视化分析的场景

配置说明

IAM政策要求

为允许实例向CloudWatch读写指标数据，需配置以下IAM政策：

json
{
  "Statement": [
    {
      "Action": [
        "cloudwatch:ListMetrics",
        "cloudwatch:GetMetricStatistics",
        "cloudwatch:PutMetricData",
        "autoscaling:DescribeAutoScalingInstances"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

凭证配置方式

1. IAM角色：将上述政策绑定到EC2实例的IAM角色，无需额外配置
2. 环境变量：导出AWS凭证：

   bash
   export AWS_ACCESS_KEY_ID=[你的AWS访问密钥ID]
   export AWS_SECRET_ACCESS_KEY=[你的AWS秘密访问密钥]
   

3. .boto文件：在用户主目录创建~/.boto文件：

   ini
   [Credentials]
   aws_access_key_id = 你的AWS访问密钥ID
   aws_secret_access_key = 你的AWS秘密访问密钥
   

Docker部署示例

1. 创建systemd单元文件

创建docker-cloudwatch.service文件：

ini
[Unit]
Description=CloudWatch监控脚本服务
After=docker.service
Requires=docker.service

[Service]
TimeoutStartSec=0
ExecStartPre=-/usr/bin/docker kill cloudwatch-mon-scripts
ExecStartPre=-/usr/bin/docker rm cloudwatch-mon-scripts
ExecStartPre=-/usr/bin/docker pull pebbletech/cloudwatch-mon-scripts
ExecStart=/bin/sh -c '/usr/bin/docker run -e ASG=$(source /etc/profile; fleetctl list-machines -l | grep $(cat /etc/machine-id) | sed "s/.*service=//g") pebbletech/cloudwatch-mon-scripts'

2. 启动服务

bash
systemctl start docker-cloudwatch.service

使用示例

• 测试运行（不发送数据）：

  bash
  docker run pebbletech/cloudwatch-mon-scripts mon-put-instance-stats.py --mem-util --verify --verbose
  

• 上报内存和磁盘利用率：

  bash
  docker run pebbletech/cloudwatch-mon-scripts mon-put-instance-stats.py --mem-util --disk-space-util --disk-path=/
  

• 查询最近12小时统计数据：

  bash
  docker run pebbletech/cloudwatch-mon-scripts mon-get-instance-stats.py --recent-hours=12