API-Dokumentation

VPS-Monitoring

Gibt CPU-, Arbeitsspeicher- und Ping-Verlaufsdaten eines VPS zuruck, zusammen mit Ausfall-Statistiken.

Das Monitoring muss auf dem Server aktiviert sein, damit Messdaten erfasst werden.

Anfrage

GET /api/v1/vps/{id}/monitoring

Erforderlicher Scope: vps:read

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "timings": [
      {
        "date": "2026-03-27T12:00:00Z",
        "cpu": 12.5,
        "mem": 42.3,
        "ping": 1.2
      },
      {
        "date": "2026-03-27T12:05:00Z",
        "cpu": 8.1,
        "mem": 41.8,
        "ping": 1.1
      }
    ],
    "incidents": {
      "statistic": {
        "LAST_24_HOURS": {
          "downtime": 0,
          "availability": 100,
          "incidents": 0,
          "longestIncident": 0,
          "averageIncident": 0
        },
        "LAST_7_DAYS": {
          "downtime": 120,
          "availability": 99.98,
          "incidents": 1,
          "longestIncident": 120,
          "averageIncident": 120
        }
      },
      "incidents": [
        {
          "start": "2026-03-22T03:15:00Z",
          "end": "2026-03-22T03:17:00Z",
          "downtime": 120,
          "type": "PING_TIMEOUT"
        }
      ]
    }
  }
}

Timing-Felder

Feld Typ Beschreibung
date string ISO-8601-Zeitstempel
cpu number CPU-Auslastung in Prozent (0–100)
mem number Arbeitsspeicher-Auslastung in Prozent (0–100)
ping number Ping-Latenz in Millisekunden

Ausfall-Statistiken

Statistiken werden für mehrere Zeiträume bereitgestellt: LAST_24_HOURS, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, LAST_180_DAYS.

Feld Typ Beschreibung
downtime number Gesamte Ausfallzeit in Sekunden
availability number Verfügbarkeit in Prozent (0–100)
incidents number Anzahl der Ausfälle
longestIncident number Längster Ausfall in Sekunden
averageIncident number Durchschnittliche Ausfalldauer in Sekunden

Ausfall-Ereignisse

Feld Typ Beschreibung
start string ISO-8601-Startzeit
end string | null ISO-8601-Endzeit (null wenn noch andauernd)
downtime number Dauer in Sekunden
type string PING_TIMEOUT oder VM_STOPPED

Beispiel

curl -X GET "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/monitoring" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

Diese Daten sind auch über das MCP-Tool get_vm_monitoring verfügbar.