> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Kubernetes-Metriken abfragen
Lesen Sie Kubernetes-Node- und Pod-Metriken mit der [Public API
(V2)](/api/v2/overview). 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.
```shell Endpoint theme={null}
POST /api/v2/kubernetes/nodes
```
### Request-Body
| Feld | Typ | Erforderlich | Beschreibung |
| ----------- | ----------------- | ------------ | ------------------------------------------------------------------------ |
| `site_id` | string | Ja | Abzufragende Site. |
| `from` | string (ISO 8601) | Ja | Start des Zeitbereichs (inklusive). |
| `to` | string (ISO 8601) | Ja | Ende des Zeitbereichs (inklusive). |
| `node_name` | string | Nein | Filter auf einen einzelnen Node. Ein leerer String bedeutet kein Filter. |
```json body.json theme={null}
{
"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:
| Feld | Typ | Beschreibung |
| -------------------------- | ----------------- | ------------------------------------------ |
| `timestamp` | string (ISO 8601) | Wann der Snapshot aufgenommen wurde. |
| `node_name` | string | Kubernetes-Node-Name. |
| `cpu_usage_nano_cores` | number | CPU-Nutzung in Nanocores. |
| `memory_rss_bytes` | number | Resident-Set-Size-Speicher (RSS) in Bytes. |
| `memory_usage_bytes` | number | Gesamte Speichernutzung in Bytes. |
| `memory_working_set_bytes` | number | Working-Set-Speicher in Bytes. |
| `memory_page_faults` | number | Anzahl der Page-Faults. |
| `memory_major_page_faults` | number | Anzahl der Major-Page-Faults. |
| `fs_used_bytes` | number | Genutzter Dateisystemspeicher in Bytes. |
| `fs_available_bytes` | number | Verfügbarer Dateisystemspeicher in Bytes. |
| `fs_capacity_bytes` | number | Gesamte Dateisystemkapazität in Bytes. |
| `fs_inodes_free` | number | Anzahl freier Inodes im Dateisystem. |
| `fs_inodes_used` | number | Anzahl genutzter Inodes im Dateisystem. |
| `fs_inodes` | number | Gesamtanzahl der Inodes im Dateisystem. |
| `network_rx_bytes` | number | Empfangene Netzwerk-Bytes. |
| `network_tx_bytes` | number | Gesendete Netzwerk-Bytes. |
| `phase` | number | Node-Phase als numerischer Wert. |
## Pod-Metriken abfragen
Gibt eine `PodsRow` pro Pod-Snapshot im Zeitbereich zurück.
```shell Endpoint theme={null}
POST /api/v2/kubernetes/pods
```
### Request-Body
| Feld | Typ | Erforderlich | Beschreibung |
| ------------ | ---------------------- | ------------ | ----------------------------------------------------------------------- |
| `site_id` | string | Ja | Abzufragende Site. |
| `from` | string (ISO 8601) | Ja | Start des Zeitbereichs (inklusive). |
| `to` | string (ISO 8601) | Ja | Ende des Zeitbereichs (inklusive). |
| `namespaces` | string\[] | Nein | Filter auf diese Namespaces. Leer bedeutet alle Namespaces. |
| `pod_name` | string | Nein | Filter auf einen einzelnen Pod. Ein leerer String bedeutet kein Filter. |
| `node_names` | string\[] | Nein | Filter auf diese Nodes. Leer bedeutet alle Nodes. |
| `state` | `PodState` oder `null` | Nein | Filter auf einen einzelnen Pod-State. Siehe [Pod-State](#pod-state). |
### Antwort
Gibt ein Array von `PodsRow`-Objekten zurück, eines pro Pod-Snapshot. Jedes hat
diese Felder:
| Feld | Typ | Beschreibung |
| ---------------------------------- | ----------------- | ---------------------------------------------------------------- |
| `timestamp` | string (ISO 8601) | Wann der Snapshot aufgenommen wurde. |
| `pod_name` | string | Pod-Name. |
| `pod_namespace` | string | Kubernetes-Namespace, zu dem der Pod gehört. |
| `node_name` | string | Name des Nodes, auf dem dieser Pod läuft. |
| `cpu_usage_nano_cores` | number | CPU-Nutzung in Nanocores. |
| `cpu_usage_core_nano_seconds` | number | Kumulierte CPU-Nutzung in Core-Nanosekunden. |
| `memory_rss_bytes` | number | Resident-Set-Size-Speicher (RSS) in Bytes. |
| `memory_usage_bytes` | number | Gesamte Speichernutzung in Bytes. |
| `memory_working_set_bytes` | number | Working-Set-Speicher in Bytes. |
| `memory_page_faults` | number | Anzahl der Page-Faults. |
| `memory_major_page_faults` | number | Anzahl der Major-Page-Faults. |
| `ephemeral_storage_used_bytes` | number | Genutzter ephemerer Speicher in Bytes. |
| `ephemeral_storage_capacity_bytes` | number | Kapazität des ephemeren Speichers in Bytes. |
| `network_rx_bytes` | number | Empfangene Netzwerk-Bytes. |
| `network_tx_bytes` | number | Gesendete Netzwerk-Bytes. |
| `process_count` | number | Anzahl laufender Prozesse. |
| `phase` | `PodPhase` | Aktuelle Lebenszyklusphase. Siehe [Pod-Phase](#pod-phase). |
| `state` | `PodState` | Abgeleiteter Pod-State. Siehe [Pod-State](#pod-state). |
| `containers` | `Container[]` | In diesem Pod laufende Container. Siehe [Container](#container). |
| `pod_restart_count` | number | Gesamtzahl der Container-Neustarts für diesen Pod. |
| `pod_uptime_seconds` | number | Pod-Uptime in Sekunden. |
## Pod-Übersicht abfragen
Gibt Pod-Metadaten und -Status statt Rohmetriken zurück, als eine
`PodOverviewRow` pro Pod.
```shell Endpoint theme={null}
POST /api/v2/kubernetes/pods/overview
```
### Request-Body
| Feld | Typ | Erforderlich | Beschreibung |
| ------------ | ----------------- | ------------ | ----------------------------------------------------------- |
| `site_id` | string | Ja | Abzufragende Site. |
| `from` | string (ISO 8601) | Ja | Start des Zeitbereichs (inklusive). |
| `to` | string (ISO 8601) | Ja | Ende des Zeitbereichs (inklusive). |
| `namespaces` | string\[] | Nein | Filter auf diese Namespaces. Leer bedeutet alle Namespaces. |
| `query` | string | Nein | Freitext-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:
| Feld | Typ | Beschreibung |
| -------------------- | ------------------ | --------------------------------------------------------------------------- |
| `timestamp` | string (ISO 8601) | Wann der Snapshot aufgenommen wurde. |
| `node_name` | string | Name des Nodes, auf dem dieser Pod läuft. |
| `pod_name` | string | Pod-Name. |
| `pod_namespace` | string | Kubernetes-Namespace, zu dem der Pod gehört. |
| `pod_uuid` | string | Eindeutiger Pod-Bezeichner. |
| `phase` | `PodPhase` | Aktuelle Lebenszyklusphase. Siehe [Pod-Phase](#pod-phase). |
| `labels` | object | An den Pod angehängte Kubernetes-Labels. |
| `owner_references` | `OwnerReference[]` | Owner-References für diesen Pod. Siehe [Owner-Reference](#owner-reference). |
| `containers` | `Container[]` | In diesem Pod laufende Container. Siehe [Container](#container). |
| `state` | `PodState` | Abgeleiteter Pod-State. Siehe [Pod-State](#pod-state). |
| `pod_restart_count` | number | Gesamtzahl der Container-Neustarts für diesen Pod. |
| `pod_uptime_seconds` | number | Pod-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.