기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 대시보드 설정
다음 정보를 사용하여 Amazon SageMaker HyperPod Amazon CloudWatch Observability EKS 추가 기능을 설정합니다. 이렇게 하면 EKS 클러스터 하드웨어, 팀 할당 및 작업에 대한 지표를 볼 수 있는 상세한 시각적 대시보드가 제공됩니다.
설정에 문제가 있는 경우 [문제 해결](sagemaker-hyperpod-eks-operate-console-ui-governance-troubleshoot.md)에서 알려진 문제 해결 솔루션을 참조하세요.
**Topics**
+ [HyperPod Amazon CloudWatch Observability EKS 추가 기능 사전 조건](#hp-eks-dashboard-prerequisites)
+ [HyperPod Amazon CloudWatch Observability EKS 추가 기능 설정](#hp-eks-dashboard-setup)
## HyperPod Amazon CloudWatch Observability EKS 추가 기능 사전 조건
아래 섹션에는 Amazon EKS Observability 추가 기능을 설치하기 전에 충족해야 하는 사전 조건이 포함되어 있습니다.
+ [클러스터 관리자의 IAM 사용자](sagemaker-hyperpod-prerequisites-iam.md#sagemaker-hyperpod-prerequisites-iam-cluster-admin)에서 HyperPod 클러스터 관리자에 대한 최소 권한 정책이 있는지 확인합니다.
+ 워커 노드에 `CloudWatchAgentServerPolicy` IAM 정책을 연결합니다. 이를 위해 다음 명령을 입력합니다. `{{my-worker-node-role}}`을 Kubernetes 워커 노드에서 사용하는 IAM 역할로 대체합니다.
```
aws iam attach-role-policy \
--role-name {{my-worker-node-role}} \
--policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy
```
## HyperPod Amazon CloudWatch Observability EKS 추가 기능 설정
다음 옵션을 사용하여 Amazon SageMaker HyperPod Amazon CloudWatch Observability EKS 추가 기능을 설정합니다.
------
#### [ Setup using the SageMaker AI console ]
HyperPod 태스크 거버넌스 대시보드를 설정하고 시각화하려면 다음 권한이 필요합니다. 이 섹션에서는 [클러스터 관리자의 IAM 사용자](sagemaker-hyperpod-prerequisites-iam.md#sagemaker-hyperpod-prerequisites-iam-cluster-admin)에 나열된 권한에 더해 설명합니다.
태스크 거버넌스를 관리하려면 샘플 정책을 사용합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sagemaker:ListClusters",
"sagemaker:DescribeCluster",
"sagemaker:ListComputeQuotas",
"sagemaker:CreateComputeQuota",
"sagemaker:UpdateComputeQuota",
"sagemaker:DescribeComputeQuota",
"sagemaker:DeleteComputeQuota",
"sagemaker:ListClusterSchedulerConfigs",
"sagemaker:DescribeClusterSchedulerConfig",
"sagemaker:CreateClusterSchedulerConfig",
"sagemaker:UpdateClusterSchedulerConfig",
"sagemaker:DeleteClusterSchedulerConfig",
"eks:ListAddons",
"eks:CreateAddon",
"eks:DescribeAddon",
"eks:DescribeCluster",
"eks:DescribeAccessEntry",
"eks:ListAssociatedAccessPolicies",
"eks:AssociateAccessPolicy",
"eks:DisassociateAccessPolicy"
],
"Resource": "*"
}
]
}
```
------
Amazon CloudWatch Observability Amazon EKS를 관리하고 SageMaker AI 콘솔을 통해 HyperPod 클러스터 대시보드를 볼 수 있는 권한을 부여하려면 아래 샘플 정책을 사용합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"eks:ListAddons",
"eks:CreateAddon",
"eks:UpdateAddon",
"eks:DescribeAddon",
"eks:DescribeAddonVersions",
"sagemaker:DescribeCluster",
"sagemaker:DescribeClusterNode",
"sagemaker:ListClusterNodes",
"sagemaker:ListClusters",
"sagemaker:ListComputeQuotas",
"sagemaker:DescribeComputeQuota",
"sagemaker:ListClusterSchedulerConfigs",
"sagemaker:DescribeClusterSchedulerConfig",
"eks:DescribeCluster",
"cloudwatch:GetMetricData",
"eks:AccessKubernetesApi"
],
"Resource": "*"
}
]
}
```
------
SageMaker HyperPod 콘솔의 **대시보드** 탭으로 이동하여 Amazon CloudWatch Observability EKS를 설치합니다. 태스크 거버넌스 관련 지표가 **대시보드**에 포함되도록 하려면 Kueue 지표 확인란을 활성화합니다. Kueue 지표를 활성화하면 프리 티어 한도에 도달한 후 CloudWatch **지표** 비용이 활성화됩니다. 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing/)에서 **지표**를 참조하세요.
------
#### [ Setup using the EKS AWS CLI ]
다음 EKS AWS CLI 명령을 사용하여 추가 기능을 설치합니다.
```
aws eks create-addon --cluster-name {{cluster-name}}
--addon-name amazon-cloudwatch-observability
--configuration-values "{{configuration json}}"
```
다음은 구성 값의 JSON 예시입니다.
```
{
"agent": {
"config": {
"logs": {
"metrics_collected": {
"kubernetes": {
"kueue_container_insights": true,
"enhanced_container_insights": true
},
"application_signals": { }
}
},
"traces": {
"traces_collected": {
"application_signals": { }
}
}
},
},
}
```
------
#### [ Setup using the EKS Console UI ]
1. [EKS 콘솔](https://console.aws.amazon.com/eks/home#/clusters)로 이동합니다.
1. 클러스터를 선택합니다.
1. **애드온 기능**을 선택합니다.
1. **Amazon CloudWatch Observability** 추가 기능을 찾아 설치합니다. 2.4.0 이상 버전의 추가 기능을 설치합니다.
1. 다음 JSON 구성 값을 포함합니다.
```
{
"agent": {
"config": {
"logs": {
"metrics_collected": {
"kubernetes": {
"kueue_container_insights": true,
"enhanced_container_insights": true
},
"application_signals": { }
},
},
"traces": {
"traces_collected": {
"application_signals": { }
}
}
},
},
}
```
------
EKS Observability 추가 기능을 성공적으로 설치한 후에는 HyperPod 콘솔의 **대시보드** 탭에서 EKS 클러스터 지표를 볼 수 있습니다.