CloudWatch Logs에 로그를 전송하도록 FireLens 설정

Amazon ECS용 FireLens를 통해 태스크 정의 파라미터를 사용하여 로그를 Amazon CloudWatch Logs로 경로 지정함으로써 로그를 저장 및 분석할 수 있습니다. FireLens는 Fluent Bit 및 Fluentd와 함께 작동합니다. AWS for Fluent Bit 이미지를 제공하므로 이를 사용하거나 자체 Fluent Bit 또는 Fluentd 이미지를 사용할 수 있습니다. FireLens 구성을 사용한 Amazon ECS 태스크 정의 생성은 AWS SDK, AWS CLI, AWS Management Console을 통해 지원됩니다. CloudWatch Logs에 대한 자세한 내용은 CloudWatch Logs란? 단원을 참조하세요.

Amazon ECS용 FireLens를 사용할 때 고려할 주요 사항이 있습니다. 자세한 내용은 고려 사항 단원을 참조하세요.

AWS for Fluent Bit 이미지를 찾으려면 AWS for Fluent Bit 이미지 사용 단원을 참조하세요.

FireLens 구성을 사용하는 태스크 정의를 생성하려면 FireLens 구성을 사용하는 태스크 정의 생성 단원을 참조하세요.

예

다음 태스크 정의 예에서는 로그를 CloudWatch Logs 로그 그룹에 전달하는 로그 구성을 지정하는 방법을 보여 줍니다. 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 Amazon CloudWatch Logs란? 섹션을 참조하세요.

로그 구성 옵션에서 로그 그룹 이름과 이 그룹이 속한 리전을 지정합니다. 사용자를 대신하여 Fluent Bit가 로그 그룹을 생성하게 하려면 "auto_create_group":"true"를 지정합니다. 또한 필터링을 지원하는 로그 스트림 접두사로 태스크 ID를 지정할 수도 있습니다. 자세한 정보는 Fluent Bit Plugin for CloudWatch Logs를 참조하세요.

{
	"family": "firelens-example-cloudwatch",
	"taskRoleArn": "arn:aws:iam::123456789012:role/ecs_task_iam_role",
	"containerDefinitions": [
		{
			"essential": true,
			"image": "906394416424.dkr.ecr.us-west-2.amazonaws.com/aws-for-fluent-bit:latest",
			"name": "log_router",
			"firelensConfiguration": {
				"type": "fluentbit"
			},
			"logConfiguration": {
				"logDriver": "awslogs",
				"options": {
					"awslogs-group": "firelens-container",
					"awslogs-region": "us-west-2",
					"awslogs-create-group": "true",
					"awslogs-stream-prefix": "firelens"
				}
			},
			"memoryReservation": 50
		 },
		 {
			 "essential": true,
			 "image": "nginx",
			 "name": "app",
			 "logConfiguration": {
				 "logDriver":"awsfirelens",
				 "options": {
					"Name": "cloudwatch_logs",
					"region": "us-west-2",
					"log_key": "log",
                                 "log_group_name": "/aws/ecs/containerinsights/$(ecs_cluster)/application",
					"auto_create_group": "true",
					"log_stream_name": "$(ecs_task_id)"
				}
			},
			"memoryReservation": 100
		}
	]
}