TCP Monitor Check Historie abrufen

GET /api/tcp-monitors/:tcpMonitorPublicId/check-history

AuthentifizierungAnkerlink kopieren

Erfordert eine gültige Session.

• Header: Authorization: Bearer <token>

ParameterAnkerlink kopieren

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

Query ParameterAnkerlink kopieren

• 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; Max 100). Bei format=csv oder download=1 gelten die Export-Defaults (Default 10000, Max 50000 Zeilen).
• status (string, optional): success oder failure (failure matcht auch timeout). 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 nach checkedAt-Bereich.
• format (string, optional): json (Default) oder csv.
• download (string, optional): 1 erzwingt einen Attachment-Download.

cURLAnkerlink kopieren

curl "https://YOUR_DOMAIN/api/tcp-monitors/44444444-4444-4444-8444-444444444444/check-history?page=1&limit=10" \
  -H "Authorization: Bearer $TOKEN"

ResponseAnkerlink kopieren

{
  "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"
}

• resolution je Zeile: raw ist eine einzelne Prüfung mit Standort und Fehlermeldung; 1min ist eine Minute über alle Standorte, ohne Standort und Fehlermeldung, dafür mit totalLocations und failedLocations.
• resolution der Seite: raw, 1min oder mixed (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.

AufbewahrungAnkerlink kopieren

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.

ErrorsAnkerlink kopieren

• 400 TCP Monitor Public ID (UUID) erforderlich
• 401 Unauthorized
• 403 Forbidden
• 404 Not found