Kube-controller-manager metrics and dashboard - Container Service for Kubernetes

Concepts clés

Workqueue

Terminologie Workqueue

Les contrôleurs gérés par kube-controller-manager, tels que Node Controller, StatefulSet Controller et Deployment Controller, utilisent une Workqueue pour traiter les mises à jour des ressources. Lorsqu'un événement survient (création, mise à jour ou suppression d'un Pod), le contrôleur place l'identifiant de la ressource (par exemple, le nom et l'espace de noms du Pod) dans la Workqueue. Une boucle de traitement récupère et traite ensuite ces identifiants.

Prérequis

Accéder au tableau de bord

Consultez la rubrique Afficher les tableaux de bord de surveillance des composants du plan de contrôle du cluster.

Liste des métriques

Le tableau suivant répertorie les métriques de kube-controller-manager.

Métrique	Type	Description
workqueue_adds_total	Counter	Nombre total d'événements ajoutés à la Workqueue.
workqueue_depth	Gauge	Profondeur actuelle de la Workqueue. Une valeur élevée persistante indique que le contrôleur ne parvient pas à traiter les tâches assez rapidement, ce qui génère un arriéré.
workqueue_queue_duration_seconds_bucket	Histogram	Temps d'attente d'un élément dans la Workqueue. Seuils des buckets : {10^-8, 10^-7, 10^-6, 10^-5, 10^-4, 10^-3, 10^-2, 10^-1, 1, 10}. Unité : secondes.
memory_utilization_byte	Gauge	Utilisation de la mémoire. Unité : octets.
cpu_utilization_core	Gauge	Utilisation du CPU. Unité : cœurs.
resource_utilization_level	Gauge	Niveau d'utilisation des ressources. resource : type de ressource. Valeurs valides : `cpu` et `memory`. utilization_level : niveau d'utilisation. Valeurs valides : `high` (utilisation ≥ 80 %) et `normal` (utilisation < 80 %). container : conteneur cible. Valeurs valides : `kube-apiserver`, `kube-scheduler`, `kube-controller-manager`, `cloud-controller-manager` et `etcd`.
rest_client_requests_total	Counter	Nombre total de requêtes HTTP par code de statut, méthode et hôte.
rest_client_request_duration_seconds_bucket	Histogram	Latence des requêtes HTTP par verbe et URL.

Remarque

Les métriques d'utilisation des ressources suivantes sont obsolètes. Supprimez toute alerte ou règle de surveillance dépendant de ces métriques :

cpu_utilization_ratio : utilisation du CPU.
memory_utilization_ratio : utilisation de la mémoire.

Utilisation du tableau de bord

Configurez le quantile de la requête et l'intervalle d'échantillonnage PromQL sur le tableau de bord. Les sections suivantes décrivent chaque graphique ainsi que sa requête PromQL.

Workqueue

Vue du tableau de bord

Graphiques

|
**Nom**
|
**PromQL**
|
**Description**
| | --- | --- | --- | |
**Workqueue Add Rate**
|
sum(rate(workqueue_adds_total{job="ack-kube-controller-manager"}[$interval])) by (name)
|
Taux d'événements ajoutés à la Workqueue.
| |
**Workqueue Depth**
|
sum(rate(workqueue_depth{job="ack-kube-controller-manager"}[$interval])) by (name)
|
Taux moyen de variation de la profondeur de la Workqueue.
| |
**Workqueue Processing Latency**
|
histogram_quantile($quantile, sum(rate(workqueue_queue_duration_seconds_bucket{job="ack-kube-controller-manager"}[5m])) by (name, le))
|
Temps d'attente d'un élément dans la Workqueue.
|

Ressources

Vue du tableau de bord

Graphiques

Nom du graphique	PromQL	Description
Memory Utilization	memory_utilization_byte{container="kube-controller-manager"}	Utilisation de la mémoire. Unité : octets.
CPU Utilization	cpu_utilization_core{container="kube-controller-manager"}*1000	Utilisation du CPU. Unité : millicœurs.
Memory Resource Utilization Level	resource_utilization_level{resource="memory",container="kube-controller-manager",utilization_level="high"} resource_utilization_level{resource="memory",container="kube-controller-manager",utilization_level="normal"}	Si `resource_utilization_level{utilization_level="high",...}` est égal à 1, le niveau d'utilisation des ressources du conteneur est ≥ 80 %. Si `resource_utilization_level{utilization_level="normal",...}` est égal à 1, le niveau d'utilisation des ressources du conteneur est < 80 %.
CPU Resource Utilization Level	resource_utilization_level{resource="cpu",container="kube-controller-manager",utilization_level="high"} resource_utilization_level{resource="cpu",container="kube-controller-manager",utilization_level="normal"}

Kube API

Vue du tableau de bord

Graphiques

Nom du graphique	PromQL	Description
Kube API Request QPS	sum(rate(rest_client_requests_total{job="ack-kube-controller-manager",code=~"2.."}[$interval])) by (method,code) sum(rate(rest_client_requests_total{job="ack-kube-controller-manager",code=~"3.."}[$interval])) by (method,code) sum(rate(rest_client_requests_total{job="ack-kube-controller-manager",code=~"4.."}[$interval])) by (method,code) sum(rate(rest_client_requests_total{job="ack-kube-controller-manager",code=~"5.."}[$interval])) by (method,code)	QPS des requêtes HTTP de kube-controller-manager vers kube-apiserver, par méthode et code de statut.
Kube API Request Latency	histogram_quantile($quantile, sum(rate(rest_client_request_duration_seconds_bucket{job="ack-kube-controller-manager"}[$interval])) by (verb,url,le))	Latence des requêtes HTTP de kube-controller-manager vers kube-apiserver, par verbe et URL.

Références

Pour consulter les métriques et les tableaux de bord des autres composants du plan de contrôle, reportez-vous aux rubriques Métriques de surveillance du composant kube-apiserver, Métriques de surveillance du composant etcd, Métriques de surveillance du composant kube-scheduler et Métriques de surveillance du composant cloud-controller-manager.