TCP Monitore auflisten

GET /api/tcp-monitors

Authentifizierung

Erfordert eine gültige Session.

Header: Authorization: Bearer <token>

Parameter

organizationId (Query, optional): Organisations-ID. Default ist die Organisation des aktuellen Nutzers.
customerId (Query, optional): Nach Kunden-ID filtern.
search (Query, optional): Suche nach Name, Hostname oder Kunde.
page (Query, optional): Seite (Default: 1).
perPage (Query, optional): Einträge pro Seite (Default: 50, Max: 200).

cURL

curl "https://YOUR_DOMAIN/api/tcp-monitors?page=1&perPage=50" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "items": [
    {
      "id": 300,
      "publicId": "44444444-4444-4444-8444-444444444444",
      "organizationId": 1,
      "customerId": 10,
      "name": "Redis Primary",
      "hostname": "redis.deinkunde.com",
      "port": 6379,
      "status": "active",
      "managementType": "managed",
      "checkInterval": 60,
      "timeoutSeconds": 30,
      "customerName": "Example Customer",
      "notificationEmail": null,
      "notificationPhoneNumber": null,
      "lastCheckedAt": "2026-02-26T12:00:00.000Z",
      "createdAt": "2026-02-26T12:00:00.000Z",
      "updatedAt": "2026-02-26T12:00:00.000Z",
      "config": {
        "expectBanner": "+PONG"
      },
      "tags": []
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 50
}

Inline-Metriken

Jeder Eintrag traegt dieselben verdichteten Kennzahlen, die auch die uebrigen Monitor-Listen liefern. Sie werden je Monitor ueber den Kalendertag, den Monat und das Jahr in UTC gebildet.

Feld	Typ	Bedeutung
`uptimeDay` / `uptimeMonth` / `uptimeYear`	string	Verfuegbarkeit in Prozent mit zwei Nachkommastellen, z. B. `"99.94"`
`avgResponseDay` / `avgResponseMonth` / `avgResponseYear`	number \| null	Mittlere Antwortzeit in Millisekunden; `null`, wenn in dem Fenster nichts gemessen wurde
`responseGraph`	object	`{ values, avg }` fuer die letzten 24 Stunden, ein Eintrag je Stunde; eine Stunde ohne erfolgreiche Pruefung ist `null`
`upSinceAt`	string \| null	ISO-Zeitpunkt, seit dem der Monitor laeuft, `null` solange er ausgefallen ist
`isDown`	boolean	Ob der Monitor gerade in einem unaufgeloesten Vorfall steckt

Die Tageswerte kommen aus den Rohdaten, Monat und Jahr aus fortlaufenden Aggregaten -- in diesen beiden Fenstern kann ein Wert der neuesten Pruefung daher um einige Minuten hinterherhinken.

Errors

400 Ungültige organizationId oder customerId
401 Unauthorized
403 Forbidden