TP-Link Switch
Monitor JetStream and Omada switch CPU, memory, PoE budget, and required uplinks over SNMP.
The TP-Link Switch check monitors JetStream/Omada switches over SNMP: one-minute CPU utilization, memory utilization, PoE budget consumption and power, PoE faults, and selected uplinks. It runs every 5 minutes by default on an octoja agent with Windows, Linux, or macOS, on x64 or ARM64.
Prerequisites
- An online octoja agent that can reach the switch's management address on UDP 161, or your configured SNMP port.
- SNMP enabled on the switch, with read-only v1, v2c or v3 credentials and access allowed from the executing agent. Use a version supported by the device firmware; do not point the check at the Omada controller.
- Firmware that exposes the relevant TP-Link MIBs. An SNMP response alone does not establish that CPU, memory, or PoE values are available. See TP-Link's MIB downloads.
The check reads values; it does not configure the switch. Prefer authenticated, encrypted SNMPv3 where supported. A v1/v2c community travels unencrypted; replace the public default on the device and in octoja.
Steps
- Open the executing device under Devices, then Checks → Add Check, and select TP-Link Switch. See Activate your first check for the assignment workflow.
- Enter the switch's management hostname or IP under Host / IP, and matching SNMP credentials.
- Set thresholds and, optionally, Required links. Enter exact
ifDescrnames orifIndexvalues obtained from the device's IF-MIB; these are not fixed port numbers shared by all models. - Click Add Check. After a run, confirm that the expected metrics appear and inspect any unavailable-metric warning.
You can instead register the switch as an agentless network device with a monitoring asset. Add the check to that switch's Checks tab. Its own IP address is used automatically; when SNMP is configured on the network device, its connection settings override the check-level SNMP fields. Thresholds and required links remain check settings.
Settings
Reaching a threshold is enough to trigger its status. If warning exceeds critical, the check orders the pair from lower to higher. Selecting None for authentication hides the privacy fields and disables encryption. MD5 and DES are not offered.
Results
The highest severity determines the overall result. CPU and memory are reported per discovered unit, not assumed to have index 1. PoE supports the TP-Link L2 scalar and L3 unit-table layouts; power is shown in watts. SNMP uptime is shown in days and is not an Internet-connectivity test.
PoE overload, short circuit, nonstandard powered device, high/low voltage, hardware fault, and overtemperature are Critical. A PoE port being off, starting, or on is not itself a fault. A missing status for a selected link warns rather than pretending the link is up.
FAQ
Why are no PoE values shown?
Why are no PoE values shown?
PoE is optional. If the device exposes no supported PoE data, the check omits it without an alarm. This can mean a non-PoE switch or unavailable PoE MIB support; it does not prove that a PoE-capable switch's power system is healthy.
Does this check monitor chassis temperature, fans, or Internet access?
Does this check monitor chassis temperature, fans, or Internet access?
No. It does not poll chassis temperature or fans. A reported PoE overtemperature fault is a PoE state, not a chassis temperature measurement. Required links test interface state only; use a separate reachability or service check for Internet access.
Was this helpful?
More in Network
3CX Phone SystemBandwidthDNS ResolutionDNS Blacklist (RBL)Still need help? Ask the team