在亚马逊云服务器上部署 CloudWatch 代理和 X-Ray 守护程序 - Amazon CloudWatch
创建 IAM 角色将代理配置存储在 SSM 参数存储中创建任务定义并启动任务
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在亚马逊云服务器上部署 CloudWatch 代理和 X-Ray 守护程序

在 Amazon ECS 上，您可以将 CloudWatch 代理作为附加项部署到应用程序容器来收集指标。您可以通过 SSM 参数仓库来配置 CloudWatch 代理。

创建 IAM 角色

您必须创建两个 IAM 角色。如果您已创建这些角色，则可能需要向其添加权限。

  • ECS 任务角色 —容器使用此角色运行。权限应是您的应用程序所需的任何权限，以及 CloudWatchAgentServerPolicy 和 AWSXRayDaemonWriteAccess。

  • ECS 任务定义角色 —Amazon ECS 使用此角色来启动和执行您的容器。如果您已创建此角色，请将 AmazonSSMReadOnlyAccess、AmazonECSTaskExecutionRolePolicy 和 CloudWatchAgentServerPolicy 策略附加到此角色。

    如果您需要存储更敏感的数据以供 Amazon ECS 使用，请参阅 “”。指定敏感数据了解更多信息。

有关创建 IAM 角色的更多信息，请参阅 “”。创建 IAM 角色。

将代理配置存储在 SSM 参数存储中

您需要确保您的代理配置文件具有以下部分，然后将它上传到 SSM 参数存储。

{
  "logs": {
    "metrics_collected": {
      "emf": {}
    }
  }
}

将代理配置上传到 SSM 参数仓库中

  1. 将代理配置内容放入本地文件 /tmp/ecs-cwagent.json 中

  2. 输入以下命令。将 region 替换为集群的区域。 

    aws ssm put-parameter \
--name "ecs-cwagent" \
--type "String" \
--value "`cat /tmp/ecs-cwagent.json`" \
--region "region"

创建任务定义并启动任务

此任务的步骤取决于您是要使用 EC2 启动类型还是 Fargate 启动类型。

EC2 启动类型

首先，创建任务定义。在此示例中，容器 “演示应用程序” 向 CloudWatch 代理发送 X-Ray 软件开发工具包指标，并向 X-Ray 守护程序发送跟踪信息。

将以下任务定义复制到本地 JSON 文件，例如 /tmp/ecs-cwagent-ec2.json。替换以下占位符：

  • 将 {{ecs-task-role}} 替换为 ECS 任务角色的 ARN。

  • 将 {{ecs-task-execution-role}} 替换为 ECS 任务执行角色的 ARN。

  • Replace{演示应用程序图像}}}}与已启用 X-Ray 集成的应用程序映像相关。将名称从 demo-app 更改为您自己的应用程序名称。

  • 将 {{region}} 替换为要发送容器日志的 Amazon 区域的名称。例如：us-west-2。 

{
    "family": "ecs-cwagent-ec2",
    "taskRoleArn": "{{ecs-task-role}}",
    "executionRoleArn": "{{ecs-task-execution-role}}",
    "networkMode": "bridge",
    "containerDefinitions": [
        {
            "name": "demo-app",
            "image": "{{demo-app-image}}",
            "links": [
                "cloudwatch-agent",
                "xray-daemon"
            ],
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                  "awslogs-create-group": "True",
                  "awslogs-group": "/ecs/ecs-cwagent-ec2",
                  "awslogs-region": "{{region}}",
                  "awslogs-stream-prefix": "ecs"
                }
            }
        },
        {
            "name": "xray-daemon",
            "image": "public.ecr.aws/xray/aws-xray-daemon:latest",
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                  "awslogs-create-group": "True",
                  "awslogs-group": "/ecs/ecs-cwagent-ec2",
                  "awslogs-region": "{{region}}",
                  "awslogs-stream-prefix": "ecs"
                }
            }
        },
        {
            "name": "cloudwatch-agent",
            "image": "public.ecr.aws/cloudwatch-agent/cloudwatch-agent:latest",
            "secrets": [
                {
                    "name": "CW_CONFIG_CONTENT",
                    "valueFrom": "ecs-cwagent"
                }
            ],
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                  "awslogs-create-group": "True",
                  "awslogs-group": "/ecs/ecs-cwagent-ec2",
                  "awslogs-region": "{{region}}",
                  "awslogs-stream-prefix": "ecs"
                }
            }
        }
    ],
    "requiresCompatibilities": [
        "EC2"
    ],
    "cpu": "256",
    "memory": "256"
}

