# Amazon ECS에서 Container Insights 설정
Amazon ECS 콘솔 또는 AWS CLI를 사용하면 새 Amazon ECS 클러스터와 기존 Amazon ECS 클러스터에서 향상된 관찰성을 갖춘 Container Insights 또는 Container Insights를 설정할 수 있습니다. Container Insights는 클러스터, 작업 및 서비스 레벨에서 지표를 수집합니다. 향상된 관찰성을 갖춘 Container Insights는 추가적인 차원과 지표를 제공하므로, 컨테이너 수준 가시성을 심층적으로 파악할 수 있습니다.
Amazon EC2 인스턴스에서 Amazon ECS를 사용하는 경우, Amazon ECS 에이전트 버전 1.29 이상이 포함된 AMI를 사용하여 해당 인스턴스를 시작합니다. 에이전트 버전 업데이트에 대한 자세한 내용은 [Amazon ECS 컨테이너 에이전트 업데이트](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html) 섹션을 참조하세요.
**참고**
Amazon ECS Container Insights 지표에 사용하는 고객 관리 AWS KMS 키가 CloudWatch와 함께 작동하도록 아직 구성되지 않은 경우, CloudWatch Logs에서 암호화된 로그를 허용하도록 키 정책을 업데이트해야 합니다. 또한 사용자 고유의 AWS KMS 키를 `/aws/ecs/containerinsights/ClusterName/performance`의 로그 그룹과 연결해야 합니다. 자세한 내용은 [AWS Key Management Service를 사용하여 CloudWatch Logs의 로그 데이터 암호화](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/encrypt-log-data-kms.html) 섹션을 참조하세요.
Container Insights 대신 개선된 관찰성을 갖춘 Container Insights를 사용하는 것이 좋습니다. 컨테이너 환경에서 세부적인 가시성을 제공하여 평균 해결 시간을 단축하기 때문입니다.
## 향상된 관찰 기능을 갖춘 Container Insights 설정
Amazon ECS 콘솔 또는 AWS CLI를 사용하여 향상된 관찰성을 갖춘 Container Insights를 켤 수 있습니다.
------
#### [ AWS CLI ]
다음 명령을 사용하여 향상된 관찰성을 갖춘 Container Insights를 켭니다.
`containerInsights` 계정 설정을 `enhanced`로 설정
```
aws ecs put-account-setting --name containerInsights --value enhanced
```
출력 예시
```
{
"setting": {
"name": "containerInsights",
"value": "enhanced",
"principalArn": "arn:aws:iam::123456789012:johndoe",
"type": user
}
}
```
**참고**
기본적으로는 현재 인증된 사용자에게만 `put-account-setting`이 적용됩니다. 모든 사용자 및 역할에 대해 계정 전체로 설정을 활성화하려면 다음 예제와 같이 루트 사용자를 사용합니다.
```
aws ecs put-account-setting --name containerInsights --value enhanced --principal-arn arn:aws:iam::accountID:root
```
이 계정 설정을 설정하면 모든 새 클러스터가 향상된 관찰성을 갖춘 Container Insights를 자동으로 사용합니다. `update-cluster-settings` 명령을 사용하여 기존 클러스터에 향상된 관찰성을 갖춘 Container Insights를 추가하거나, 현재 Container Insights를 사용하는 클러스터를 향상된 관찰성을 갖춘 Container Insights로 업그레이드합니다.
```
aws ecs update-cluster-settings --cluster cluster-name --settings name=containerInsights,value=enhanced
```
------
#### [ Amazon ECS console ]
1. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)에서 콘솔을 엽니다.
1. 상단의 탐색 모음에서 계정 설정을 보려는 리전을 선택합니다.
1. 탐색 페이지에서 **Account Settings**(계정 설정)를 선택합니다.
1. **업데이트**를 선택합니다.
1. 향상된 관찰성을 갖춘 Container Insights를 사용하려면 **Container Insights with enhanced observability**를 선택합니다.
1. **변경 사항 저장**을 선택합니다.
1. 확인 화면에서 **확인(Confirm)**을 선택해 해당 선택을 저장합니다.
이를 설정하면 모든 새 클러스터가 향상된 관찰성을 갖춘 Container Insights를 자동으로 사용합니다. 향상된 관찰성을 갖춘 Container Insights를 기존 클러스터에 추가하거나, 현재 Container Insights를 사용하는 클러스터를 향상된 관찰성을 갖춘 Container Insights로 업데이트합니다. 자세한 내용을 알아보려면 **Amazon Elastic Container Service 개발자 안내서의 [Amazon ECS 클러스터 업데이트](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-cluster-v2.html) 섹션을 참조하세요.
------
## Container Insights 설정
Amazon ECS 콘솔 또는 AWS CLI를 사용하여 Container Insights를 켤 수 있습니다.
------
#### [ AWS CLI ]
Container Insights를 사용하려면 `container Insights` 계정 설정을 `enabled`로 설정합니다. 다음 명령 중 하나를 사용하여 Container Insights를 켭니다.
```
aws ecs put-account-setting --name containerInsights --value enabled
```
출력 예시
```
{
"setting": {
"name": "container Insights",
"value": "enabled",
"principalArn": "arn:aws:iam::123456789012:johndoe",
"type": user
}
}
```
`container Insights` 계정 설정을 `enabled`로 설정할 경우, 기본적으로 모든 새 클러스터에 Container Insights가 활성화됩니다. `update-cluster-settings` 명령을 사용하여 기존 클러스터에 Container Insights를 추가합니다.
```
aws ecs update-cluster-settings --cluster cluster-name --settings name=containerInsights,value=enabled
```
------
#### [ Amazon ECS console ]
1. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)에서 콘솔을 엽니다.
1. 상단의 탐색 모음에서 계정 설정을 보려는 리전을 선택합니다.
1. 탐색 페이지에서 **Account Settings**(계정 설정)를 선택합니다.
1. **업데이트**를 선택합니다.
1. Container Insights를 사용하려면 **Container Insights**를 선택합니다.
1. **변경 사항 저장**을 선택합니다.
1. 확인 화면에서 **확인(Confirm)**을 선택해 해당 선택을 저장합니다.
이를 설정하면 모든 새 클러스터가 Container Insights를 자동으로 사용합니다. 기존 클러스터를 Container Insights에 추가하도록 업데이트합니다. 자세한 내용을 알아보려면 **Amazon Elastic Container Service 개발자 안내서의 [Amazon ECS 클러스터 업데이트](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-cluster-v2.html) 섹션을 참조하세요.
------