Zum Hauptinhalt springen
Lesen Sie Kubernetes-Node- und Pod-Metriken mit der Public API (V2). Alle Endpunkte authentifizieren sich mit Ihrem persönlichen API-Token, sind auf eine einzelne site_id begrenzt und nehmen einen from/to-Zeitbereich entgegen.

​
Node-Metriken abfragen

Gibt eine NodesRow pro Node-Snapshot im Zeitbereich zurück. 
POST /api/v2/kubernetes/nodes

​
Request-Body

FeldTypErforderlichBeschreibung
site_idstringJaAbzufragende Site.
fromstring (ISO 8601)JaStart des Zeitbereichs (inklusive).
tostring (ISO 8601)JaEnde des Zeitbereichs (inklusive).
node_namestringNeinFilter auf einen einzelnen Node. Ein leerer String bedeutet kein Filter.
{
  "site_id": "YOUR-SITE-ID",
  "from": "2026-06-22T00:00:00Z",
  "to": "2026-06-22T01:00:00Z",
  "node_name": ""
}

​
Antwort

Gibt ein Array von NodesRow-Objekten zurück, eines pro Node-Snapshot. Jedes hat diese Felder:
FeldTypBeschreibung
timestampstring (ISO 8601)Wann der Snapshot aufgenommen wurde.
node_namestringKubernetes-Node-Name.
cpu_usage_nano_coresnumberCPU-Nutzung in Nanocores.
memory_rss_bytesnumberResident-Set-Size-Speicher (RSS) in Bytes.
memory_usage_bytesnumberGesamte Speichernutzung in Bytes.
memory_working_set_bytesnumberWorking-Set-Speicher in Bytes.
memory_page_faultsnumberAnzahl der Page-Faults.
memory_major_page_faultsnumberAnzahl der Major-Page-Faults.
fs_used_bytesnumberGenutzter Dateisystemspeicher in Bytes.
fs_available_bytesnumberVerfügbarer Dateisystemspeicher in Bytes.
fs_capacity_bytesnumberGesamte Dateisystemkapazität in Bytes.
fs_inodes_freenumberAnzahl freier Inodes im Dateisystem.
fs_inodes_usednumberAnzahl genutzter Inodes im Dateisystem.
fs_inodesnumberGesamtanzahl der Inodes im Dateisystem.
network_rx_bytesnumberEmpfangene Netzwerk-Bytes.
network_tx_bytesnumberGesendete Netzwerk-Bytes.
phasenumberNode-Phase als numerischer Wert.

​
Pod-Metriken abfragen

Gibt eine PodsRow pro Pod-Snapshot im Zeitbereich zurück. 
POST /api/v2/kubernetes/pods

​
Request-Body

FeldTypErforderlichBeschreibung
site_idstringJaAbzufragende Site.
fromstring (ISO 8601)JaStart des Zeitbereichs (inklusive).
tostring (ISO 8601)JaEnde des Zeitbereichs (inklusive).
namespacesstring[]NeinFilter auf diese Namespaces. Leer bedeutet alle Namespaces.
pod_namestringNeinFilter auf einen einzelnen Pod. Ein leerer String bedeutet kein Filter.
node_namesstring[]NeinFilter auf diese Nodes. Leer bedeutet alle Nodes.
statePodState oder nullNeinFilter auf einen einzelnen Pod-State. Siehe Pod-State.

​
Antwort

Gibt ein Array von PodsRow-Objekten zurück, eines pro Pod-Snapshot. Jedes hat diese Felder:
FeldTypBeschreibung
timestampstring (ISO 8601)Wann der Snapshot aufgenommen wurde.
pod_namestringPod-Name.
pod_namespacestringKubernetes-Namespace, zu dem der Pod gehört.
node_namestringName des Nodes, auf dem dieser Pod läuft.
cpu_usage_nano_coresnumberCPU-Nutzung in Nanocores.
cpu_usage_core_nano_secondsnumberKumulierte CPU-Nutzung in Core-Nanosekunden.
memory_rss_bytesnumberResident-Set-Size-Speicher (RSS) in Bytes.
memory_usage_bytesnumberGesamte Speichernutzung in Bytes.
memory_working_set_bytesnumberWorking-Set-Speicher in Bytes.
memory_page_faultsnumberAnzahl der Page-Faults.
memory_major_page_faultsnumberAnzahl der Major-Page-Faults.
ephemeral_storage_used_bytesnumberGenutzter ephemerer Speicher in Bytes.
ephemeral_storage_capacity_bytesnumberKapazität des ephemeren Speichers in Bytes.
network_rx_bytesnumberEmpfangene Netzwerk-Bytes.
network_tx_bytesnumberGesendete Netzwerk-Bytes.
process_countnumberAnzahl laufender Prozesse.
phasePodPhaseAktuelle Lebenszyklusphase. Siehe Pod-Phase.
statePodStateAbgeleiteter Pod-State. Siehe Pod-State.
containersContainer[]In diesem Pod laufende Container. Siehe Container.
pod_restart_countnumberGesamtzahl der Container-Neustarts für diesen Pod.
pod_uptime_secondsnumberPod-Uptime in Sekunden.

​
Pod-Übersicht abfragen

Gibt Pod-Metadaten und -Status statt Rohmetriken zurück, als eine PodOverviewRow pro Pod. 
POST /api/v2/kubernetes/pods/overview

​
Request-Body

FeldTypErforderlichBeschreibung
site_idstringJaAbzufragende Site.
fromstring (ISO 8601)JaStart des Zeitbereichs (inklusive).
tostring (ISO 8601)JaEnde des Zeitbereichs (inklusive).
namespacesstring[]NeinFilter auf diese Namespaces. Leer bedeutet alle Namespaces.
querystringNeinFreitext-Suchabfrage zum Filtern von Pods.

​
Antwort

Gibt ein Array von PodOverviewRow-Objekten zurück, eines pro Pod. Jedes hat diese Felder, die alle erforderlich sind:
FeldTypBeschreibung
timestampstring (ISO 8601)Wann der Snapshot aufgenommen wurde.
node_namestringName des Nodes, auf dem dieser Pod läuft.
pod_namestringPod-Name.
pod_namespacestringKubernetes-Namespace, zu dem der Pod gehört.
pod_uuidstringEindeutiger Pod-Bezeichner.
phasePodPhaseAktuelle Lebenszyklusphase. Siehe Pod-Phase.
labelsobjectAn den Pod angehängte Kubernetes-Labels.
owner_referencesOwnerReference[]Owner-References für diesen Pod. Siehe Owner-Reference.
containersContainer[]In diesem Pod laufende Container. Siehe Container.
statePodStateAbgeleiteter Pod-State. Siehe Pod-State.
pod_restart_countnumberGesamtzahl der Container-Neustarts für diesen Pod.
pod_uptime_secondsnumberPod-Uptime in Sekunden.

​
Referenz

​
Pod-Phase

phase ist die Kubernetes-Lebenszyklusphase: Running, Succeeded, Pending, Failed oder Unknown.

​
Pod-State

state ist ein abgeleiteter State, der Phase und Container-Status kombiniert: Running, Succeeded, Pending, Failed oder Unknown.

​
Container

Jeder Eintrag in containers hat einen name, einen status (Running, Terminated, Waiting oder Unknown), einen exit_code (0 bedeutet Erfolg) und einen menschenlesbaren reason.

​
Owner-Reference

Jeder Eintrag in owner_references hat den name, das kind (etwa ReplicaSet oder DaemonSet) und den namespace der besitzenden Ressource.