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
date (Query, optional): Referenzdatum, das als Default-Ende verwendet wird.
- Beispiel: 2026-02-26
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.

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):

icmpMonitorId
monitor
latestCheck
uptimeStats, uptimeStatsMeta
monitoringData
incidents
alerts
testResultLog
maintenance

Beispiel:

{
  "icmpMonitorId": 123,
  "monitor": {
    "id": 123,
    "customerId": 10,
    "organizationId": 1,
    "name": "Core Router",
    "hostname": "10.0.0.1",
    "status": "active",
    "checkInterval": 30,
    "timeoutSeconds": 30,
    "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": [] }
}

Fehler

400 Ungültige ICMP Monitor Public ID (UUID)
401 Unauthorized
403 Forbidden
404 ICMP Monitor nicht gefunden
500 Failed to fetch ICMP monitor details