Zum Hauptinhalt springen
Netzwerk

TP-Link Switch

Überwache CPU, Arbeitsspeicher, PoE-Budget und erforderliche Uplinks von JetStream- und Omada-Switches per SNMP.

Der Check TP-Link Switch überwacht JetStream-/Omada-Switches per SNMP: CPU-Auslastung über eine Minute, Arbeitsspeicher, genutztes PoE-Budget und PoE-Leistung, PoE-Fehler und ausgewählte Uplinks. Er läuft standardmäßig alle 5 Minuten auf einem octoja-Agenten unter Windows, Linux oder macOS, jeweils auf x64 oder ARM64.

Voraussetzungen

  • Ein online erreichbarer octoja-Agent mit Zugriff auf die Management-Adresse des Switches über UDP 161 oder deinen abweichenden SNMP-Port.
  • Aktiviertes SNMP auf dem Switch, v1-, v2c- oder v3-Zugangsdaten mit Leserechten und erlaubter Zugriff vom ausführenden Agenten. Wähle eine von der Geräte-Firmware unterstützte Version; verwende nicht die Adresse des Omada-Controllers.
  • Firmware, die die passenden TP-Link-MIBs bereitstellt. Eine SNMP-Antwort allein belegt nicht, dass CPU-, Speicher- oder PoE-Werte verfügbar sind. Siehe MIB-Downloads von TP-Link.

Der Check liest Werte und konfiguriert den Switch nicht. Nutze nach Möglichkeit authentifiziertes, verschlüsseltes SNMPv3. Eine v1/v2c-Community wird unverschlüsselt übertragen; ersetze den Standardwert public auf dem Gerät und in octoja.

Schritte

  1. Öffne das ausführende Gerät unter Geräte, dann Checks → Check hinzufügen, und wähle TP-Link Switch. Den Zuweisungsablauf beschreibt Deinen ersten Check aktivieren.
  2. Gib unter Host / IP den Management-Hostnamen oder die IP-Adresse des Switches und die passenden SNMP-Zugangsdaten ein.
  3. Lege Schwellenwerte fest und ergänze bei Bedarf Erforderliche Verbindungen. Verwende exakte ifDescr-Namen oder ifIndex-Werte aus der IF-MIB des Geräts; diese sind keine modellübergreifend festen Portnummern.
  4. Klicke auf Check hinzufügen. Prüfe nach einem Lauf, ob die erwarteten Messwerte vorhanden sind, und beachte Warnungen über fehlende Werte.

Alternativ kannst du den Switch als Netzwerkgerät ohne Agent hinzufügen und ihm ein Überwachungsgerät zuweisen. Füge den Check im Tab Checks des Switches hinzu. Seine eigene IP-Adresse wird automatisch verwendet; ist SNMP am Netzwerkgerät konfiguriert, haben dessen Verbindungseinstellungen Vorrang vor den SNMP-Feldern im Check. Schwellenwerte und erforderliche Verbindungen bleiben Check-Einstellungen.

Einstellungen

FeldTypPflichtStandardBeschreibung
Host / IPTextJa—Management-Adresse des Switches ohne https://.
SNMP-VersionAuswahlNeinv2cv1, v2c oder v3; passend zur aktivierten Version der Firmware. Wähle v1 nur, wenn das Gerät kein v2c anbietet.
SNMP-PortGanzzahlNein161UDP-Port von 1 bis 65535.
Community (v1/v2c)TextNeinpublicCommunity mit Leserechten; bei v1 und v2c sichtbar.
Benutzername (v3)TextBei v3—SNMPv3-Benutzer.
AuthentifizierungsprotokollAuswahlNeinSHA-1Keines, SHA-1 oder SHA-256; bei v3 sichtbar.
AuthentifizierungspasswortPasswortMit Authentifizierung—Erforderlich, sofern das Authentifizierungsprotokoll nicht Keines ist.
VerschlüsselungsprotokollAuswahlNeinAES-128Keines, AES-128, AES-192 oder AES-256; mit Authentifizierung sichtbar.
VerschlüsselungspasswortPasswortMit Verschlüsselung—Erforderlich, sofern das Verschlüsselungsprotokoll nicht Keines ist.
Erforderliche VerbindungenTextlisteNeinLeerExakte IF-MIB-ifDescr-Namen mit passender Groß-/Kleinschreibung oder ifIndex-Werte. Nicht ausgewählte Ports lösen keinen Alarm aus.
CPU-Warnung (%) / CPU kritisch (%)GanzzahlNein85 / 95CPU-Auslastung; jeder Wert muss zwischen 1 und 100 liegen.
Arbeitsspeicher: Warnung (%) / Arbeitsspeicher: kritisch (%)GanzzahlNein85 / 95Speicherauslastung; jeder Wert muss zwischen 1 und 100 liegen.
PoE-Budget: Warnung (%) / PoE-Budget: kritisch (%)GanzzahlNein85 / 95Genutztes PoE-Budget in Prozent des Limits; jeder Wert muss zwischen 1 und 100 liegen.

