AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

如果我们为英文版本指南提供翻译，那么如果存在任何冲突，将以英文版本指南为准。在提供翻译时使用机器翻译。

部署 CloudWatch 代理以收集 Amazon ECS 上的 EC2 实例级别指标

要部署 CloudWatch 代理以从 EC2 实例上托管的 Amazon ECS 集群中收集实例级别指标，请使用具有默认配置的快速启动设置，或手动安装该代理以便对其进行自定义。

这两种方法都要求您至少部署了一个具有 EC2 启动类型的 Amazon ECS 集群。这些方法还假设您已安装 AWS CLI。此外，要在以下过程中运行这些命令，您必须登录到具有 IAMFullAccess 和 AmazonECS_FullAccess 策略的账户或角色。

使用 AWS CloudFormation 进行快速设置

要使用快速设置，请输入以下命令来使用 AWS CloudFormation 安装代理。Replace cluster-name $and cluster-region 和您所在的地区 Amazon ECS 群集。

此命令将创建 IAM 角色，即 CWAgentECSTaskRole 和 CWAgentECSExecutionRole。如果您的账户中已有这些角色，请在输入命令时使用 ParameterKey=CreateIAMRoles,ParameterValue=False 而非 ParameterKey=CreateIAMRoles,ParameterValue=True。否则，此命令将失败。

ClusterName=cluster-name
Region=cluster-region
aws cloudformation create-stack --stack-name CWAgentECS-${ClusterName}-${Region} \
    --template-body https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/ecs-task-definition-templates/deployment-mode/daemon-service/cwagent-ecs-instance-metric/cloudformation-quickstart/cwagent-ecs-instance-metric-cfn.json \
    --parameters ParameterKey=ClusterName,ParameterValue=${ClusterName} \
                 ParameterKey=CreateIAMRoles,ParameterValue=True \
    --capabilities CAPABILITY_NAMED_IAM \
    --region ${Region}

(替代)使用您自己的 IAM 角色

如果您要使用自己的自定义 ECS 任务角色和 ECS 任务执行角色，而不是使用 CWAgentECSTaskRole 和 CWAgentECSExecutionRole 角色，请先确保要用作 ECS 任务角色的角色已附加 CloudWatchAgentServerPolicy。此外，请确保要用作 ECS 任务执行角色的角色同时附加了 CloudWatchAgentServerPolicy 和 AmazonECSTaskExecutionRolePolicy 策略。然后，输入以下命令。在该命令中，替换：task-role-arn 使用自定义ECS任务角色的ARN,并替换 execution-role-arn 具有自定义ECS任务执行角色的ARN。

ClusterName=cluster-name
Region=cluster-region
TaskRoleArn=task-role-arn
ExecutionRoleArn=execution-role-arn
aws cloudformation create-stack --stack-name CWAgentECS-${ClusterName}-${Region} \
    --template-body https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/ecs-task-definition-templates/deployment-mode/daemon-service/cwagent-ecs-instance-metric/cloudformation-quickstart/cwagent-ecs-instance-metric-cfn.json \
    --parameters ParameterKey=ClusterName,ParameterValue=${ClusterName} \
                 ParameterKey=TaskRoleArn,ParameterValue=${TaskRoleArn} \
                 ParameterKey=ExecutionRoleArn,ParameterValue=${ExecutionRoleArn} \
    --capabilities CAPABILITY_NAMED_IAM \
    --region ${Region}

对快速设置进行故障排除

要查看 AWS CloudFormation 堆栈的状态，请输入以下命令。

ClusterName=cluster-name
Region=cluster-region
aws cloudformation describe-stacks --stack-name CWAgentECS-$ClusterName-$Region --region $Region

如果您看到的 StackStatus 不是 CREATE_COMPLETE 或 CREATE_IN_PROGRESS，请查看堆栈事件以查找错误。输入以下命令。

ClusterName=cluster-name
Region=cluster-region
aws cloudformation describe-stack-events --stack-name CWAgentECS-$ClusterName-$Region --region $Region

检查 cwagent daemon服务,输入下列命令。在输出中，您应看到 deployment 部分中的 runningCount 等于 desiredCount。如果二者不相等，请查看输出中的 failures 部分。

ClusterName=cluster-name
Region=cluster-region
aws ecs describe-services --services cwagent-daemon-service --cluster $ClusterName --region $Region

您还可以使用 CloudWatch Logs 控制台来查看代理日志。查找 /ecs/ecs-cwagent-daemon-service 日志组。

删除 AWS CloudFormation 堆栈 CloudWatch 药剂

