Skip to main content
Network

TP-Link Gateway

Monitor Omada gateway SNMP availability and selected WAN/LAN links, and understand the limits of interface-state monitoring.

The TP-Link Gateway check monitors an Omada gateway's SNMP availability and selected WAN/LAN interface states using IF-MIB. It runs every 5 minutes by default on an octoja agent with Windows, Linux, or macOS, on x64 or ARM64. It does not monitor proprietary CPU/RAM values, routing, VPNs, or Internet reachability.

An up link is not proof of Internet access. A WAN interface can be up while upstream connectivity, DNS, or a service is unavailable. Add a separate Ping or SSL / HTTP check for the destination or service you need to verify.

Prerequisites

  • An online octoja agent that can reach the gateway's management address on UDP 161, or your configured SNMP port.
  • SNMP enabled on the gateway, read-only v1, v2c or v3 credentials, and access allowed from the executing agent. Match the version supported by the firmware; query the gateway, not the Omada controller.
  • The exact IF-MIB ifDescr name or ifIndex value for each WAN/LAN link you require. Use an SNMP table walk of ifDescr (1.3.6.1.2.1.2.2.1.2) to discover these from the executing device. Do not assume that a particular index always means WAN1: interfaces depend on firmware and configured WAN VLANs. See TP-Link's gateway SNMP guidance.

Prefer authenticated, encrypted SNMPv3 where supported. A v1/v2c community travels unencrypted; replace the public default on the device and in octoja.

Steps

  1. Open the executing device under Devices, then Checks → Add Check, and select TP-Link Gateway. See Activate your first check for the assignment workflow.
  2. Enter the gateway's management address under Host / IP and matching SNMP credentials.
  3. Enter the discovered names or indices under Required links. Select at least one link; an empty selection produces Warning because no link health is configured.
  4. Click Add Check. After a run, confirm that each selected link has the expected name and state. Recheck your selections after firmware, port-role, or WAN VLAN changes.

You can instead register the gateway as an agentless network device with a monitoring asset. Add the check to the gateway's Checks tab. Its own IP address is used automatically; when SNMP is configured on the network device, its connection settings override check-level SNMP fields. Required links remain a check setting.

Settings

FieldTypeRequiredDefaultDescription
Host / IPStringYes—Gateway management address, without https://.
SNMP versionSelectNov2cv1, v2c or v3, matching the device firmware. Choose v1 only if the device does not offer v2c.
SNMP portIntegerNo161UDP port, from 1 to 65535.
Community (v1/v2c)StringNopublicRead community; visible for v1 and v2c.
Username (v3)StringFor v3—SNMPv3 user.
Authentication protocolSelectNoSHA-1None, SHA-1, or SHA-256; visible for v3.
Authentication passwordPasswordWith authentication—Required unless authentication is None.
Privacy protocolSelectNoAES-128None, AES-128, AES-192, or AES-256; visible with authentication.
Privacy passwordPasswordWith encryption—Required unless privacy is None.
Required linksList of stringsFor link monitoringEmptyExact, case-sensitive ifDescr names or discovered ifIndex values. Empty selection warns; unselected ports do not alarm.

Selecting None for authentication disables encryption and hides privacy fields. MD5 and DES are not offered. Interface names are entered directly; do not expect a discovered-port picker populated by a previous check run.

Results

The highest severity determines the overall result. SNMP uptime is displayed in days. For selected links, only ifOperStatus = 1 means Up; other returned states are not accepted as healthy.

ResultMeaning and next action
OKSNMP responded and all selected links are up. This does not prove Internet connectivity.
WarningNo links are selected, or a selected interface's state is unavailable. Configure required links or check IF-MIB support and access. An unavailable state is shown as Unknown, not Up.
CriticalA selected interface is missing or not up, or SNMP did not respond. Check port/VLAN configuration and rediscover changed indices. For no response, check UDP access, community, and device access rules.
ErrorConfiguration, SNMP authentication/access, or protocol processing failed. Read the error and check credentials, enabled protocols, and input values.

FAQ

Only links you select are evaluated. Leave unused ports unselected. Select a standby WAN only if its interface must remain up for your design; the check does not evaluate failover policy or distinguish an intentionally down link from a failed one.