Requêtes de métriques Kubernetes - AppSignal Documentation

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

Champ	Type	Obligatoire	Description
`site_id`	chaîne	Oui	Site à interroger.
`from`	chaîne (ISO 8601)	Oui	Début de la plage temporelle (inclus).
`to`	chaîne (ISO 8601)	Oui	Fin de la plage temporelle (incluse).
`node_name`	chaîne	Non	Filtrer 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 :

Champ	Type	Description
`timestamp`	chaîne (ISO 8601)	Quand l’instantané a été pris.
`node_name`	chaîne	Nom du nœud Kubernetes.
`cpu_usage_nano_cores`	nombre	Utilisation CPU en nanocœurs.
`memory_rss_bytes`	nombre	Mémoire RSS (Resident Set Size) en octets.
`memory_usage_bytes`	nombre	Utilisation totale de la mémoire en octets.
`memory_working_set_bytes`	nombre	Mémoire de l’ensemble de travail en octets.
`memory_page_faults`	nombre	Nombre de défauts de page.
`memory_major_page_faults`	nombre	Nombre de défauts de page majeurs.
`fs_used_bytes`	nombre	Espace utilisé du système de fichiers en octets.
`fs_available_bytes`	nombre	Espace disponible du système de fichiers en octets.
`fs_capacity_bytes`	nombre	Capacité totale du système de fichiers en octets.
`fs_inodes_free`	nombre	Nombre d’inodes libres du système de fichiers.
`fs_inodes_used`	nombre	Nombre d’inodes utilisés du système de fichiers.
`fs_inodes`	nombre	Nombre total d’inodes du système de fichiers.
`network_rx_bytes`	nombre	Octets reçus sur le réseau.
`network_tx_bytes`	nombre	Octets transmis sur le réseau.
`phase`	nombre	Phase 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

Champ	Type	Obligatoire	Description
`site_id`	chaîne	Oui	Site à interroger.
`from`	chaîne (ISO 8601)	Oui	Début de la plage temporelle (inclus).
`to`	chaîne (ISO 8601)	Oui	Fin de la plage temporelle (incluse).
`namespaces`	chaîne[]	Non	Filtrer sur ces namespaces. Vide signifie tous les namespaces.
`pod_name`	chaîne	Non	Filtrer sur un seul pod. Une chaîne vide signifie aucun filtre.
`node_names`	chaîne[]	Non	Filtrer sur ces nœuds. Vide signifie tous les nœuds.
`state`	`PodState` ou `null`	Non	Filtrer 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 :

Champ	Type	Description
`timestamp`	chaîne (ISO 8601)	Quand l’instantané a été pris.
`pod_name`	chaîne	Nom du pod.
`pod_namespace`	chaîne	Namespace Kubernetes auquel appartient le pod.
`node_name`	chaîne	Nom du nœud sur lequel ce pod s’exécute.
`cpu_usage_nano_cores`	nombre	Utilisation CPU en nanocœurs.
`cpu_usage_core_nano_seconds`	nombre	Utilisation CPU cumulée en core-nanosecondes.
`memory_rss_bytes`	nombre	Mémoire RSS (Resident Set Size) en octets.
`memory_usage_bytes`	nombre	Utilisation totale de la mémoire en octets.
`memory_working_set_bytes`	nombre	Mémoire de l’ensemble de travail en octets.
`memory_page_faults`	nombre	Nombre de défauts de page.
`memory_major_page_faults`	nombre	Nombre de défauts de page majeurs.
`ephemeral_storage_used_bytes`	nombre	Stockage éphémère utilisé en octets.
`ephemeral_storage_capacity_bytes`	nombre	Capacité de stockage éphémère en octets.
`network_rx_bytes`	nombre	Octets reçus sur le réseau.
`network_tx_bytes`	nombre	Octets transmis sur le réseau.
`process_count`	nombre	Nombre de processus en cours d’exécution.
`phase`	`PodPhase`	Phase actuelle du cycle de vie. Voir phase du pod.
`state`	`PodState`	État dérivé du pod. Voir état du pod.
`containers`	`Container[]`	Conteneurs s’exécutant dans ce pod. Voir conteneur.
`pod_restart_count`	nombre	Nombre total de redémarrages de conteneurs pour ce pod.
`pod_uptime_seconds`	nombre	Temps 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

Champ	Type	Obligatoire	Description
`site_id`	chaîne	Oui	Site à interroger.
`from`	chaîne (ISO 8601)	Oui	Début de la plage temporelle (inclus).
`to`	chaîne (ISO 8601)	Oui	Fin de la plage temporelle (incluse).
`namespaces`	chaîne[]	Non	Filtrer sur ces namespaces. Vide signifie tous les namespaces.
`query`	chaîne	Non	Requê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 :

Champ	Type	Description
`timestamp`	chaîne (ISO 8601)	Quand l’instantané a été pris.
`node_name`	chaîne	Nom du nœud sur lequel ce pod s’exécute.
`pod_name`	chaîne	Nom du pod.
`pod_namespace`	chaîne	Namespace Kubernetes auquel appartient le pod.
`pod_uuid`	chaîne	Identifiant unique du pod.
`phase`	`PodPhase`	Phase actuelle du cycle de vie. Voir phase du pod.
`labels`	objet	Labels Kubernetes attachés au pod.
`owner_references`	`OwnerReference[]`	Références au propriétaire pour ce pod. Voir référence au propriétaire.
`containers`	`Container[]`	Conteneurs s’exécutant dans ce pod. Voir conteneur.
`state`	`PodState`	État dérivé du pod. Voir état du pod.
`pod_restart_count`	nombre	Nombre total de redémarrages de conteneurs pour ce pod.
`pod_uptime_seconds`	nombre	Temps 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.

​Interroger les métriques de nœud

​Corps de la requête

​Réponse

​Interroger les métriques de pod

​Corps de la requête

​Réponse

​Interroger la vue d’ensemble des pods

​Corps de la requête

​Réponse

​Référence

​Phase du pod

​État du pod

​Conteneur

​Référence au propriétaire

Interroger les métriques de nœud

Corps de la requête

Réponse

Interroger les métriques de pod

Corps de la requête

Réponse

Interroger la vue d’ensemble des pods

Corps de la requête

Réponse

Référence

Phase du pod

État du pod

Conteneur

Référence au propriétaire