Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Identification des opportunités d’optimisation d’Amazon ECS à l’aide des données de suivi des applications
<a name="trace-data"></a>

Amazon ECS s'intègre à AWS Distro pour collecter des données de suivi OpenTelemetry à partir de votre application. Amazon ECS utilise un conteneur AWS Distro for OpenTelemetry sidecar pour collecter et acheminer les données de suivi. AWS X-Ray Pour plus d'informations, consultez [Configuration de AWS Distro pour OpenTelemetry Collector dans Amazon ECS.](https://aws-otel.github.io/docs/setup/ecs) Vous pouvez ensuite l'utiliser AWS X-Ray pour identifier les erreurs et les exceptions, analyser les goulots d'étranglement liés aux performances et les temps de réponse.

Pour que AWS Distro for OpenTelemetry Collector envoie des données de trace AWS X-Ray, votre application doit être configurée pour créer les données de trace. Pour plus d'informations, consultez [Instrumenter votre application pour AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html) dans le *Guide du développeur AWS X-Ray *.

## Autorisations IAM requises pour AWS Distro pour OpenTelemetry l'intégration avec AWS X-Ray
<a name="trace-data-iam"></a>

L'intégration d'Amazon ECS à AWS Distro for OpenTelemetry nécessite que vous créiez un rôle de tâche et que vous le spécifiiez dans la définition de votre tâche. Nous vous recommandons de configurer la AWS distribution pour le OpenTelemetry sidecar afin d'acheminer les journaux des conteneurs vers les journaux. CloudWatch 

**Important**  
Si vous collectez également des métriques d'application à l'aide de AWS Distro pour OpenTelemetry l'intégration, assurez-vous que le rôle IAM de votre tâche contient également les autorisations nécessaires à cette intégration. Pour de plus amples informations, veuillez consulter [Corrélation des performances des applications Amazon ECS à l’aide des métriques d’application](metrics-data.md).

Après avoir créé le rôle, créez une politique avec les autorisations suivantes, puis associez-la au rôle.
+ `logs:PutLogEvents`
+ `logs:CreateLogGroup`
+ `logs:CreateLogStream`
+ `logs:DescribeLogStreams`
+ `logs:DescribeLogGroups`
+ `logs:PutRetentionPolicy`
+ `xray:PutTraceSegments`
+ `xray:PutTelemetryRecords`
+ `xray:GetSamplingRules`
+ `xray:GetSamplingTargets`
+ `xray:GetSamplingStatisticSummaries`
+ `ssm:GetParameters`

# Spécification de la AWS distribution pour le OpenTelemetry sidecar à AWS X-Ray intégrer dans la définition de votre tâche
<a name="trace-data-containerdefinitions"></a>

La console Amazon ECS simplifie la création du conteneur AWS Distro for OpenTelemetry sidecar en **utilisant l'option Use trace collection**. Pour de plus amples informations, veuillez consulter [Création d’une définition de tâche Amazon ECS à l’aide de la console](create-task-definition.md).

Si vous n'utilisez pas la console Amazon ECS, vous pouvez ajouter le conteneur AWS Distro for OpenTelemetry sidecar à votre définition de tâche. L'extrait de définition de tâche suivant montre la définition du conteneur pour l'ajout de AWS Distro pour le OpenTelemetry sidecar à des fins d'intégration. 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"
}
```