Exportação de métricas de aplicações para o Amazon CloudWatch

O Amazon ECS no Fargate oferece suporte à exportação de métricas de aplicações personalizadas para o Amazon CloudWatch como métricas personalizadas. Isso é feito adicionando o contêiner de arquivo associado da distribuição da AWS do OpenTelemetry à sua definição de tarefa. O console do Amazon ECS simplifica esse processo adicionando a opção Usar coleta de métricas ao criar uma definição de tarefa. Para ter mais informações, consulte Criar uma definição de tarefa do Amazon ECS usando o console.

As métricas da aplicação são exportadas para o CloudWatch Logs com o nome do grupo de logs /aws/ecs/application/metrics e as métricas podem ser exibidas no namespace ECS/AWSOTel/Application. Sua aplicação deve ser instrumentada com o SDK OpenTelemetry. Para obter mais informações, consulte Introdução à distribuição da AWS do OpenTelemetry, na documentação da distribuição da AWS do OpenTelemetry.

Considerações

As informações a seguir devem ser consideradas quando for usada a integração do Amazon ECS na Fargate com a distribuição da AWS do OpenTelemetry para o envio de métricas de aplicações para o Amazon CloudWatch.

Permissões obrigatórias do IAM para integração da distribuição da AWS do OpenTelemetry com o Amazon CloudWatch

A integração do Amazon ECS com a distribuição da AWS do OpenTelemetry requer que você crie uma função do IAM de tarefa e especifique a função na definição de tarefa. Recomendamos que o arquivo associado da distribuição da AWS do OpenTelemetry também possa ser configurado para encaminhar logs de contêiner para o CloudWatch Logs, o que exige que uma função do IAM de execução de tarefa seja criada e especificada também na definição da tarefa. O console do Amazon ECS cuida do perfil do IAM de execução de tarefas em seu nome, mas o perfil do IAM da tarefa deve ser criado manualmente e adicionado à definição de tarefa. Para obter mais informações sobre a função do IAM de execução de tarefas, consulte Função do IAM de execução de tarefas do Amazon ECS.

Especificação do arquivo associado da distribuição da AWS do OpenTelemetry na sua definição de tarefa

O console do Amazon ECS simplifica a experiência de criação do contêiner auxiliar do AWS Distro para OpenTelemetry utilizando a opção Usar coleta de métricas. Para ter mais informações, consulte Criar uma definição de tarefa do Amazon ECS usando o console.

Se você não estiver usando o console do Amazon ECS, poderá adicionar o contêiner de arquivo associado da distribuição da AWS do OpenTelemetry à sua definição de tarefa manualmente. O exemplo de definição de tarefa a seguir mostra a definição do contêiner para adicionar o arquivo associado da distribuição da AWS do OpenTelemetry para integração do 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"
}