Pular para o conteúdo principal
Leia métricas de node e pod do Kubernetes com a API pública (V2). Todos os endpoints autenticam com seu token pessoal de API, têm escopo de um único site_id e recebem um intervalo de tempo from/to.

​
Consultar métricas de node

Retorna um NodesRow por snapshot de node no intervalo de tempo. 
POST /api/v2/kubernetes/nodes

​
Corpo da requisição

CampoTipoObrigatórioDescrição
site_idstringSimSite a ser consultado.
fromstring (ISO 8601)SimInício do intervalo de tempo (inclusivo).
tostring (ISO 8601)SimFim do intervalo de tempo (inclusivo).
node_namestringNãoFiltrar para um único node. Uma string vazia significa sem filtro.
{
  "site_id": "YOUR-SITE-ID",
  "from": "2026-06-22T00:00:00Z",
  "to": "2026-06-22T01:00:00Z",
  "node_name": ""
}

​
Resposta

Retorna um array de objetos NodesRow, um por snapshot de node. Cada um tem estes campos:
CampoTipoDescrição
timestampstring (ISO 8601)Quando o snapshot foi tirado.
node_namestringNome do node no Kubernetes.
cpu_usage_nano_coresnumberUso de CPU em nanocores.
memory_rss_bytesnumberMemória resident set size (RSS) em bytes.
memory_usage_bytesnumberUso total de memória em bytes.
memory_working_set_bytesnumberWorking set de memória em bytes.
memory_page_faultsnumberContagem de page faults.
memory_major_page_faultsnumberContagem de major page faults.
fs_used_bytesnumberEspaço de filesystem usado em bytes.
fs_available_bytesnumberEspaço de filesystem disponível em bytes.
fs_capacity_bytesnumberCapacidade total do filesystem em bytes.
fs_inodes_freenumberContagem de inodes de filesystem livres.
fs_inodes_usednumberContagem de inodes de filesystem usados.
fs_inodesnumberContagem total de inodes do filesystem.
network_rx_bytesnumberBytes de rede recebidos.
network_tx_bytesnumberBytes de rede transmitidos.
phasenumberFase do node, como valor numérico.

​
Consultar métricas de pod

Retorna um PodsRow por snapshot de pod no intervalo de tempo. 
POST /api/v2/kubernetes/pods

​
Corpo da requisição

CampoTipoObrigatórioDescrição
site_idstringSimSite a ser consultado.
fromstring (ISO 8601)SimInício do intervalo de tempo (inclusivo).
tostring (ISO 8601)SimFim do intervalo de tempo (inclusivo).
namespacesstring[]NãoFiltrar para estes namespaces. Vazio significa todos os namespaces.
pod_namestringNãoFiltrar para um único pod. Uma string vazia significa sem filtro.
node_namesstring[]NãoFiltrar para estes nodes. Vazio significa todos os nodes.
statePodState ou nullNãoFiltrar para um único estado de pod. Veja estado do pod.

​
Resposta

Retorna um array de objetos PodsRow, um por snapshot de pod. Cada um tem estes campos:
CampoTipoDescrição
timestampstring (ISO 8601)Quando o snapshot foi tirado.
pod_namestringNome do pod.
pod_namespacestringNamespace do Kubernetes a que o pod pertence.
node_namestringNome do node em que este pod está rodando.
cpu_usage_nano_coresnumberUso de CPU em nanocores.
cpu_usage_core_nano_secondsnumberUso cumulativo de CPU em core-nanossegundos.
memory_rss_bytesnumberMemória resident set size (RSS) em bytes.
memory_usage_bytesnumberUso total de memória em bytes.
memory_working_set_bytesnumberWorking set de memória em bytes.
memory_page_faultsnumberContagem de page faults.
memory_major_page_faultsnumberContagem de major page faults.
ephemeral_storage_used_bytesnumberArmazenamento efêmero usado em bytes.
ephemeral_storage_capacity_bytesnumberCapacidade de armazenamento efêmero em bytes.
network_rx_bytesnumberBytes de rede recebidos.
network_tx_bytesnumberBytes de rede transmitidos.
process_countnumberContagem de processos em execução.
phasePodPhaseFase atual do ciclo de vida. Veja fase do pod.
statePodStateEstado derivado do pod. Veja estado do pod.
containersContainer[]Containers em execução neste pod. Veja container.
pod_restart_countnumberTotal de restarts de containers deste pod.
pod_uptime_secondsnumberUptime do pod em segundos.

​
Consultar visão geral de pods

Retorna metadados e status do pod em vez de métricas brutas, como um PodOverviewRow por pod. 
POST /api/v2/kubernetes/pods/overview

​
Corpo da requisição

CampoTipoObrigatórioDescrição
site_idstringSimSite a ser consultado.
fromstring (ISO 8601)SimInício do intervalo de tempo (inclusivo).
tostring (ISO 8601)SimFim do intervalo de tempo (inclusivo).
namespacesstring[]NãoFiltrar para estes namespaces. Vazio significa todos os namespaces.
querystringNãoQuery de busca de texto livre para filtrar pods.

​
Resposta

Retorna um array de objetos PodOverviewRow, um por pod. Cada um tem estes campos, todos obrigatórios:
CampoTipoDescrição
timestampstring (ISO 8601)Quando o snapshot foi tirado.
node_namestringNome do node em que este pod está rodando.
pod_namestringNome do pod.
pod_namespacestringNamespace do Kubernetes a que o pod pertence.
pod_uuidstringIdentificador único do pod.
phasePodPhaseFase atual do ciclo de vida. Veja fase do pod.
labelsobjectLabels do Kubernetes anexadas ao pod.
owner_referencesOwnerReference[]Owner references deste pod. Veja owner reference.
containersContainer[]Containers em execução neste pod. Veja container.
statePodStateEstado derivado do pod. Veja estado do pod.
pod_restart_countnumberTotal de restarts de containers deste pod.
pod_uptime_secondsnumberUptime do pod em segundos.

​
Referência

​
Fase do pod

phase é a fase do ciclo de vida do Kubernetes: Running, Succeeded, Pending, Failed ou Unknown.

​
Estado do pod

state é um estado derivado que combina fase e status de containers: Running, Succeeded, Pending, Failed ou Unknown.

​
Container

Cada entrada em containers tem um name, um status (Running, Terminated, Waiting ou Unknown), um exit_code (0 significa sucesso) e um reason legível por humanos.

​
Owner reference

Cada entrada em owner_references tem o name, o kind (como ReplicaSet ou DaemonSet) e o namespace do recurso proprietário.