**이 페이지 개선에 도움 주기** 

이 사용자 가이드에 기여하려면 모든 페이지의 오른쪽 창에 있는 **GitHub에서 이 페이지 편집** 링크를 선택합니다.

# Kubernetes 지표 서버를 사용한 리소스 사용량 보기
<a name="metrics-server"></a>

Kubernetes 지표 서버는 클러스터에서 리소스 사용량 데이터의 집계자이며, 기본적으로 Amazon EKS 클러스터에 배포되어 있지 않습니다. 자세한 내용은 GitHub에서 [Kubernetes Metrics Server](https://github.com/kubernetes-sigs/metrics-server) 섹션을 참조하세요. 지표 서버는 [Horizontal Pod Autoscaler를 사용한 스케일 포드 배포](horizontal-pod-autoscaler.md) 또는 [Kubernetes 대시보드](eks-managing.md) 등의 다른 Kubernetes 추가 기능에서 일반적으로 사용됩니다. 자세한 내용은 Kubernetes 설명서의 [리소스 지표 파이프라인](https://kubernetes.io/docs/tasks/debug/debug-cluster/resource-metrics-pipeline/)을 참조하세요. 이 주제에서는 Amazon EKS 클러스터에 Kubernetes 지표 서버를 배포하는 방법을 설명합니다.

**중요**  
지표는 시점 분석을 위한 것이며 기록 분석을 위한 정확한 소스가 아닙니다. 모니터링 솔루션이나 기타 Auto Scaling 이외의 용도로는 사용할 수 없습니다. 모니터링 도구에 대한 자세한 내용은 [클러스터 성능 모니터링 및 로그 보기](eks-observe.md) 섹션을 참조하세요.

## 고려 사항
<a name="_considerations"></a>
+ 매니페스트를 사용하여 Fargate 노드에 Kubernetes Metrics Server를 수동으로 배포하는 경우, 기본값인 `10250`이 아닌 다른 포트를 사용하도록 `metrics-server` 배포를 구성합니다. 이 포트는 Fargate용으로 예약되어 있습니다. Metrics Server의 Amazon EKS 추가 기능 버전은 포트 `10251`을 사용하도록 사전 구성되어 있습니다.
+ 보안 그룹과 네트워크 ACL이 `metrics-server` 포드와 다른 모든 노드 및 포드 간에 포트 `10250`을 허용하는지 확인하세요. Kubernetes Metrics Server는 여전히 포트 `10250`을 사용하여 클러스터의 다른 엔드포인트에서 지표를 수집합니다. Fargate 노드에 배포하는 경우 구성된 대체 Metrics Server 포트와 포트 `10250`을 모두 허용하세요.

## Amazon EKS 추가 기능을 사용하여 커뮤니티 추가 기능으로 배포
<a name="_deploy_as_community_add_on_with_amazon_eks_add_ons"></a>

 **새로운 기능: 이제 AWS 콘솔 또는 Amazon EKS API를 사용하여 Metrics Server를 커뮤니티 추가 기능으로 배포할 수 있습니다.**

### AWS 콘솔을 사용하여 배포
<a name="deploy_with_shared_aws_console"></a>

1. AWS 콘솔에서 EKS 클러스터 열기

1. '추가 기능' 탭에서 **추가 기능 더 가져오기**를 선택하세요.

1. '커뮤니티 추가 기능' 섹션에서 **Metrics Server**를 선택하고 **다음**을 선택하세요.

1. EKS에서 클러스터에 적합한 추가 기능 버전을 결정합니다. **버전** 드롭다운 메뉴를 사용하여 버전을 변경할 수 있습니다.

1. **다음**을 선택하고 **생성**을 선택하여 추가 기능을 설치하세요.

### 추가 리소스
<a name="_additional_resources"></a>

[커뮤니티 추가 기능](community-addons.md)에 대해 자세히 알아보세요.

다른 Amazon EKS 추가 기능과 동일한 방식으로 커뮤니티 추가 기능을 설치하거나 업데이트합니다.
+  [Amazon EKS 추가 기능 생성](creating-an-add-on.md) 
+  [Amazon EKS 추가 기능 업데이트](updating-an-add-on.md) 
+  [클러스터에서 Amazon EKS 추가 기능 제거](removing-an-add-on.md) 

## 매니페스트를 사용하여 배포
<a name="_deploy_with_manifest"></a>

 **새로운 기능: 이제 AWS 콘솔 또는 Amazon EKS API를 사용하여 Metrics Server를 커뮤니티 추가 기능으로 배포할 수 있습니다. 이 매니페스트 설치 지침은 아카이브됩니다.**

1. 다음 명령을 사용하여 지표 서버를 배포합니다.

   ```
   kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml
   ```

   Fargate를 사용하는 경우 이 파일을 변경해야 합니다. 기본 구성에서 지표 서버는 포트 10250을 사용합니다. 이 포트는 Fargate에 예약되어 있습니다. components.yaml의 포트 10250에 대한 참조를 10251과 같은 다른 포트로 교체합니다.

1. 다음 명령을 사용하여 `metrics-server` 배포에서 원하는 수의 포드를 실행하고 있는지 확인합니다.

   ```
   kubectl get deployment metrics-server -n kube-system
   ```

   예제 출력은 다음과 같습니다.

   ```
   NAME             READY   UP-TO-DATE   AVAILABLE   AGE
   metrics-server   1/1     1            1           6m
   ```

1. 노드의 리소스(CPU/메모리) 사용량을 표시하여 지표 서버가 작동하는지 테스트합니다.

   ```
   kubectl top nodes
   ```

1. `Error from server (Forbidden)` 오류 메시지가 표시되면 Kubernetes RBAC 구성을 업데이트해야 합니다. 클러스터 지표를 읽으려면 Kubernetes RBAC ID에 충분한 권한이 필요합니다. GitHub에서 [지표를 읽는 데 필요한 최소 Kubernetes API 권한](https://github.com/kubernetes-sigs/metrics-server/blob/e285375a49e3bf77ddd78c08a05aaa44f2249ebd/manifests/base/rbac.yaml#L5C9-L5C41)을 검토하세요. [역할과 같은 AWS IAM 자격 증명에 Kubernetes API에 대한 액세스 권한 부여](grant-k8s-access.md#authentication-modes) 방법을 알아봅니다.