Das Erreichen eines Schwellenwerts löst bereits den jeweiligen Status aus. Liegt die Warnung über dem kritischen Wert, ordnet der Check das Paar vom niedrigeren zum höheren Wert. Mit Keines als Authentifizierungsprotokoll werden die Verschlüsselungsfelder ausgeblendet und die Verschlüsselung deaktiviert. MD5 und DES werden nicht angeboten.

Ergebnisse

Die höchste Schwere bestimmt das Gesamtergebnis. CPU und Arbeitsspeicher werden je ermittelter Einheit angezeigt; Index 1 wird nicht vorausgesetzt. PoE unterstützt die TP-Link-L2-Einzelwerte und die L3-Einheitentabelle; Leistung wird in Watt angezeigt. Die SNMP-Laufzeit wird in Tagen angezeigt und ist kein Test des Internetzugangs.

ErgebnisBedeutung und nächster Schritt
OKGelieferte Werte liegen unter den Schwellenwerten und ausgewählte Verbindungen sind aktiv. Prüfe, ob deine erwarteten Messwerte vorhanden sind.
WarnungEin Warnschwellenwert wurde erreicht oder ein erwarteter CPU-/Speicherwert fehlt oder ist ungültig. Prüfe Firmware und MIB-Unterstützung, statt fehlende Werte als null zu behandeln. Unvollständige oder ungültige gelieferte PoE-Werte ergeben ebenfalls eine Warnung.
KritischEin kritischer Schwellenwert wurde erreicht, eine erforderliche Verbindung fehlt oder ist inaktiv, ein PoE-Fehler wurde gemeldet oder SNMP antwortet nicht. Prüfe die betroffene Einheit bzw. den Port; bei fehlender Antwort prüfe UDP-Zugriff, Community und Geräte-Zugriffsregeln.
FehlerKonfiguration, SNMP-Authentifizierung/Zugriff oder Protokollverarbeitung ist fehlgeschlagen. Lies den Fehler und prüfe Zugangsdaten, aktivierte Protokolle und gültige Eingabewerte.

PoE-Überlastung, Kurzschluss, nicht standardkonforme versorgte Geräte, zu hohe/niedrige Spannung, Hardwarefehler und Übertemperatur sind kritisch. Ein ausgeschalteter, startender oder eingeschalteter PoE-Port ist für sich kein Fehler. Ein fehlender Status einer ausgewählten Verbindung ergibt eine Warnung, statt eine aktive Verbindung vorzutäuschen.

FAQ

PoE ist optional. Stellt das Gerät keine unterstützten PoE-Daten bereit, lässt der Check sie ohne Alarm weg. Das kann an einem Switch ohne PoE oder fehlender PoE-MIB-Unterstützung liegen; es belegt nicht, dass die Stromversorgung eines PoE-fähigen Switches fehlerfrei ist.

Nein. Er fragt weder Gehäusetemperatur noch Lüfter ab. Eine gemeldete PoE-Übertemperatur ist ein PoE-Zustand, kein Messwert der Gehäusetemperatur. Erforderliche Verbindungen prüfen nur den Schnittstellenstatus; verwende für Internetzugang einen zusätzlichen Erreichbarkeits- oder Dienstcheck.