Zum Hauptinhalt springen
Netzwerk

TCP-Port

Prüfe mit diesem Check, ob Dienste auf ihren TCP-Ports erreichbar sind und die Verbindung schnell genug aufgebaut wird.

Der Check TCP-Port baut vom Agent-Gerät aus eine TCP-Verbindung zu einem oder mehreren Zielen auf und misst, wie lange der Verbindungsaufbau dauert. So erkennst du, ob ein Dienst wie ein Mail-, Web- oder Datenbankserver auf seinem Port erreichbar ist und schnell genug antwortet. Der Check sendet keine Daten und prüft keine Protokoll-Antwort, sondern nur, ob der Port eine Verbindung annimmt. Er läuft unter Windows, Linux und macOS (jeweils als x64- und Arm64-Build) standardmäßig alle 5 Minuten; das Intervall ist nicht durch den Benutzer konfigurierbar.

Voraussetzungen

  • Das Gerät, auf dem der Check läuft, muss einen verbundenen octoja-Agent haben.
  • Die Ziele müssen von diesem Gerät aus erreichbar sein. Firewalls auf dem Weg müssen ausgehende Verbindungen zum jeweiligen Port zulassen.

Schritte

  1. Öffne die Geräteseite.
  2. Wähle im Tab Checks Check hinzufügen → TCP-Port.
  3. Trage unter Ziele (Host:Port) die zu prüfenden Endpunkte ein und passe bei Bedarf die Schwellenwerte an.

Um den Check auf viele Geräte auszurollen, nutze ein Konfigurationspaket: Checks mit Konfigurationspaketen zuweisen.

Einstellungen

FeldTypErforderlichStandardBeschreibung
Ziele (Host:Port)Liste von StringsJa—Zu prüfende TCP-Endpunkte im Format Host:Port, z. B. mail.example.com:993. Der Port muss zwischen 1 und 65535 liegen. Leere Einträge werden übersprungen.
Timeout (ms)GanzzahlNein5000Maximale Wartezeit für den Verbindungsaufbau pro Ziel. Werte werden auf 500–60000 ms begrenzt.

Schwellenwerte

FeldTypErforderlichStandardBeschreibung
Warnung Verbindungszeit (ms)GanzzahlNein1000Verbindungszeit, ab der ein Ziel als Warnung gilt
Fehler Verbindungszeit (ms)GanzzahlNein3000Verbindungszeit, ab der ein Ziel als Kritisch gilt
  • Der Check trennt Host und Port am letzten Doppelpunkt im Eintrag.
  • Ist Warnung Verbindungszeit (ms) größer als Fehler Verbindungszeit (ms), vertauscht der Check die beiden Werte vor der Auswertung.
  • Liegt Timeout (ms) unter Fehler Verbindungszeit (ms), bricht der Verbindungsaufbau vorher ab und das Ziel wird wegen Zeitüberschreitung Kritisch.
  • Bis zu zehn Ziele werden parallel geprüft.

Ergebnisse

Jedes Ziel wird einzeln bewertet. Das Gesamtergebnis des Checks ist das schlechteste Ergebnis über alle Ziele.

Ergebnis pro ZielBedingung
OKVerbindung hergestellt, Verbindungszeit unter Warnung Verbindungszeit (ms)
WarnungVerbindung hergestellt, Verbindungszeit größer oder gleich Warnung Verbindungszeit (ms)
KritischVerbindungszeit größer oder gleich Fehler Verbindungszeit (ms), Zeitüberschreitung der Verbindung oder Verbindung abgelehnt bzw. nicht erreichbar (auch wenn der Hostname nicht aufgelöst werden kann)
FehlgeschlagenDer Eintrag hat nicht das Format Host:Port oder enthält keinen gültigen Port, oder beim Verbindungsaufbau ist ein unerwarteter Fehler aufgetreten

Enthält Ziele (Host:Port) keinen einzigen nicht leeren Eintrag, meldet der Check Warnung.

Der Check erfasst:

  • Host und Port pro Ziel
  • Ob die Verbindung hergestellt wurde
  • Verbindungszeit in Millisekunden
  • Fehlerursache pro Ziel: ungültiges Ziel, Zeitüberschreitung oder Verbindung abgelehnt bzw. nicht erreichbar

Verwandte Artikel

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen