Metrics

GET/api/v1/metrics

Lit le dernier état et l'historique d'un Agent Rust. L'historique vient d'abord de R2 et est sous-échantillonné à la limite demandée ; l'historique brut illimité n'est pas renvoyé.

Paramètres de requête

Paramètre	Requis	Défaut	Rôle
`agent_id`	oui	Agent par défaut du déploiement si défini	correspond en général à l'ID de la cible VPS
`hours`	non	`24`	max par défaut 72 h, ajustable au déploiement `1–168`
`max_points`	non	selon fenêtre	points renvoyés ; non fini, `0` ou négatif retombe sur des défauts sûrs, minimum 60
`history`	non	`1`	`0` ne lit que le dernier état
`format`	non	row	`columns` renvoie des séries compactes en colonnes
`metric` / `fields`	non	tout	restreindre les groupes de métriques ou champs

bash

curl -fsSL 'https://YOUR-API/api/v1/metrics?agent_id=vps-a&hours=6&max_points=360'

Métriques optionnelles

Groupes : cpu, mem, disk, load, net, conns, diskio, temp, gpu. Ou champs séparés par virgules :

text

cpu,mem,disk,load1,net_rx,net_tx,tcp_conns,udp_conns,
disk_read,disk_write,cpu_temp,gpu_temp,gpu_util,
motherboard_temp,disk_temp,chipset_temp

bash

curl -fsSL 'https://YOUR-API/api/v1/metrics?agent_id=vps-a&hours=1&fields=cpu,mem,cpu_temp'

Champs de réponse

Champ	Rôle
`latest`	dernier résumé Agent ; `null` avant le premier rapport
`history[]`	historique de lignes croissant ; vide au format colonnes
`series`	`t0`, `dt`, champs et tableaux de valeurs pour `format=columns`
`history_raw_count`	points avant sous-échantillonnage
`history_downsampled`	indique un sous-échantillonnage
`source`	`r2`, `r2+d1-fallback`, `d1`, etc.
`traffic`	résumé du trafic de la période de facturation courante
`warnings[]`	avertissements non bloquants sur l'état ou l'historique

Format colonnes

json

{
  "series": {
    "t0": 1760000000,
    "dt": [0, 10, 20],
    "fields": ["cpu", "mem"],
    "values": {
      "cpu": [8.4, 9.1, 7.8],
      "mem": [42.0, 42.1, 42.1]
    }
  }
}

Chaque horodatage vaut t0 + dt[index]. Les clients doivent vérifier la longueur de chaque tableau de valeurs ; ne supposez pas que les proxys renvoient des colonnes complètes.

history=0 saute les lectures d'historique, adapté aux vues dernier-état uniquement. Avec format=columns, history est vide et les données vivent dans series ; ne consommez pas les deux. Le serveur normalise l'ID Agent, la fenêtre, les points, le format et les champs dans la clé de cache.

Unités et null

Les unités suivent l'affichage frontend courant et la sémantique des réponses. Les capteurs de température, GPU, carte mère et disque sont indisponibles dans la plupart des environnements virtualisés ; masquez les séries manquantes au lieu d'afficher 0°C.

latest.vps_info.total_disk_gb est la capacité du système de fichiers racine. Le réseau et l'IO disque sont des champs de débit ; le trafic facturable vient du registre de période persisté, jamais d'un seul échantillon net_rx/net_tx.

Metrics ​

Paramètres de requête ​

Métriques optionnelles ​

Champs de réponse ​

Format colonnes ​