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.

Exporter les métriques des applications vers Amazon CloudWatch

Amazon ECS on Fargate prend en charge l'exportation des métriques personnalisées de votre application vers CloudWatch Amazon en tant que métriques personnalisées. Cela se fait en ajoutant le conteneur AWS Distro for OpenTelemetry sidecar à votre définition de tâche. La ECS console Amazon simplifie ce processus en ajoutant l'option Utiliser la collecte de métriques lors de la création d'une nouvelle définition de tâche. Pour de plus amples informations, veuillez consulter Création d'une définition de ECS tâche Amazon à l'aide de la console.

Les métriques de l'application sont exportées vers CloudWatch Logs avec le nom du groupe de journaux /aws/ecs/application/metrics et les métriques peuvent être consultées dans l'espace de ECS/AWSOTel/Application noms. Votre application doit être instrumentée avec le OpenTelemetry SDK. Pour plus d'informations, voir Introduction à AWS Distro for OpenTelemetry in the AWS Distro pour OpenTelemetry la documentation.

Considérations

Les points suivants doivent être pris en compte lors de l'utilisation de l'intégration Amazon ECS on Fargate AWS avec Distro OpenTelemetry pour envoyer des métriques d'application à Amazon. CloudWatch

IAMAutorisations requises pour AWS Distro pour OpenTelemetry l'intégration à Amazon CloudWatch

L'ECSintégration d'Amazon à AWS Distro pour OpenTelemetry nécessite que vous créiez un IAM rôle de tâche et que vous le spécifiiez dans la définition de votre tâche. Nous recommandons que la AWS distribution pour OpenTelemetry sidecar soit également configurée pour acheminer les journaux des conteneurs vers CloudWatch des journaux, ce qui nécessite la création et la spécification d'un IAM rôle d'exécution de tâche dans votre définition de tâche. La ECS console Amazon prend en charge le IAM rôle d'exécution des tâches en votre nom, mais le IAM rôle de tâche doit être créé manuellement et ajouté à votre définition de tâche. Pour plus d'informations sur le IAM rôle d'exécution des tâches, consultezIAMRôle d'exécution des ECS tâches Amazon.

Spécification de la AWS distribution pour le OpenTelemetry sidecar dans la définition de votre tâche

La ECS console Amazon simplifie l'expérience de création du conteneur AWS Distro pour OpenTelemetry sidecar en utilisant l'option Use metric collection. Pour de plus amples informations, veuillez consulter Création d'une définition de ECS tâche Amazon à l'aide de la console.

Si vous n'utilisez pas la ECS console Amazon, vous pouvez ajouter manuellement le conteneur AWS Distro for OpenTelemetry sidecar à votre définition de tâche. L'exemple de définition de tâche suivant montre la définition de conteneur pour l'ajout de AWS Distro for OpenTelemetry sidecar pour l'intégration d'Amazon. CloudWatch

{
	"family": "otel-using-cloudwatch",
	"taskRoleArn": "arn:aws:iam::111122223333:role/AmazonECS_OpenTelemetryCloudWatchRole",
	"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/ecs-cloudwatch.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"
}