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).
GET /api/icmp-monitors/:icmpMonitorPublicId/details
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Parameter
icmpMonitorPublicId(Pfad, erforderlich): Öffentliche UUID des ICMP Monitors.
Time-Range Query-Parameter
Der Zeitbereich kann auf mehrere Arten definiert werden. Nutze die einfachste Option für deinen Use-Case:
range(Query, optional): Preset-Zeitraum.- Erlaubt:
day(Default),week,month,year
- Erlaubt:
date(Query, optional): Referenzdatum, das als Default-Ende verwendet wird.- Beispiel:
2026-02-26
- Beispiel:
startDate(Query, optional): Startdatum/-zeit.endDate(Query, optional): Enddatum/-zeit.granularity(Query, optional): Steuert Aggregation.- Nutze
raw, um Aggregation zu deaktivieren. - Jeder andere Wert aktiviert Aggregation.
- Wenn nicht gesetzt, aggregiert der Server ggf. automatisch bei größeren Zeitbereichen.
- Nutze
cURL
curl -X GET "https://YOUR_DOMAIN/api/icmp-monitors/22222222-2222-4222-8222-222222222222/details?range=day&granularity=raw" \
-H "Authorization: Bearer $TOKEN"Response
Top-Level Felder (aktueller Stand):
icmpMonitorIdmonitorlatestCheckuptimeStats,uptimeStatsMetamonitoringDataincidentsalertstestResultLogmaintenance
Beispiel:
{
"icmpMonitorId": 123,
"monitor": {
"id": 123,
"customerId": 10,
"organizationId": 1,
"name": "Core Router",
"hostname": "10.0.0.1",
"status": "active",
"checkInterval": 30,
"timeoutSeconds": 30,
"allowedCheckCountryCodes": ["DE"],
"port": null,
"config": { "packetSize": 56, "count": 3 },
"notificationPhoneNumber": null,
"notificationEmail": null,
"lastCheckedAt": null,
"createdAt": "2026-02-26T12:00:00.000Z",
"updatedAt": "2026-02-26T12:00:00.000Z"
},
"latestCheck": null,
"uptimeStats": {
"day": "100.00",
"month": "100.00",
"year": "100.00",
"dayAvgResponse": 22,
"monthAvgResponse": 22,
"yearAvgResponse": 22
},
"uptimeStatsMeta": {
"day": { "window": "24h", "downtimeMinutes": 0, "incidents": 0, "checksTotal": 24, "checksFailed": 0 },
"month": { "window": "30d", "downtimeMinutes": 0, "incidents": 0, "checksTotal": 720, "checksFailed": 0 },
"year": { "window": "YTD", "downtimeMinutes": 0, "incidents": 0, "checksTotal": 1000, "checksFailed": 0 }
},
"monitoringData": {
"responseTimeData": [
{
"timestamp": "2026-02-26T12:00:00.000Z",
"responseTime": 22,
"status": "success",
"success": true,
"timingDns": 0,
"timingTcp": 22,
"timingTls": 0,
"timingTtfb": 0,
"timingTransfer": 0
}
],
"statusData": [{ "date": "26.02", "status": "online" }],
"uptimePercentage": "100.00",
"checkSuccessRatePercentage": "100.00",
"totalChecks": 100,
"successfulChecks": 100
},
"incidents": { "history": [], "total": 0, "ongoing": 0, "totalDowntime": "0s" },
"alerts": { "history": [], "total": 0, "notificationContext": { "orgDefaultEmail": null, "orgDefaultPhoneNumber": null, "customerEmail": null, "notificationTargets": [] } },
"testResultLog": [],
"maintenance": { "inMaintenance": false, "activeWindows": [], "allWindows": [] }
}Aufbewahrung
Einzelne Prüfungen bleiben 24 Stunden erhalten, Minutenwerte 30 Tage und Tageswerte 24 Monate; ein Zeitraum, der älter als 30 Tage ist, liefert einen Punkt pro Tag. Hat der Monitor in den letzten 24 Stunden nicht geprüft, beschreibt latestCheck seine letzte Minute aus dem Aggregat: id beginnt mit 1min-, resolution ist 1min, locationId und errorMessage sind null.
Fehler
400Ungültige ICMP Monitor Public ID (UUID)401Unauthorized403Forbidden404ICMP Monitor nicht gefunden500Failed to fetch ICMP monitor details
Häufige Fehler
400 Bad Request(invalidRequestBody) wennrangenichtday/week/month/yearist,date/startDate/endDatekein Datum ist, nur eines vonstartDate/endDatekommt,tzkeine Ganzzahl ist odergranularitywederrawnochaggregated