我想安装和配置统一的 Amazon CloudWatch 代理以便与 AWS Systems Manager 一起使用。
简短描述
按照以下步骤安装和配置统一的 CloudWatch 代理:
- 创建一个 AWS Identity and Access Management(IAM)角色来运行 CloudWatch 代理。然后,将该 IAM 角色附加到 Amazon Elastic Compute Cloud(Amazon EC2)实例。
- 使用 AWS Systems Manager 下载并安装 CloudWatch 代理。
- 创建代理配置文件,在其中指定您计划从 Amazon EC2 实例推送到 CloudWatch 的指标和日志。
- 使用配置文件启动 CloudWatch 代理。
解决方法
开始之前,请在 EC2 实例中建立互联网连接,将实例连接到所需的端点。
为每台服务器创建 IAM 角色以运行 CloudWatch 代理
- 打开 IAM 控制台,选择角色,然后选择创建角色。
- 对于选择受信任实体的类型,选择 AWS 服务。
- 在常见使用案例中,选择 EC2,然后选择下一步。
- 在策略列表中,选中 CloudWatchAgentServerPolicy 和 AmazonSSMManagedInstanceCore 复选框,然后选择下一步。
- 在角色名称中,输入角色的名称,例如 CloudWatchAgentServerRole。
- (可选)提供角色描述。
- 确认 CloudWatchAgentServerPolicy 和 AmazonSSMManagedInstanceCore 显示在策略旁边。
- 选择创建角色。
- 将 IAM 角色附加到 EC2 实例。
对于本地服务器,请参阅创建用于本地服务器上的 CloudWatch 代理的 IAM 用户。
使用 Systems Manager 下载并安装统一的 CloudWatch 代理
先决条件:
满足先决条件后,按照以下步骤使用 Systems Manager 下载 CloudWatch 代理。
创建和修改代理配置文件
提示:使用向导创建代理配置文件。然后,您可以手动编辑文件以添加或删除指标或日志。有关更多信息,请参阅以下部分完成代理配置文件向导的提示。
运行向导:
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard
启动 CloudWatch 代理
sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -c file:configuration-file-path -s
**请注意:**将 configuration-file-path 替换为您在上一步中收到的配置文件路径。
默认情况下,代理会将指标推送到命名空间 CWAgent。
有关更多信息,请参阅创建 CloudWatch 代理配置文件。
配置代理配置文件向导的提示
配置代理配置文件向导时,系统会问您以下问题:
- 您想开启 StatsD 进程守护程序吗?以及是否要监控 CollectD 的指标?针对这些问题,只有在您的 EC2 实例上安装了 StatsD 和 CollectD 插件时,才选择是。
- **您想要哪种默认指标配置?**有关不同详细级别的更多信息,请参阅 CloudWatch 代理预定义指标集。然后,选择最适合您的使用案例的选项。
- 是否要导入现有 CloudWatch Logs 代理配置文件以进行迁移?如果您正在运行 awslogs 代理,则向导会读取 awslogs 代理配置文件(/etc/awslogs/awslogs.conf 或 /var/awslogs/etc/awslogs.conf),以确定要监控的日志文件。
- 您想将配置存储在 Parameter Store(AWS Systems Manager 的一个功能)中吗?如果之后要再次使用该文件,请选择是,将代理配置文件存储在 Parameter Store 中。
**重要事项:**当您将代理配置文件存储在 Parameter Store 中时,启动代理的命令会有所不同。
完成向导后,代理配置文件默认存储在 /opt/aws/amazon-cloudwatch-agent/bin/config.json 中。您可以手动编辑此文件以添加或删除指标或日志。
启动和停止 CloudWatch 代理
有关启动和停止 CloudWatch 代理的步骤,请参阅停止和重新启动 CloudWatch 代理。
**请注意:**修改代理配置文件后,使用 fetch-config 命令启动代理,以确保代理反映您的更改。
相关信息
使用您的代理配置在 EC2 实例上安装 CloudWatch 代理
故障排除 CloudWatch 代理的问题