Passer au contenu principal
Lisez les métriques de nœud et de pod Kubernetes avec l’API publique (V2). Tous les points de terminaison s’authentifient avec votre jeton d’API personnel, sont limités à un seul site_id et prennent une plage temporelle from/to.

​
Interroger les métriques de nœud

Renvoie un NodesRow par instantané de nœud dans la plage temporelle. 
POST /api/v2/kubernetes/nodes

​
Corps de la requête

ChampTypeObligatoireDescription
site_idchaîneOuiSite à interroger.
fromchaîne (ISO 8601)OuiDébut de la plage temporelle (inclus).
tochaîne (ISO 8601)OuiFin de la plage temporelle (incluse).
node_namechaîneNonFiltrer sur un seul nœud. Une chaîne vide signifie aucun filtre.
{
  "site_id": "YOUR-SITE-ID",
  "from": "2026-06-22T00:00:00Z",
  "to": "2026-06-22T01:00:00Z",
  "node_name": ""
}

​
Réponse

Renvoie un tableau d’objets NodesRow, un par instantané de nœud. Chacun a ces champs :
ChampTypeDescription
timestampchaîne (ISO 8601)Quand l’instantané a été pris.
node_namechaîneNom du nœud Kubernetes.
cpu_usage_nano_coresnombreUtilisation CPU en nanocœurs.
memory_rss_bytesnombreMémoire RSS (Resident Set Size) en octets.
memory_usage_bytesnombreUtilisation totale de la mémoire en octets.
memory_working_set_bytesnombreMémoire de l’ensemble de travail en octets.
memory_page_faultsnombreNombre de défauts de page.
memory_major_page_faultsnombreNombre de défauts de page majeurs.
fs_used_bytesnombreEspace utilisé du système de fichiers en octets.
fs_available_bytesnombreEspace disponible du système de fichiers en octets.
fs_capacity_bytesnombreCapacité totale du système de fichiers en octets.
fs_inodes_freenombreNombre d’inodes libres du système de fichiers.
fs_inodes_usednombreNombre d’inodes utilisés du système de fichiers.
fs_inodesnombreNombre total d’inodes du système de fichiers.
network_rx_bytesnombreOctets reçus sur le réseau.
network_tx_bytesnombreOctets transmis sur le réseau.
phasenombrePhase du nœud, en tant que valeur numérique.

​
Interroger les métriques de pod

Renvoie un PodsRow par instantané de pod dans la plage temporelle. 
POST /api/v2/kubernetes/pods

​
Corps de la requête

ChampTypeObligatoireDescription
site_idchaîneOuiSite à interroger.
fromchaîne (ISO 8601)OuiDébut de la plage temporelle (inclus).
tochaîne (ISO 8601)OuiFin de la plage temporelle (incluse).
namespaceschaîne[]NonFiltrer sur ces namespaces. Vide signifie tous les namespaces.
pod_namechaîneNonFiltrer sur un seul pod. Une chaîne vide signifie aucun filtre.
node_nameschaîne[]NonFiltrer sur ces nœuds. Vide signifie tous les nœuds.
statePodState ou nullNonFiltrer sur un seul état de pod. Voir état du pod.

​
Réponse

Renvoie un tableau d’objets PodsRow, un par instantané de pod. Chacun a ces champs :
ChampTypeDescription
timestampchaîne (ISO 8601)Quand l’instantané a été pris.
pod_namechaîneNom du pod.
pod_namespacechaîneNamespace Kubernetes auquel appartient le pod.
node_namechaîneNom du nœud sur lequel ce pod s’exécute.
cpu_usage_nano_coresnombreUtilisation CPU en nanocœurs.
cpu_usage_core_nano_secondsnombreUtilisation CPU cumulée en core-nanosecondes.
memory_rss_bytesnombreMémoire RSS (Resident Set Size) en octets.
memory_usage_bytesnombreUtilisation totale de la mémoire en octets.
memory_working_set_bytesnombreMémoire de l’ensemble de travail en octets.
memory_page_faultsnombreNombre de défauts de page.
memory_major_page_faultsnombreNombre de défauts de page majeurs.
ephemeral_storage_used_bytesnombreStockage éphémère utilisé en octets.
ephemeral_storage_capacity_bytesnombreCapacité de stockage éphémère en octets.
network_rx_bytesnombreOctets reçus sur le réseau.
network_tx_bytesnombreOctets transmis sur le réseau.
process_countnombreNombre de processus en cours d’exécution.
phasePodPhasePhase actuelle du cycle de vie. Voir phase du pod.
statePodStateÉtat dérivé du pod. Voir état du pod.
containersContainer[]Conteneurs s’exécutant dans ce pod. Voir conteneur.
pod_restart_countnombreNombre total de redémarrages de conteneurs pour ce pod.
pod_uptime_secondsnombreTemps de fonctionnement du pod en secondes.

​
Interroger la vue d’ensemble des pods

Renvoie les métadonnées et l’état des pods plutôt que les métriques brutes, sous forme d’un PodOverviewRow par pod. 
POST /api/v2/kubernetes/pods/overview

​
Corps de la requête

ChampTypeObligatoireDescription
site_idchaîneOuiSite à interroger.
fromchaîne (ISO 8601)OuiDébut de la plage temporelle (inclus).
tochaîne (ISO 8601)OuiFin de la plage temporelle (incluse).
namespaceschaîne[]NonFiltrer sur ces namespaces. Vide signifie tous les namespaces.
querychaîneNonRequête de recherche en texte libre pour filtrer les pods.

​
Réponse

Renvoie un tableau d’objets PodOverviewRow, un par pod. Chacun a ces champs, qui sont tous obligatoires :
ChampTypeDescription
timestampchaîne (ISO 8601)Quand l’instantané a été pris.
node_namechaîneNom du nœud sur lequel ce pod s’exécute.
pod_namechaîneNom du pod.
pod_namespacechaîneNamespace Kubernetes auquel appartient le pod.
pod_uuidchaîneIdentifiant unique du pod.
phasePodPhasePhase actuelle du cycle de vie. Voir phase du pod.
labelsobjetLabels Kubernetes attachés au pod.
owner_referencesOwnerReference[]Références au propriétaire pour ce pod. Voir référence au propriétaire.
containersContainer[]Conteneurs s’exécutant dans ce pod. Voir conteneur.
statePodStateÉtat dérivé du pod. Voir état du pod.
pod_restart_countnombreNombre total de redémarrages de conteneurs pour ce pod.
pod_uptime_secondsnombreTemps de fonctionnement du pod en secondes.

​
Référence

​
Phase du pod

phase est la phase du cycle de vie Kubernetes : Running, Succeeded, Pending, Failed ou Unknown.

​
État du pod

state est un état dérivé combinant la phase et les statuts de conteneurs : Running, Succeeded, Pending, Failed ou Unknown.

​
Conteneur

Chaque entrée dans containers a un name, un status (Running, Terminated, Waiting ou Unknown), un exit_code (0 signifie succès) et une reason lisible par l’humain.

​
Référence au propriétaire

Chaque entrée dans owner_references a le name de la ressource propriétaire, le kind (tel que ReplicaSet ou DaemonSet) et le namespace.