ogavrisevs/ec2-diskfreespace-to-cloudwatch

镜像概述

本Docker容器旨在将EC2实例的磁盘可用空间指标发送至AWS CloudWatch，便于用户实时监控实例存储状态，及时发现存储不足等潜在问题。

核心功能

• 采集EC2实例的磁盘可用空间数据
• 将指标推送至AWS CloudWatch平台
• 支持通过定时任务周期性执行监控

使用场景

• 持续监控EC2实例的磁盘空间使用趋势
• 配合CloudWatch告警规则，在磁盘空间阈值触发时发送通知
• 定期收集存储指标用于系统优化和容量规划

配置说明

权限要求

需为运行容器的EC2实例角色添加以下AWS IAM策略：

• cloudwatch:PutMetricData
• cloudwatch:GetMetricStatistics
• cloudwatch:ListMetrics
• ec2:DescribeTags

部署示例

1. 添加crontab定时任务（每2分钟执行一次）：

   bash
   sudo crontab -e
   # 插入以下内容
   */2 * * * * docker run -v /:/host_root:ro --rm --log-driver=syslog ogavrisevs/ec2-diskfreespace-to-cloudwatch:latest --verbose
   

2. 参数说明：
   • -v /:/host_root:ro：以只读模式挂载主机根目录，用于读取磁盘空间数据
   • --verbose：开启详细日志输出，便于调试
   • --rm：容器执行完毕后自动删除

镜像特性

基于Alpine Linux构建，集成Perl及相关脚本，镜像体积约64MB，资源占用低且运行高效。 该容器基于AWS官方的CloudWatchMonitoringScripts开发，符合AWS生态的使用规范。