Skip to main content

Metrics Server și kubectl top

Rolul Metrics Server​

Metrics Server colectează periodic utilizarea CPU și memorie raportată de kubelet și o expune prin API-ul agregat metrics.k8s.io.

Aceste date sunt folosite de:

  • kubectl top nodes și kubectl top pods
  • HorizontalPodAutoscaler pentru metrici de resurse
  • alte controloare care au nevoie de valori curente, nu de istoric.

Metrics Server nu este o bază de date temporală, nu păstrează istoric și nu înlocuiește Prometheus.

Instalare​

În clusterul Kind folosim chart-ul oficial, fixat la versiunea 3.14.0:

helm repo add metrics-server https://kubernetes-sigs.github.io/metrics-server/ --force-update

helm upgrade --install metrics-server metrics-server/metrics-server \
--namespace kube-system \
--version 3.14.0 \
--set 'args={--kubelet-insecure-tls,--kubelet-preferred-address-types=InternalIP}' \
--wait --timeout 3m

--kubelet-insecure-tls este necesar numai pentru mediul local Kind, unde certificatele kubelet sunt self-signed. Nu este o recomandare pentru producție.

Verificare​

kubectl get deployment metrics-server -n kube-system
kubectl get apiservice v1beta1.metrics.k8s.io
kubectl top nodes
kubectl top pods --all-namespaces

La câteva secunde după instalare, APIService trebuie să fie Available=True, iar comenzile kubectl top trebuie să returneze valori.

Putem interoga direct API-ul agregat:

kubectl get --raw /apis/metrics.k8s.io/v1beta1/nodes | jq '.items[].usage'

Legătura cu HPA​

HPA compară utilizarea curentă cu resources.requests din Deployment. Dacă un container nu are CPU request, utilizarea procentuală nu poate fi calculată corect. Ticketing API declară:

resources:
requests:
cpu: 25m
memory: 32Mi

Vom reveni asupra acestei relații în scenariul de autoscaling.

Diagnostic

Dacă kubectl top răspunde cu Metrics API not available, verificați mai întâi:

kubectl logs deployment/metrics-server -n kube-system --tail=100
kubectl describe apiservice v1beta1.metrics.k8s.io