kubernetes-sigs/metrics-server

어떤 프로젝트인가요?

핵심 기능

• 01Kubelet에서 15초마다 CPU 및 메모리 사용량을 수집합니다.
• 02표준 Kubernetes Metrics API를 통해 Pod 및 노드 지표를 노출합니다.
• 03Horizontal Pod Autoscaler와 Vertical Pod Autoscaler의 확장 결정을 지원합니다.
• 04kubectl top으로 리소스 사용량을 빠르게 확인할 수 있습니다.
• 05여러 복제본을 사용하는 고가용성 모드를 지원합니다.
• 06Kubelet 주소 유형과 TLS 옵션을 설정할 수 있습니다.

활용 사례

• CPU 또는 메모리 사용률을 기준으로 Deployment를 수평 확장합니다.
• 컨테이너 리소스 요청의 수직 크기 조정을 위한 제안을 확인합니다.
• kubectl top으로 자동 확장 동작을 디버깅합니다.
• 중간 규모 Kubernetes 클러스터에서 가벼운 지표 소스를 운영합니다.

빠른 시작

1. 1

   components.yaml 매니페스트에서 최신 릴리스를 설치합니다

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

   잠시 기다린 후 kubectl top으로 메트릭을 확인합니다

   kubectl top pods

사용 전 알아둘 점

• !활성화된 aggregation layer와 클러스터 CA가 서명한 kubelet 인증서 등 특정 클러스터 설정이 필요합니다.
• !오토스케일링 전용으로 설계되었습니다. README에서는 모니터링 메트릭 소스로 사용하지 말라고 안내합니다.
• !기본 리소스 요청은 약 100개 노드까지를 기준으로 조정되어 있습니다. 더 큰 클러스터에는 더 많은 리소스가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

metrics-server은(는) 무엇인가요?

Metrics API를 통해 제공되는, Kubernetes 자동 확장을 위한 확장 가능한 컨테이너 CPU 및 메모리 리소스 지표 소스입니다. Metrics Server는 Kubelet에서 리소스 지표를 수집해 Metrics API를 통해 Kubernetes apiserver에 노출합니다. Horizontal Pod Autoscaler와 Vertical Pod Autoscaler는 이 데이터를 사용해 확장 결정을 내리고, kubectl top은 같은 API를 읽어 Pod와 노드의 사용량을 표시합니다.

metrics-server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

metrics-server은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

metrics-server은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. metrics-server의 마지막 커밋은 2026년 10월 16일입니다.

metrics-server은(는) 어디에 사용할 수 있나요?

CPU 또는 메모리 사용률을 기준으로 Deployment를 수평 확장합니다. 컨테이너 리소스 요청의 수직 크기 조정을 위한 제안을 확인합니다. kubectl top으로 자동 확장 동작을 디버깅합니다. 중간 규모 Kubernetes 클러스터에서 가벼운 지표 소스를 운영합니다.

metrics-server는 어떻게 설치하나요?

components.yaml 매니페스트에서 최신 릴리스를 설치합니다: kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml 잠시 기다린 후 kubectl top으로 메트릭을 확인합니다: kubectl top pods

metrics-server은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/kubernetes-sigs/metrics-server