Ubuntu 18.04环境下Cloud Watch Agent启动后立即停止问题求助

1. 查看运行日志定位具体错误 #

配置校验通过仅代表格式合法，不代表运行时无错误，执行以下命令查看agent运行时日志获取具体报错原因：

cat /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log

日志中会明确输出启动失败的根因，常见报错包括权限不足、网络连通失败、采集项配置无效等。

2. 检查配置文件有效性 #

你的执行返回日志提示未找到csm配置、未找到日志配置，若config.json中也未定义任何指标采集规则，agent无任何可执行的采集任务会直接自动退出。请确认配置文件中至少包含一类合法的采集配置（指标/日志/CSM）。

3. 检查run_as_user权限 #

若配置中指定了run_as_user参数，需确认对应用户具备以下权限：

• agent配置文件、运行目录的读写权限
• 采集目标的读取权限（如需采集系统路径日志、collectd socket数据等）
  若你已安装collectd，还需确认collectd服务已正常启动，且agent配置中填写的collectd socket路径与实际路径一致。

4. 验证EC2实例配置与连通性 #

• 确认IAM角色已实际绑定到当前EC2实例，仅创建策略关联角色但未挂载到实例会导致agent上报数据失败退出
• 确认实例可以正常访问CloudWatch服务端点：VPC内无公网的实例需要配置CloudWatch服务的VPC端点，否则网络不通会导致启动失败

5. 清理残留进程后重启 #

若存在旧的agent残留进程，会导致新进程启动失败，执行以下命令清理后重新启动：

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a stop
ps aux | grep cloudwatch-agent | grep -v grep | awk '{print $2}' | xargs sudo kill -9
# 重新执行启动命令
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -s -c file:/opt/aws/amazon-cloudwatch-agent/bin/config.json

内容的提问来源于stack exchange，提问作者Mitsuki