ICMP Monitor Check-Historie abrufen
Gibt die letzten Check-Ergebnisse für den ICMP Monitor zurück.
GET /api/icmp-monitors/:icmpMonitorPublicId/check-history
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Parameter
icmpMonitorPublicId(Pfad, erforderlich): Öffentliche UUID des ICMP Monitors.
Query Parameter
page(number, optional): Seite (Default:1). Eine Seite zählt Prüfzyklen, nicht Zeilen: ein Zyklus hat eine Zeile je Standort.limit(number, optional): Zyklen pro Seite (Default:10; Max100). Beiformat=csvoderdownload=1gelten die Export-Defaults (Default10000, Max50000Zeilen).status(string, optional):successoderfailure(failurematcht auchtimeout). Bei Minutenzeilen: kein Standort fehlgeschlagen bzw. mindestens einer.minMs/maxMs(number, optional): Filter nach Response-Time-Bereich (timingTotal; bei Minutenzeilen der Minutendurchschnitt).from/to(ISO-Datumsstring, optional): Filter nachcheckedAt-Bereich.format(string, optional):json(Default) odercsv.download(string, optional):1erzwingt einen Attachment-Download,0(Default) liefert die Seite.
cURL
curl "https://YOUR_DOMAIN/api/icmp-monitors/44444444-4444-4444-8444-444444444444/check-history?page=1&limit=10" \
-H "Authorization: Bearer $TOKEN"Response
{
"data": [
{
"id": "33c53ac4-a2bc-475c-a904-8d3d6aab2979",
"status": "success",
"success": true,
"errorMessage": null,
"checkedAt": "2026-10-01T05:40:55.690Z",
"responseTimeMs": 29,
"location": { "name": "Paris (FR)", "code": "par" },
"resolution": "raw"
},
{
"id": "1min-2026-09-30T15:55:00.000Z",
"status": "success",
"success": true,
"errorMessage": null,
"checkedAt": "2026-09-30T15:55:00.000Z",
"responseTimeMs": 54,
"location": null,
"resolution": "1min",
"totalLocations": 2,
"failedLocations": 0
}
],
"total": 864,
"page": 17,
"pageCount": 87,
"resolution": "mixed",
"rawWindowFrom": "2026-09-30T16:00:00.000Z"
}resolutionje Zeile:rawist eine einzelne Prüfung mit Standort und Fehlermeldung;1minist eine Minute über alle Standorte, ohne Standort und Fehlermeldung, dafür mittotalLocationsundfailedLocations.resolutionder Seite:raw,1minodermixed(die Seite liegt über der Grenze).rawWindowFrom: ab hier gibt es einzelne Prüfungen; ältere Zeilen sind Minutenzeilen.
Bei format=csv (oder download=1) ist die Response ein text/csv-Attachment (bzw. application/json bei format=json&download=1) anstelle der paginierten JSON-Antwort oben. CSV-Spalten: checkedAt,status,responseTimeMs,location,errorMessage,resolution.
Aufbewahrung
Einzelne Prüfungen mit Standort und Fehlermeldung bleiben 24 Stunden erhalten. Ältere Einträge kommen aus den Minutenwerten (30 Tage), eine Zeile je Minute ohne Standort und Fehlermeldung. Tageswerte (24 Monate) stehen in den Monitor-Details.
Fehler
400ICMP Monitor Public ID (UUID) erforderlich401Unauthorized403Forbidden404ICMP Monitor nicht gefunden
Häufige Fehler
400 Bad Request(invalidRequestBody) wenn ein Query-Parameter ungültig ist:page/limitkeine positive Ganzzahl,formatwederjsonnochcsv,downloadweder0noch1, oder ein unbekannter Wert instatus,minMsodermaxMs400 Bad Request(invalidDateRange) wennfromodertokein Datum ist
ICMP Monitor Alert-Historie abrufen
Gibt die Benachrichtigungs-/Eskalationsversuche (Alert-Historie) für Vorfälle eines ICMP Monitors zurück.
ICMP Monitor Details abrufen
Gibt ein konsolidiertes Payload zurück, das in der Monitor-Detailseite verwendet wird (u. a. Monitor, letzter Check, aggregierte Daten im Zeitbereich).