收集应用程序跟踪数据 - Amazon Elastic Container Service
Amazon Distro for OpenTelemetry 与 Amazon X-Ray 集成所需的 IAM 权限指定 Amazon Distro for OpenTelemetry 附加，用于任务定义中的 Amazon X-Ray 集成
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

收集应用程序跟踪数据

Amazon ECS 与 Amazon Distro for OpenTelemetry 集成，以从应用程序中收集跟踪数据。Amazon ECS 使用 Amazon Distro for OpenTelemetry 附加容器，以收集跟踪数据并将其路由到 Amazon X-Ray。有关更多信息，请参阅在 Amazon ECS 中设置 Amazon Distro for OpenTelemetry Collector。

要使 Amazon Distro for OpenTelemetry Collector 将跟踪数据发送到 Amazon X-Ray，必须将您的应用程序配置为创建跟踪数据。有关更多信息，请参阅 Amazon X-Ray 开发人员指南中的分析 Amazon X-Ray 的应用程序。

Amazon Distro for OpenTelemetry 与 Amazon X-Ray 集成所需的 IAM 权限

Amazon ECS 与 Amazon Distro for OpenTelemetry 集成要求您创建任务 IAM 角色并在任务定义中指定角色。我们建议也将 Amazon Distro for OpenTelemetry 附加配置为将容器日志路由到 CloudWatch Logs 中，这还需要在任务定义中创建和指定任务执行 IAM 角色。新的 Amazon ECS 控制台体验代表您处理任务执行 IAM 角色，但必须手动创建任务 IAM 角色。有关创建任务执行 IAM 角色的更多信息，请参阅 Amazon ECS 任务执行 IAM 角色。

重要

如果您还要使用 Amazon Distro for OpenTelemetry 集成收集应用程序指标，请确保您的任务 IAM 角色还包含该集成所需的权限。有关更多信息，请参阅收集应用程序指标。

要为 Amazon Distro for OpenTelemetry 集成创建任务 IAM 角色

  1. 通过以下网址打开 IAM 控制台：https://console.aws.amazon.com/iam/。

  2. 在导航窗格中，选择 Policies、Create policy。

  3. 在 Create policy（创建策略）页面中，切换到 JSON 选项卡，将以下 IAM policy JSON 复制并粘贴到字段中，然后选择 Next: Tags（下一步：标签）。

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "xray:PutTraceSegments",
                "xray:PutTelemetryRecords",
                "xray:GetSamplingRules",
                "xray:GetSamplingTargets",
                "xray:GetSamplingStatisticSummaries"
            ],
            "Resource": "*"
        }
    ]
}

  4. （可选）将一个或多个标签添加到角色，然后选择 Next: Review（下一步：审核）。

  5. 对于 Name（名称），指定 AWSDistroOpenTelemetryPolicyForXray。

  6. 对于 Description（描述），指定可选描述，然后选择 Create policy（创建策略）。

  7. 在导航窗格中，选择 Roles（角色）和 Create role（创建角色）。

  8. 在 Select type of trusted entity（选择受信任实体的类型）部分，选择 Amazon 服务 Elastic Container Service。

  9. 对于 Select your use case (选择使用案例)，选择 Elastic Container Service Task (弹性容器服务任务)，然后选择 Next: Permissions (下一步: 权限)。

  10. 在 Attach permissions policy（附加权限策略）部分中，搜索 AWSDistroOpenTelemetryPolicyForXray，选择策略，然后选择 Next: Tags（下一步：标签）。

  11. 对于添加标签（可选），指定要与策略关联的任何自定义标签，然后选择下一步:审核.

  12. 对于 Role Name（角色名称），指定 AmazonECS_OpenTelemetryXrayRole，然后选择 Create role（创建角色）。

指定 Amazon Distro for OpenTelemetry 附加，用于任务定义中的 Amazon X-Ray 集成

新的 Amazon ECS 控制台体验通过使用 Use trace collection（使用跟踪收集）选项简化了创建 Amazon Distro for OpenTelemetry 附加容器的体验。有关更多信息，请参阅使用控制台创建任务定义。

如果您没有使用 Amazon ECS 控制台，则可以添加 Amazon Distro for OpenTelemetry 附加容器到您的任务定义中。以下任务定义片段显示了用于添加 Amazon Distro for OpenTelemetry 附加以进行 Amazon X-Ray 集成的容器定义。

{
	"family": "otel-using-xray",
	"taskRoleArn": "arn:aws:iam::111122223333:role/AmazonECS_OpenTelemetryXrayRole",
	"executionRoleArn": "arn:aws:iam::111122223333:role/ecsTaskExecutionRole",
	"containerDefinitions": [{
			"name": "aws-otel-emitter",
			"image": "application-image",
			"logConfiguration": {
				"logDriver": "awslogs",
				"options": {
					"awslogs-create-group": "true",
					"awslogs-group": "/ecs/aws-otel-emitter",
					"awslogs-region": "us-east-1",
					"awslogs-stream-prefix": "ecs"
				}
			},
			"dependsOn": [{
				"containerName": "aws-otel-collector",
				"condition": "START"
			}]
		},
		{
			"name": "aws-otel-collector",
			"image": "public.ecr.aws/aws-observability/aws-otel-collector:v0.26.1",
			"essential": true,
			"command": [
				"--config=/etc/ecs/otel-instance-metrics-config.yaml"
			],
			"logConfiguration": {
				"logDriver": "awslogs",
				"options": {
					"awslogs-create-group": "True",
					"awslogs-group": "/ecs/ecs-aws-otel-sidecar-collector",
					"awslogs-region": "us-east-1",
					"awslogs-stream-prefix": "ecs"
				}
			}
		}
	],
	"networkMode": "awsvpc",
	"requiresCompatibilities": [
		"FARGATE"
	],
	"cpu": "1024",
	"memory": "3072"
}