Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Identifikasi peluang pengoptimalan Amazon ECS menggunakan data pelacakan aplikasi
<a name="trace-data"></a>

Amazon ECS terintegrasi dengan AWS Distro OpenTelemetry untuk mengumpulkan data jejak dari aplikasi Anda. Amazon ECS menggunakan AWS Distro untuk wadah OpenTelemetry sespan untuk mengumpulkan dan merutekan data penelusuran ke. AWS X-Ray Untuk informasi selengkapnya, lihat [Menyiapkan AWS Distro untuk OpenTelemetry Kolektor di Amazon ECS](https://aws-otel.github.io/docs/setup/ecs). Anda kemudian dapat menggunakan AWS X-Ray untuk mengidentifikasi kesalahan dan pengecualian, menganalisis kemacetan kinerja dan waktu respons.

Agar AWS Distro for OpenTelemetry Collector dapat mengirim data jejak AWS X-Ray, aplikasi Anda harus dikonfigurasi untuk membuat data jejak. Untuk informasi selengkapnya, lihat [Menginstrumentasi aplikasi Anda AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html) di *Panduan AWS X-Ray Pengembang*.

## Izin IAM yang diperlukan untuk AWS Distro untuk integrasi dengan OpenTelemetry AWS X-Ray
<a name="trace-data-iam"></a>

Integrasi Amazon ECS dengan AWS Distro for OpenTelemetry mengharuskan Anda membuat peran tugas dan menentukan peran dalam definisi tugas Anda. Kami menyarankan Anda mengonfigurasi AWS Distro untuk OpenTelemetry sespan untuk merutekan log kontainer ke Log. CloudWatch 

**penting**  
Jika Anda juga mengumpulkan metrik aplikasi menggunakan AWS Distro untuk OpenTelemetry integrasi, pastikan peran IAM tugas Anda juga berisi izin yang diperlukan untuk integrasi tersebut. Untuk informasi selengkapnya, lihat [Korelasikan kinerja aplikasi Amazon ECS menggunakan metrik aplikasi](metrics-data.md).

Setelah Anda membuat peran, buat kebijakan dengan izin berikut, lalu lampirkan ke peran tersebut.
+ `logs:PutLogEvents`
+ `logs:CreateLogGroup`
+ `logs:CreateLogStream`
+ `logs:DescribeLogStreams`
+ `logs:DescribeLogGroups`
+ `logs:PutRetentionPolicy`
+ `xray:PutTraceSegments`
+ `xray:PutTelemetryRecords`
+ `xray:GetSamplingRules`
+ `xray:GetSamplingTargets`
+ `xray:GetSamplingStatisticSummaries`
+ `ssm:GetParameters`

# Menentukan AWS Distro untuk OpenTelemetry sespan untuk AWS X-Ray integrasi dalam definisi tugas Anda
<a name="trace-data-containerdefinitions"></a>

**Konsol Amazon ECS menyederhanakan pembuatan AWS Distro untuk wadah OpenTelemetry sespan dengan menggunakan opsi Use trace collection.** Untuk informasi selengkapnya, lihat [Membuat definisi tugas Amazon ECS menggunakan konsol](create-task-definition.md).

Jika Anda tidak menggunakan konsol Amazon ECS, Anda dapat menambahkan AWS Distro untuk wadah OpenTelemetry sespan ke definisi tugas Anda. Cuplikan definisi tugas berikut menunjukkan definisi container untuk menambahkan AWS Distro untuk OpenTelemetry sespan untuk integrasi. AWS 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.30.0",
			"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"
}
```