TCP Monitor Details abrufen

GET /api/tcp-monitors/:tcpMonitorPublicId/details

AuthentifizierungAnkerlink kopieren

Erfordert eine gültige Session.

• Header: Authorization: Bearer <token>

ParameterAnkerlink kopieren

• tcpMonitorPublicId (Pfad, erforderlich): Öffentliche UUID des TCP Monitors.

Query ParameterAnkerlink kopieren

• range (string, optional): day, week, month, year (Default: day)
• date (string, optional): Referenzdatum (wird via new Date(date) geparst)
• startDate (string, optional)
• endDate (string, optional)
• granularity (string, optional)
  • Wenn raw, wird Aggregation deaktiviert.

cURLAnkerlink kopieren

curl "https://YOUR_DOMAIN/api/tcp-monitors/44444444-4444-4444-8444-444444444444/details?range=day" \
  -H "Authorization: Bearer $TOKEN"

ResponseAnkerlink kopieren

Die Response ist ein einzelnes Objekt mit diesen Top-Level Keys:

• tcpMonitorId
• monitor
• latestCheck
• uptimeStats
• uptimeStatsMeta
• monitoringData
• incidents
• alerts
• testResultLog
• maintenance

Beispiel (gekürzt):

{
  "tcpMonitorId": 300,
  "monitor": {
    "id": 300,
    "customerId": 10,
    "name": "Redis Primary",
    "hostname": "redis.deinkunde.com",
    "port": 6379,
    "status": "active",
    "checkInterval": 60,
    "timeoutSeconds": 30,
    "config": {
      "expectBanner": "+PONG"
    }
  },
  "latestCheck": {
    "status": "success",
    "checkedAt": "2026-02-26T12:00:00.000Z",
    "timingTotal": 123,
    "locationCode": "de-nbg",
    "locationName": "Nuremberg (DE)"
  },
  "uptimeStats": {
    "day": 99.9,
    "month": 99.5,
    "year": 99.0,
    "dayAvgResponse": 120,
    "monthAvgResponse": 140,
    "yearAvgResponse": 150
  },
  "maintenance": {
    "inMaintenance": false,
    "activeWindows": [],
    "allWindows": []
  }
}

AufbewahrungAnkerlink kopieren

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.

ErrorsAnkerlink kopieren

• 400 Ungültige TCP Monitor Public ID (UUID)
• 401 Unauthorized
• 403 Forbidden
• 404 Not found
• 500 Failed to fetch TCP monitor details