如果您需要删除 AWS CloudFormation 堆栈，请输入以下命令。

ClusterName=cluster-name
Region=cluster-region
aws cloudformation delete-stack --stack-name CWAgentECS-${ClusterName}-${Region} --region ${Region}

手动和自定义设置

执行此部分中的步骤，手动部署 CloudWatch 代理以从 EC2 实例上托管的 Amazon ECS 集群收集实例级别指标。

必要的 IAM 角色和策略

需要两个 IAM 角色。如果这两个角色不存在，则必须创建它们。有关这些角色的更多信息，请参阅 Amazon ECS 任务角色和Amazon ECS 任务执行角色。

如果您还没有这些角色，则可使用以下命令来创建它们并附加必要的策略。第一条命令将创建 ECS 任务角色。

aws iam create-role --role-name CWAgentECSTaskRole \
    --assume-role-policy-document "{\"Version\": \"2012-10-17\",\"Statement\": [{\"Sid\": \"\",\"Effect\": \"Allow\",\"Principal\": {\"Service\": \"ecs-tasks.amazonaws.com\"},\"Action\": \"sts:AssumeRole\"}]}"

在输入上一条命令后，将命令输出中的 Arn 的值记为“TaskRoleArn”。在创建任务定义时,您需要稍后使用它。然后，输入以下命令来附加必要的策略。

aws iam attach-role-policy --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy \
    --role-name CWAgentECSTaskRole

下一条命令将创建 ECS 任务执行角色。

aws iam create-role --role-name CWAgentECSExecutionRole \
    --assume-role-policy-document "{\"Version\": \"2012-10-17\",\"Statement\": [{\"Sid\": \"\",\"Effect\": \"Allow\",\"Principal\": {\"Service\": \"ecs-tasks.amazonaws.com\"},\"Action\": \"sts:AssumeRole\"}]}"

在输入上一条命令后，将命令输出中的 Arn 的值记为“ExecutionRoleArn”。在创建任务定义时,您需要稍后使用它。然后，输入以下命令来附加必要的策略。

aws iam attach-role-policy --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy \
    --role-name CWAgentECSExecutionRole
          
aws iam attach-role-policy --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy \
    --role-name CWAgentECSExecutionRole

创建任务定义并启动守护程序服务

创建一个任务定义并使用它将 CloudWatch 代理作为守护程序服务启动。要创建任务定义，请输入以下命令。在第一行中,用部署的实际值替换占位符。logs-region 是 CloudWatch Logs 和 cluster-region 是您群集所在的区域。task-role-arn 您正在使用的ECS任务角色的Arn,以及 execution-role-arn 是ECS任务执行角色的Arn。

TaskRoleArn=task-role-arn
ExecutionRoleArn=execution-role-arn
AWSLogsRegion=logs-region
Region=cluster-region
curl https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/ecs-task-definition-templates/deployment-mode/daemon-service/cwagent-ecs-instance-metric/cwagent-ecs-instance-metric.json \
    | sed "s|{{task-role-arn}}|${TaskRoleArn}|;s|{{execution-role-arn}}|${ExecutionRoleArn}|;s|{{awslogs-region}}|${AWSLogsRegion}|" \
    | xargs -0 aws ecs register-task-definition --region ${Region} --cli-input-json

然后，运行以下命令来启动守护程序服务。Replace cluster-name $and cluster-region 和您所在的地区 Amazon ECS 群集。

ClusterName=cluster-name
Region=cluster-region
aws ecs create-service \
    --cluster ${ClusterName} \
    --service-name cwagent-daemon-service \
    --task-definition ecs-cwagent-daemon-service \
    --scheduling-strategy DAEMON \
    --region ${Region}

如果看到这个错误信息, An error occurred (InvalidParameterException) when calling the CreateService operation: Creation of service was not idempotent,您已经创建了一个名为 cwagent-daemon-service。您必须首先删除该服务,使用下列命令作为示例。

ClusterName=cluster-name
Region=cluster-region
aws ecs delete-service \
    --cluster ${ClusterName} \
    --service cwagent-daemon-service \
    --region ${Region} \
    --force

（可选）高级配置

（可选）您可以使用 SSM EC2 实例上托管的 Amazon ECS 集群中的 CloudWatch 代理指定其他配置选项。这些选项如下所示：

以下是自定义配置的示例：

{
    "agent": {
        "region": "us-east-1"
    },
    "logs": {
        "metrics_collected": {
            "ecs": {
                "metrics_collection_interval": 30
            }
        },
        "force_flush_interval": 5
    }
}