| Typ-ID | tcp_port |
| Runner | Dashboard oder Agent |
| Zweck | Prüft ob ein TCP-Port offen und erreichbar ist |
Der TCP-Port-Check öffnet eine TCP-Verbindung zu Host und Port und misst die Verbindungszeit. Lässt sich die Verbindung innerhalb des Timeouts herstellen, ist der Check erfolgreich. Es wird kein Protokoll-Handshake durchgeführt — nur die TCP-Verbindung selbst wird geprüft.
Dieser Check kann auf dem Dashboard oder einem Agenten laufen (Both). Er prüft die Netzwerk-Erreichbarkeit von dem Host aus, auf dem er konfiguriert ist.
Sinnvolle Einsatzszenarien:
Vorteil gegenüber HTTP: Kein Protokoll-Overhead, funktioniert für jeden TCP-Service unabhängig vom Anwendungsprotokoll.
| Feld | Typ | Pflicht | Standard | Beschreibung |
|---|---|---|---|---|
| Host | text |
Ja | — | Hostname oder IP-Adresse. Beispiel: db.intern, 192.168.1.10. |
| Port | number |
Ja | — | TCP-Port-Nummer (1–65535). |
| Timeout (Sekunden) | number |
Nein | 5 |
Maximale Wartezeit auf eine Verbindung. |
| Ergebnis | Status |
|---|---|
| TCP-Verbindung erfolgreich | ok |
| Verbindung abgelehnt | fail |
| Verbindung timeout | fail |
| Host nicht auflösbar (DNS-Fehler) | fail |
| Host oder Port nicht konfiguriert | unknown |