# TP-LINK by SNMP ## Overview Link to MIBs: https://www.tp-link.com/en/support/download/t2600g-28ts/#MIBs_Files Sample device overview page: https://www.tp-link.com/en/business-networking/managed-switch/t2600g-28ts/#overview Emulation page (web): https://emulator.tp-link.com/T2600G-28TS(UN)_1.0/Index.htm ### Known issues - Description: 'Default sysLocation, sysName and sysContact is not filled with proper data. Real hostname and location can be found only in private branch (TPLINK-SYSINFO-MIB). Please check whether this problem exists in the latest firmware: https://www.tp-link.com/en/support/download/t2600g-28ts/#Firmware' version: 2.0.0 Build 20170628 Rel.55184 (Beta) device: T2600G-28TS 2.0 - Description: The Serial number of the product (tpSysInfoSerialNum) is missing in HW versions prior to V2_170323 version: Prior to version V2_170323 device: T2600G-28TS 2.0 ## Requirements Zabbix version: 7.0 and higher. ## Tested versions This template has been tested on: - T2600G-28TS revision 2.0 2.0.0 Build 20170628 Rel.55184 (Beta) ## Configuration > Zabbix should be configured according to the instructions in the [Templates out of the box](https://www.zabbix.com/documentation/7.0/manual/config/templates_out_of_the_box) section. ## Setup Refer to the vendor documentation. ### Macros used |Name|Description|Default| |----|-----------|-------| |{$MEMORY.UTIL.MAX}||`90`| |{$CPU.UTIL.CRIT}||`90`| |{$SNMP.TIMEOUT}||`5m`| |{$ICMP_LOSS_WARN}||`20`| |{$ICMP_RESPONSE_TIME_WARN}||`0.15`| |{$IFCONTROL}||`1`| |{$IF.UTIL.MAX}||`95`| |{$NET.IF.IFNAME.MATCHES}||`^.*$`| |{$NET.IF.IFNAME.NOT_MATCHES}|

Filter out loopbacks, nulls, docker veth links and docker0 bridge by default

|`Macro too long. Please see the template.`| |{$NET.IF.IFOPERSTATUS.MATCHES}||`^.*$`| |{$NET.IF.IFOPERSTATUS.NOT_MATCHES}|

Ignore notPresent(6)

|`^6$`| |{$NET.IF.IFADMINSTATUS.MATCHES}|

Ignore notPresent(6)

|`^.*`| |{$NET.IF.IFADMINSTATUS.NOT_MATCHES}|

Ignore down(2) administrative status

|`^2$`| |{$NET.IF.IFDESCR.MATCHES}||`.*`| |{$NET.IF.IFDESCR.NOT_MATCHES}||`CHANGE_IF_NEEDED`| |{$NET.IF.IFTYPE.MATCHES}||`.*`| |{$NET.IF.IFTYPE.NOT_MATCHES}||`CHANGE_IF_NEEDED`| |{$IF.ERRORS.WARN}||`2`| ### Items |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |TP-LINK: Hardware model name|

MIB: TPLINK-SYSINFO-MIB

The hardware version of the product.

|SNMP agent|system.hw.model

**Preprocessing**

| |TP-LINK: Hardware serial number|

MIB: TPLINK-SYSINFO-MIB

The Serial number of the product.

|SNMP agent|system.hw.serialnumber

**Preprocessing**

| |TP-LINK: Firmware version|

MIB: TPLINK-SYSINFO-MIB

The software version of the product.

|SNMP agent|system.hw.firmware

**Preprocessing**

| |TP-LINK: Hardware version(revision)|

MIB: TPLINK-SYSINFO-MIB

The hardware version of the product.

|SNMP agent|system.hw.version

**Preprocessing**

| |TP-LINK: SNMP walk system CPUs|

Discovering TPLINK-SYSMONITOR-MIB::tpSysMonitorCpuTable, displays the CPU utilization of all UNITs.

|SNMP agent|system.cpu.walk| |TP-LINK: SNMP walk memory|

Discovering TPLINK-SYSMONITOR-MIB::tpSysMonitorMemoryTable, displays the memory utilization of all UNITs.

|SNMP agent|vm.memory.walk| |TP-LINK: Uptime (network)|

MIB: SNMPv2-MIB

The time (in hundredths of a second) since the network management portion of the system was last re-initialized.

