如何安装和配置统一的 CloudWatch 代理以便与 Systems Manager 一起使用？

2 分钟阅读

我想安装和配置统一的 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 控制台，选择角色，然后选择创建角色。
对于选择受信任实体的类型，选择 AWS 服务。
在常见使用案例中，选择 EC2，然后选择下一步。
在策略列表中，选中 CloudWatchAgentServerPolicy 和 AmazonSSMManagedInstanceCore 复选框，然后选择下一步。
在角色名称中，输入角色的名称，例如 CloudWatchAgentServerRole。
（可选）提供角色描述。
确认 CloudWatchAgentServerPolicy 和 AmazonSSMManagedInstanceCore 显示在策略旁边。
选择创建角色。
将 IAM 角色附加到 EC2 实例。

先决条件：

在实例上安装 AWS Systems Manager Agent（SSM Agent）版本 2.2.93.0 或更高版本。
确保 SSM Agent 正在管理 EC2 实例，并且其状态为在线。要对这些问题进行故障排除，请参阅为什么我的 EC2 实例在 Systems Manager 中未显示为托管节点或显示为“连接丢失”状态？
配置出站互联网访问以向 CloudWatch Logs 发送数据。如果您使用的是虚拟私有云（VPC）端点或代理，请配置 CloudWatch 端点和 CloudWatch Logs 端点。

提示：使用向导创建代理配置文件。然后，您可以手动编辑文件以添加或删除指标或日志。有关更多信息，请参阅以下部分完成代理配置文件向导的提示。

运行向导：

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-config-wizard

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。

配置代理配置文件向导时，系统会问您以下问题：

您想开启 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 代理。

**请注意：**修改代理配置文件后，使用 fetch-config 命令启动代理，以确保代理反映您的更改。