# kube-state-metrics 배포

Kubernetes 오브젝트 상태 메트릭(`kube_*`: Pod/Deployment/Node/PVC 등)을 노출한다. vmagent가 스크레이핑하여 VictoriaMetrics로 전송한다.

## 1. 배포 방법

```sh
helm upgrade kube-state-metrics ./ -f custom-values.yaml --install -n monitoring
```

## 2. custom-values.yaml 설정 설명

리소스 요청/제한만 오버라이드한다(기본 nodeport·서비스 설정 사용). vmalert의 클러스터 헬스 알림(`kube_node_*`, `kube_pod_*`, `kube_deployment_*`)이 이 메트릭에 의존한다.

## 3. 의존 관계

- **스크레이프 주체**: vmagent (job: `kube-state-metrics`, namespace `monitoring`의 `http` 포트 keep)

## 4. 검증

```sh
kubectl port-forward -n monitoring svc/kube-state-metrics 8080:8080
curl -s http://localhost:8080/metrics | grep -c '^kube_'
```