|SNMP agent|system.net.uptime[sysUpTime.0]

**Preprocessing**

| |TP-LINK: Uptime (hardware)|

MIB: HOST-RESOURCES-MIB

The amount of time since this host was last initialized. Note that this is different from sysUpTime in the SNMPv2-MIB [RFC1907] because sysUpTime is the uptime of the network management portion of the system.

|SNMP agent|system.hw.uptime[hrSystemUptime.0]

**Preprocessing**

| |TP-LINK: SNMP traps (fallback)|

The item is used to collect all SNMP traps unmatched by other snmptrap items

|SNMP trap|snmptrap.fallback| |TP-LINK: System location|

MIB: SNMPv2-MIB

The physical location of this node (e.g., `telephone closet, 3rd floor'). If the location is unknown, the value is the zero-length string.

|SNMP agent|system.location[sysLocation.0]

**Preprocessing**

| |TP-LINK: System contact details|

MIB: SNMPv2-MIB

The textual identification of the contact person for this managed node, together with information on how to contact this person. If no contact information is known, the value is the zero-length string.

|SNMP agent|system.contact[sysContact.0]

**Preprocessing**

| |TP-LINK: System object ID|

MIB: SNMPv2-MIB

The vendor's authoritative identification of the network management subsystem contained in the entity. This value is allocated within the SMI enterprises subtree (1.3.6.1.4.1) and provides an easy and unambiguous means for determining`what kind of box' is being managed. For example, if vendor`Flintstones, Inc.' was assigned the subtree1.3.6.1.4.1.4242, it could assign the identifier 1.3.6.1.4.1.4242.1.1 to its `Fred Router'.

|SNMP agent|system.objectid[sysObjectID.0]

**Preprocessing**

| |TP-LINK: System name|

MIB: SNMPv2-MIB

An administratively-assigned name for this managed node.By convention, this is the node's fully-qualified domain name. If the name is unknown, the value is the zero-length string.

|SNMP agent|system.name

**Preprocessing**

| |TP-LINK: System description|

MIB: SNMPv2-MIB

A textual description of the entity. This value should

include the full name and version identification of the system's hardware type, software operating-system, and

networking software.

|SNMP agent|system.descr[sysDescr.0]

**Preprocessing**

| |TP-LINK: SNMP agent availability|

Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list.

Possible value:

0 - not available

1 - available

2 - unknown

|Zabbix internal|zabbix[host,snmp,available]| |TP-LINK: ICMP ping||Simple check|icmpping| |TP-LINK: ICMP loss||Simple check|icmppingloss| |TP-LINK: ICMP response time||Simple check|icmppingsec| |TP-LINK: SNMP walk network interfaces|

Discovering interfaces from IF-MIB.

|SNMP agent|net.if.walk| ### Triggers |Name|Description|Expression|Severity|Dependencies and additional info| |----|-----------|----------|--------|--------------------------------| |TP-LINK: Device has been replaced|

Device serial number has changed. Acknowledge to close the problem manually.

|`last(/TP-LINK by SNMP/system.hw.serialnumber,#1)<>last(/TP-LINK by SNMP/system.hw.serialnumber,#2) and length(last(/TP-LINK by SNMP/system.hw.serialnumber))>0`|Info|**Manual close**: Yes| |TP-LINK: Firmware has changed|

Firmware version has changed. Acknowledge to close the problem manually.

|`last(/TP-LINK by SNMP/system.hw.firmware,#1)<>last(/TP-LINK by SNMP/system.hw.firmware,#2) and length(last(/TP-LINK by SNMP/system.hw.firmware))>0`|Info|**Manual close**: Yes| |TP-LINK: Host has been restarted|

Uptime is less than 10 minutes.

|`(last(/TP-LINK by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/TP-LINK by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/TP-LINK by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/TP-LINK by SNMP/system.net.uptime[sysUpTime.0])<10m)`|Warning|**Manual close**: Yes
**Depends on**:
| |TP-LINK: System name has changed|

The name of the system has changed. Acknowledge to close the problem manually.

|`last(/TP-LINK by SNMP/system.name,#1)<>last(/TP-LINK by SNMP/system.name,#2) and length(last(/TP-LINK by SNMP/system.name))>0`|Info|**Manual close**: Yes| |TP-LINK: No SNMP data collection|

SNMP is not available for polling. Please check device connectivity and SNMP settings.

|`max(/TP-LINK by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0`|Warning|**Depends on**:
| |TP-LINK: Unavailable by ICMP ping|

Last three attempts returned timeout. Please check device connectivity.

|`max(/TP-LINK by SNMP/icmpping,#3)=0`|High|| |TP-LINK: High ICMP ping loss||`min(/TP-LINK by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/TP-LINK by SNMP/icmppingloss,5m)<100`|Warning|**Depends on**:
| |TP-LINK: High ICMP ping response time||`avg(/TP-LINK by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN}`|Warning|**Depends on**:
| ### LLD rule CPU Discovery |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |CPU Discovery|

Discovering TPLINK-SYSMONITOR-MIB::tpSysMonitorCpuTable, displays the CPU utilization of all UNITs.

|Dependent item|cpu.discovery

**Preprocessing**

| ### Item prototypes for CPU Discovery |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |#{#SNMPVALUE}: CPU utilization|

MIB: TPLINK-SYSMONITOR-MIB

Displays the CPU utilization in 1 minute.

Reference: http://www.tp-link.com/faq-1330.html

|Dependent item|system.cpu.util[tpSysMonitorCpu1Minute.{#SNMPINDEX}]

**Preprocessing**

| ### Trigger prototypes for CPU Discovery |Name|Description|Expression|Severity|Dependencies and additional info| |----|-----------|----------|--------|--------------------------------| |#{#SNMPVALUE}: High CPU utilization|

The CPU utilization is too high. The system might be slow to respond.

|`min(/TP-LINK by SNMP/system.cpu.util[tpSysMonitorCpu1Minute.{#SNMPINDEX}],5m)>{$CPU.UTIL.CRIT}`|Warning|| ### LLD rule Memory Discovery |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |Memory Discovery|

Discovering TPLINK-SYSMONITOR-MIB::tpSysMonitorMemoryTable, displays the memory utilization of all UNITs.

|Dependent item|memory.discovery

**Preprocessing**

| ### Item prototypes for Memory Discovery |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |#{#SNMPVALUE}: Memory utilization|

MIB: TPLINK-SYSMONITOR-MIB

Displays the memory utilization.

Reference: http://www.tp-link.com/faq-1330.html

|Dependent item|vm.memory.util[tpSysMonitorMemoryUtilization.{#SNMPINDEX}]

**Preprocessing**

| ### Trigger prototypes for Memory Discovery |Name|Description|Expression|Severity|Dependencies and additional info| |----|-----------|----------|--------|--------------------------------| |#{#SNMPVALUE}: High memory utilization|

The system is running out of free memory.

|`min(/TP-LINK by SNMP/vm.memory.util[tpSysMonitorMemoryUtilization.{#SNMPINDEX}],5m)>{$MEMORY.UTIL.MAX}`|Average|| ### LLD rule Network interfaces discovery |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |Network interfaces discovery|

Discovering interfaces from IF-MIB.

|Dependent item|net.if.discovery

**Preprocessing**

| ### Item prototypes for Network interfaces discovery |Name|Description|Type|Key and additional info| |----|-----------|----|-----------------------| |Interface {#IFDESCR}: Operational status|

MIB: IF-MIB

The current operational state of the interface.

- The testing(3) state indicates that no operational packet scan be passed

- If ifAdminStatus is down(2) then ifOperStatus should be down(2)

- If ifAdminStatus is changed to up(1) then ifOperStatus should change to up(1) if the interface is ready to transmit and receive network traffic

- It should change todormant(5) if the interface is waiting for external actions (such as a serial line waiting for an incoming connection)

- It should remain in the down(2) state if and only if there is a fault that prevents it from going to the up(1) state

- It should remain in the notPresent(6) state if the interface has missing(typically, hardware) components.

|Dependent item|net.if.status[ifOperStatus.{#SNMPINDEX}]

**Preprocessing**

| |Interface {#IFDESCR}: Bits received|

MIB: IF-MIB

The total number of octets received on the interface,including framing characters. Discontinuities in the value of this counter can occur at re-initialization of the management system, and another times as indicated by the value of ifCounterDiscontinuityTime.

|Dependent item|net.if.in[ifInOctets.{#SNMPINDEX}]

**Preprocessing**

| |Interface {#IFDESCR}: Bits sent|

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

|Dependent item|net.if.out[ifOutOctets.{#SNMPINDEX}]

**Preprocessing**

| |Interface {#IFDESCR}: Inbound packets with errors|

MIB: IF-MIB

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

|Dependent item|net.if.in.errors[ifInErrors.{#SNMPINDEX}]

**Preprocessing**

| |Interface {#IFDESCR}: Outbound packets with errors|

MIB: IF-MIB

For packet-oriented interfaces, the number of outbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of outbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.

|Dependent item|net.if.out.errors[ifOutErrors.{#SNMPINDEX}]

**Preprocessing**

| |Interface {#IFDESCR}: Outbound packets discarded|

MIB: IF-MIB

The number of outbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

|Dependent item|net.if.out.discards[ifOutDiscards.{#SNMPINDEX}]

**Preprocessing**

| |Interface {#IFDESCR}: Inbound packets discarded|

MIB: IF-MIB

The number of inbound packets which were chosen to be discarded

even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.

One possible reason for discarding such a packet could be to free up buffer space.

Discontinuities in the value of this counter can occur at re-initialization of the management system,

and at other times as indicated by the value of ifCounterDiscontinuityTime.

|Dependent item|net.if.in.discards[ifInDiscards.{#SNMPINDEX}]

**Preprocessing**

| |Interface {#IFDESCR}: Interface type|

MIB: IF-MIB

The type of interface.

Additional values for ifType are assigned by the Internet Assigned Numbers Authority (IANA),

through updating the syntax of the IANAifType textual convention.

|Dependent item|net.if.type[ifType.{#SNMPINDEX}]

**Preprocessing**

| |Interface {#IFDESCR}: Speed|

MIB: IF-MIB

An estimate of the interface's current bandwidth in bits per second.

For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made,

this object should contain the nominal bandwidth.

If the bandwidth of the interface is greater than the maximum value reportable by this object then

this object should report its maximum value (4,294,967,295) and ifHighSpeed must be used to report the interface's speed.

For a sub-layer which has no concept of bandwidth, this object should be zero.

|Dependent item|net.if.speed[ifSpeed.{#SNMPINDEX}]

**Preprocessing**

| ### Trigger prototypes for Network interfaces discovery |Name|Description|Expression|Severity|Dependencies and additional info| |----|-----------|----------|--------|--------------------------------| |Interface {#IFDESCR}: Link down|

This trigger expression works as follows:
1. It can be triggered if the operations status is down.
2. `{$IFCONTROL:"{#IFNAME}"}=1` - a user can redefine context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.
3. `{TEMPLATE_NAME:METRIC.diff()}=1` - the trigger fires only if the operational status was up to (1) sometime before (so, do not fire for the 'eternal off' interfaces.)

WARNING: if closed manually - it will not fire again on the next poll, because of .diff.

|`{$IFCONTROL:"{#IFNAME}"}=1 and last(/TP-LINK by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/TP-LINK by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/TP-LINK by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#2))`|Average|**Manual close**: Yes| |Interface {#IFDESCR}: High bandwidth usage|

The utilization of the network interface is close to its estimated maximum bandwidth.

|`(avg(/TP-LINK by SNMP/net.if.in[ifInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/TP-LINK by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) or avg(/TP-LINK by SNMP/net.if.out[ifOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/TP-LINK by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])) and last(/TP-LINK by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0`|Warning|**Manual close**: Yes
**Depends on**:
| |Interface {#IFDESCR}: High error rate|

It recovers when it is below 80% of the `{$IF.ERRORS.WARN:"{#IFNAME}"}` threshold.

|`min(/TP-LINK by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/TP-LINK by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"}`|Warning|**Manual close**: Yes
**Depends on**:
| |Interface {#IFDESCR}: Ethernet has changed to lower speed than it was before|

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Acknowledge to close the problem manually.

|`change(/TP-LINK by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])<0 and last(/TP-LINK by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 and ( last(/TP-LINK by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/TP-LINK by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/TP-LINK by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/TP-LINK by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/TP-LINK by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/TP-LINK by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/TP-LINK by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])<>2)`|Info|**Manual close**: Yes
**Depends on**:
| ## Feedback Please report any issues with the template at [`https://support.zabbix.com`](https://support.zabbix.com) You can also provide feedback, discuss the template, or ask for help at [`ZABBIX forums`](https://www.zabbix.com/forum/zabbix-suggestions-and-feedback)