Auto Scaling场景下配置Unified Cloudwatch Agent采集PHP日志
Auto Scaling 组场景下配置CloudWatch Unified Agent采集PHP日志的可落地方案
Auto Scaling组的核心特性是所有EC2实例都通过固定的启动源(自定义AMI/启动配置+用户数据)批量生成,不存在需要逐台单独配置的场景——只要把Agent的安装、权限绑定、日志采集规则全固化到启动流程里,弹性伸缩动态拉出的每台新实例开机就会自动完成配置,下线实例也不需要额外做Agent清理,完全适配弹性伸缩的动态特性。
一、先给所有ASG实例配置好运行Agent的权限
- 不要逐台给实例绑权限,直接创建一个独立的IAM服务角色,挂载CloudWatch Agent运行所需的基础权限:允许向CloudWatch Logs推送日志、允许从Systems Manager Parameter Store拉取Agent配置、按需开放CloudWatch指标上报权限
- 把这个角色直接关联到ASG的启动模板/启动配置中,后续所有弹性伸缩流程拉起的新实例,启动时就会自动获得对应权限,不存在权限缺失导致Agent无法上报日志的问题
二、把Unified CloudWatch Agent的安装与配置流程固化到启动源
这里提供两种生产环境常用的实现方式,完全不需要逐台登录实例操作:
- 自定义AMI方式(适合对启动速度有要求的场景)
找一台同规格的EC2 Linux 2实例,手动完成全流程配置后打包为自定义AMI,后续ASG直接以这个AMI作为启动镜像:- 安装对应版本的Unified CloudWatch Agent安装包
- 写入提前调试好的日志采集规则,明确指定需要采集的PHP日志路径(比如PHP-FPM的错误日志、应用业务自定义PHP日志路径)、对应CloudWatch Logs日志组、日志流的命名规则、日志时间戳匹配格式
- 配置CloudWatch Agent为系统开机自启服务,本地测试验证日志可以正常推送到CloudWatch后,将实例关机打包为AMI
- 用户数据+SSM参数存储方式(适合需要频繁调整采集规则、不想维护自定义AMI的场景)
把Agent初始化的命令直接写进启动模板的用户数据段,提前把PHP日志采集的配置文件存在Systems Manager Parameter Store中,实例首次启动时自动执行初始化流程:
这种方式的优势是后续调整PHP日志采集路径、推送规则时,不需要重新打包AMI、也不需要修改启动模板,只要更新SSM参数存储里的配置内容,所有新启动的实例拉取配置时就会自动应用最新规则,已运行的实例也可以通过批量运行命令的方式刷新配置,运维成本极低。# 安装CloudWatch Agent sudo yum install -y amazon-cloudwatch-agent # 从SSM参数存储拉取提前配置好的PHP日志采集规则 sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -s -c ssm:你的PHP日志采集配置参数名 # 配置Agent服务开机自启 sudo systemctl enable amazon-cloudwatch-agent
三、适配多实例场景的日志流命名规则
这是ASG场景下最容易踩的配置坑:如果给日志流设置固定名称,所有弹性伸缩出来的实例推送的PHP日志会全部堆在同一个日志流中,根本分不清日志的来源实例,排查问题难度极高。
- 在Agent的日志采集配置中,给日志流名称加上动态实例标识,比如采用
/var/log/php-error/log/{instance_id}的命名规则,每台弹性伸缩拉起的实例,推送的日志会自动存入对应自身实例ID的独立日志流中 - 实例被弹性伸缩下线销毁后,对应实例的旧日志流不会被新启动的实例覆盖,后续排查问题时可以直接按实例ID匹配对应的日志内容
四、弹性伸缩上下线的日志衔接
Unified CloudWatch Agent是按照增量读取的方式实时推送日志,不是等实例终止时才集中上传日志,所以不需要在实例生命周期挂钩里加额外的日志导出脚本:
- 实例正常运行时,所有产生的PHP日志会实时增量推送到CloudWatch,就算实例被弹性伸缩强制销毁,已经产生的日志也不会丢失
- 实例流程下线时,本地Agent进程会随系统一起终止,不需要额外做配置清理
常见生产踩坑提醒
- 不要把日志采集规则硬编码在用户数据里,后续调整规则必须修改启动模板才能生效,长期维护成本很高,优先把配置存在SSM参数存储中统一管理
- 确认Agent配置中开启了日志偏移量记录,避免Agent重启、实例重启时重复推送已经上传过的PHP日志
- 核对PHP日志文件的系统权限,确保运行CloudWatch Agent的系统用户有对应日志文件的读取权限,避免出现Agent启动成功但无日志上报的问题
内容的提问来源于stack exchange,提问作者Courtney White
相关产品推荐
相关产品推荐

