> ## 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-metrics opvragen
Lees Kubernetes node- en pod-metrics met de [Public API
(V2)](/api/v2/overview). Alle eindpunten authenticeren met uw persoonlijke API-token,
zijn beperkt tot één `site_id` en nemen een `from`/`to`-tijdsbereik.
## Node-metrics opvragen
Retourneert één `NodesRow` per node-snapshot in het tijdsbereik.
```shell Endpoint theme={null}
POST /api/v2/kubernetes/nodes
```
### Request body
| Veld | Type | Vereist | Beschrijving |
| ----------- | ----------------- | ------- | --------------------------------------------------------- |
| `site_id` | string | Ja | Site om op te vragen. |
| `from` | string (ISO 8601) | Ja | Startpunt van het tijdsbereik (inclusief). |
| `to` | string (ISO 8601) | Ja | Eindpunt van het tijdsbereik (inclusief). |
| `node_name` | string | Nee | Filter op één node. Een lege string betekent geen 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": ""
}
```
### Response
Retourneert een array van `NodesRow`-objecten, één per node-snapshot. Elk heeft deze
velden:
| Veld | Type | Beschrijving |
| -------------------------- | ----------------- | ------------------------------------------ |
| `timestamp` | string (ISO 8601) | Wanneer de snapshot is gemaakt. |
| `node_name` | string | Kubernetes node-naam. |
| `cpu_usage_nano_cores` | number | CPU-gebruik in nanocores. |
| `memory_rss_bytes` | number | Resident set size (RSS) geheugen in bytes. |
| `memory_usage_bytes` | number | Totaal geheugengebruik in bytes. |
| `memory_working_set_bytes` | number | Working set-geheugen in bytes. |
| `memory_page_faults` | number | Aantal page faults. |
| `memory_major_page_faults` | number | Aantal major page faults. |
| `fs_used_bytes` | number | Gebruikte filesystem-ruimte in bytes. |
| `fs_available_bytes` | number | Beschikbare filesystem-ruimte in bytes. |
| `fs_capacity_bytes` | number | Totale filesystem-capaciteit in bytes. |
| `fs_inodes_free` | number | Aantal vrije filesystem-inodes. |
| `fs_inodes_used` | number | Aantal gebruikte filesystem-inodes. |
| `fs_inodes` | number | Totaal aantal filesystem-inodes. |
| `network_rx_bytes` | number | Aantal ontvangen netwerk-bytes. |
| `network_tx_bytes` | number | Aantal verzonden netwerk-bytes. |
| `phase` | number | Node-fase, als numerieke waarde. |
## Pod-metrics opvragen
Retourneert één `PodsRow` per pod-snapshot in het tijdsbereik.
```shell Endpoint theme={null}
POST /api/v2/kubernetes/pods
```
### Request body
| Veld | Type | Vereist | Beschrijving |
| ------------ | -------------------- | ------- | ----------------------------------------------------------- |
| `site_id` | string | Ja | Site om op te vragen. |
| `from` | string (ISO 8601) | Ja | Startpunt van het tijdsbereik (inclusief). |
| `to` | string (ISO 8601) | Ja | Eindpunt van het tijdsbereik (inclusief). |
| `namespaces` | string\[] | Nee | Filter op deze namespaces. Leeg betekent alle namespaces. |
| `pod_name` | string | Nee | Filter op één pod. Een lege string betekent geen filter. |
| `node_names` | string\[] | Nee | Filter op deze nodes. Leeg betekent alle nodes. |
| `state` | `PodState` of `null` | Nee | Filter op één pod-toestand. Zie [pod-toestand](#pod-state). |
### Response
Retourneert een array van `PodsRow`-objecten, één per pod-snapshot. Elk heeft deze
velden:
| Veld | Type | Beschrijving |
| ---------------------------------- | ----------------- | ---------------------------------------------------------------- |
| `timestamp` | string (ISO 8601) | Wanneer de snapshot is gemaakt. |
| `pod_name` | string | Pod-naam. |
| `pod_namespace` | string | Kubernetes-namespace waar de pod bij hoort. |
| `node_name` | string | Naam van de node waarop deze pod draait. |
| `cpu_usage_nano_cores` | number | CPU-gebruik in nanocores. |
| `cpu_usage_core_nano_seconds` | number | Cumulatief CPU-gebruik in core-nanoseconden. |
| `memory_rss_bytes` | number | Resident set size (RSS) geheugen in bytes. |
| `memory_usage_bytes` | number | Totaal geheugengebruik in bytes. |
| `memory_working_set_bytes` | number | Working set-geheugen in bytes. |
| `memory_page_faults` | number | Aantal page faults. |
| `memory_major_page_faults` | number | Aantal major page faults. |
| `ephemeral_storage_used_bytes` | number | Gebruikte ephemeral storage in bytes. |
| `ephemeral_storage_capacity_bytes` | number | Capaciteit ephemeral storage in bytes. |
| `network_rx_bytes` | number | Aantal ontvangen netwerk-bytes. |
| `network_tx_bytes` | number | Aantal verzonden netwerk-bytes. |
| `process_count` | number | Aantal draaiende processen. |
| `phase` | `PodPhase` | Huidige lifecycle-fase. Zie [pod-fase](#pod-phase). |
| `state` | `PodState` | Afgeleide pod-toestand. Zie [pod-toestand](#pod-state). |
| `containers` | `Container[]` | Containers die in deze pod draaien. Zie [container](#container). |
| `pod_restart_count` | number | Totale containerherstarts voor deze pod. |
| `pod_uptime_seconds` | number | Pod-uptime in seconden. |
## Pod-overzicht opvragen
Retourneert pod-metadata en -status in plaats van ruwe metrics, als één
`PodOverviewRow` per pod.
```shell Endpoint theme={null}
POST /api/v2/kubernetes/pods/overview
```
### Request body
| Veld | Type | Vereist | Beschrijving |
| ------------ | ----------------- | ------- | --------------------------------------------------------- |
| `site_id` | string | Ja | Site om op te vragen. |
| `from` | string (ISO 8601) | Ja | Startpunt van het tijdsbereik (inclusief). |
| `to` | string (ISO 8601) | Ja | Eindpunt van het tijdsbereik (inclusief). |
| `namespaces` | string\[] | Nee | Filter op deze namespaces. Leeg betekent alle namespaces. |
| `query` | string | Nee | Vrije-tekst zoekquery om pods te filteren. |
### Response
Retourneert een array van `PodOverviewRow`-objecten, één per pod. Elk heeft deze velden, die allemaal **verplicht** zijn:
| Veld | Type | Beschrijving |
| -------------------- | ------------------ | ------------------------------------------------------------------------ |
| `timestamp` | string (ISO 8601) | Wanneer de snapshot is gemaakt. |
| `node_name` | string | Naam van de node waarop deze pod draait. |
| `pod_name` | string | Pod-naam. |
| `pod_namespace` | string | Kubernetes-namespace waar de pod bij hoort. |
| `pod_uuid` | string | Unieke pod-identificator. |
| `phase` | `PodPhase` | Huidige lifecycle-fase. Zie [pod-fase](#pod-phase). |
| `labels` | object | Kubernetes-labels gekoppeld aan de pod. |
| `owner_references` | `OwnerReference[]` | Owner-references voor deze pod. Zie [owner-reference](#owner-reference). |
| `containers` | `Container[]` | Containers die in deze pod draaien. Zie [container](#container). |
| `state` | `PodState` | Afgeleide pod-toestand. Zie [pod-toestand](#pod-state). |
| `pod_restart_count` | number | Totale containerherstarts voor deze pod. |
| `pod_uptime_seconds` | number | Pod-uptime in seconden. |
## Referentie
### Pod-fase
`phase` is de Kubernetes lifecycle-fase: `Running`, `Succeeded`, `Pending`,
`Failed` of `Unknown`.
### Pod-toestand
`state` is een afgeleide toestand die fase en containerstatussen combineert: `Running`,
`Succeeded`, `Pending`, `Failed` of `Unknown`.
### Container
Elke entry in `containers` heeft een `name`, een `status` (`Running`, `Terminated`,
`Waiting` of `Unknown`), een `exit_code` (`0` betekent succes) en een menselijk leesbare
`reason`.
### Owner-reference
Elke entry in `owner_references` heeft de `name` van de eigenaarresource, `kind` (zoals
`ReplicaSet` of `DaemonSet`) en `namespace`.