输入以下命令以创建任务定义。将 {{region}} 替换为集群的区域。 

aws ecs register-task-definition \
    --cli-input-json file:///tmp/ecs-cwagent-ec2.json \
    --region {{region}}

输入以下命令以启动任务。将 {{cluster-name}} 和 {{region}} 分别替换为集群的名称和区域。 

aws ecs run-task \
    --cluster {{cluster-name}} \
    --task-definition ecs-cwagent-ec2 \
    --region {{region}} \
    --launch-type EC2

Fargate 发射类型

首先，创建任务定义。在此示例中，容器 “演示应用程序” 向 CloudWatch 代理发送 X-Ray 软件开发工具包指标，并向 X-Ray 守护程序发送跟踪信息。

将以下任务定义复制到本地 JSON 文件，例如 /tmp/ecs-cwagent-ec2.json。替换以下占位符：

  • 将 {{ecs-task-role}} 替换为 ECS 任务角色的 Amazon 资源名称 (ARN)。

  • 将 {{ecs-task-execution-role}} 替换为 ECS 任务执行角色的 ARN。

  • Replace{演示应用程序图像}}}}与已启用 X-Ray 集成的应用程序映像相关。将名称从 demo-app 更改为您自己的应用程序名称。

  • 将 {{region}} 替换为要发送容器日志的 Amazon 区域的名称。例如：us-west-2。 

{
    "family": "ecs-cwagent-fargate",
    "taskRoleArn": "{{ecs-task-role}}",
    "executionRoleArn": "{{ecs-task-execution-role}}",
    "networkMode": "awsvpc",
    "containerDefinitions": [
        {
            "name": "demo-app",
            "image": "{{demo-app-image}}",
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                  "awslogs-create-group": "True",
                  "awslogs-group": "/ecs/ecs-cwagent-fargate",
                  "awslogs-region": "{{region}}",
                  "awslogs-stream-prefix": "ecs"
                }
            }
        },
        {
            "name": "xray-daemon",
            "image": "public.ecr.aws/xray/aws-xray-daemon:latest",
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                  "awslogs-create-group": "True",
                  "awslogs-group": "/ecs/ecs-cwagent-fargate",
                  "awslogs-region": "{{region}}",
                  "awslogs-stream-prefix": "ecs"
                }
            }
        },
        {
            "name": "cloudwatch-agent",
            "image": "public.ecr.aws/cloudwatch-agent/cloudwatch-agent:latest",
            "secrets": [
                {
                    "name": "CW_CONFIG_CONTENT",
                    "valueFrom": "ecs-cwagent"
                }
            ],
            "logConfiguration": {
                "logDriver": "awslogs",
                "options": {
                  "awslogs-create-group": "True",
                  "awslogs-group": "/ecs/ecs-cwagent-fargate",
                  "awslogs-region": "{{region}}",
                  "awslogs-stream-prefix": "ecs"
                }
            }
        }
    ],
    "requiresCompatibilities": [
        "FARGATE"
    ],
    "cpu": "512",
    "memory": "1024"
}

输入以下命令以创建任务定义。将 {{region}} 替换为集群的区域。 

aws ecs register-task-definition \
    --cli-input-json file:///tmp/ecs-cwagent-fargate.json \
    --region {{region}}

如果您已设置 Fargate 集群，则可使用刚刚创建的任务定义来启动任务。如果您还没有任何 Fargate 集群，请参阅配置服务，了解有关设置 Fargate 的其余步骤的更多信息。