Metrics

GET/api/v1/metrics

Liest den neuesten Zustand und die Historie eines Rust-Agents. Historie kommt zuerst aus R2 und wird auf das angeforderte Limit heruntergesampelt; unbegrenzte Roh-Historie wird nicht geliefert.

Query-Parameter

Parameter	Pflicht	Standard	Zweck
agent_id	ja	Deployment-Standard-Agent falls gesetzt	entspricht meist der VPS-Ziel-ID
hours	nein	24	Standard max. 72 h, deployment-einstellbar 1–168
max_points	nein	fensterbasiert	gelieferte Punkte; nicht endlich, 0 oder negativ fällt auf sichere Defaults zurück, Minimum 60
history	nein	1	0 liest nur den neuesten Stand
format	nein	row	columns liefert kompakte Spaltenserien
metric / fields	nein	alles	Metrikgruppen oder Felder einschränken

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

Optionale Metriken

Gruppen: cpu, mem, disk, load, net, conns, diskio, temp, gpu. Oder kommagetrennte Felder:

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

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

Antwortfelder

Feld	Zweck
latest	neueste Agent-Zusammenfassung; null vor dem ersten Bericht
history[]	aufsteigende Zeilenhistorie; leer im Spaltenformat
series	t0, dt, Felder und Wertarrays für format=columns
history_raw_count	Punkte vor dem Downsampling
history_downsampled	ob heruntergesampelt
source	r2, r2+d1-fallback, d1 usw.
traffic	Traffic-Zusammenfassung der aktuellen Abrechnungsperiode
warnings[]	nicht blockierende Warnungen zu Zustand oder Historie

Spaltenformat

{
  "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]
    }
  }
}

Jeder Zeitstempel ist t0 + dt[index]. Clients müssen jedes Werte-Array auf Länge prüfen; nicht annehmen, dass Proxys vollständige Spalten liefern.

history=0 überspringt Historien-Lesezugriffe, passend für Nur-Latest-Ansichten. Mit format=columns ist history leer und die Daten liegen in series; nicht beides konsumieren. Der Server normalisiert Agent-ID, Fenster, Punkte, Format und Felder in den Cache-Key.

Einheiten und null

Einheiten folgen der aktuellen Frontend-Anzeige und Antwort-Semantik. Temperatur-, GPU-, Mainboard- und Disk-Sensoren sind in den meisten virtualisierten Umgebungen nicht verfügbar; fehlende Serien ausblenden statt 0°C anzeigen.

latest.vps_info.total_disk_gb ist die Root-Dateisystem-Kapazität. Netz und Disk-IO sind Ratenfelder; abrechenbarer Traffic kommt aus dem persistierten Perioden-Ledger, nie aus einem einzelnen net_rx/net_tx-Sample.