Available solutions
Ubiquiti AirOS by SNMP
Overview
This template is designed for the effortless deployment of Ubiquiti AirOS monitoring by Zabbix via SNMP and doesn't require any external scripts.
Known issues
- Description: 'UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces'
- version: 'Firmware: BZ.ar7240.v3.7.51.6230.170322.1513'
- device: UBNT UAP-LR
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and other types'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: ifXTable is not provided in IF-MIB. So Interfaces Simple Template is used instead
- version: all above
- device: NanoStation, UAP-LR
Requirements
Zabbix version: 7.4 and higher.
Tested versions
This template has been tested on:
- Ubiquiti AirOS
Configuration
Zabbix should be configured according to the instructions in the Templates out of the box section.
Setup
Refer to the vendor documentation.
Macros used
| Name | Description | Default |
|---|---|---|
| {$MEMORY.UTIL.MAX} | 90 |
|
| {$SNMP.TIMEOUT} | Time interval for the SNMP availability trigger. |
5m |
| {$ICMP_LOSS_WARN} | Warning threshold of ICMP packet loss in %. |
20 |
| {$ICMP_RESPONSE_TIME_WARN} | Warning threshold of the average ICMP response time in seconds. |
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} | ^.* |
|
| {$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 |
|
| {$NET.IF.IFALIAS.MATCHES} | .* |
|
| {$NET.IF.IFALIAS.NOT_MATCHES} | CHANGE_IF_NEEDED |
|
| {$IF.ERRORS.WARN} | 2 |
Items
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Load average (5m avg) | MIB: FROGFOOT-RESOURCES-MIB 5 minute load average of processor load. |
SNMP agent | system.cpu.load.avg5[loadValue.2] Preprocessing
|
| Load average (1m avg) | MIB: FROGFOOT-RESOURCES-MIB 1 minute load average of processor load. |
SNMP agent | system.cpu.load.avg1[loadValue.1] Preprocessing
|
| Load average (15m avg) | MIB: FROGFOOT-RESOURCES-MIB 15 minute load average of processor load. |
SNMP agent | system.cpu.load.avg15[loadValue.3] Preprocessing
|
| Free memory | MIB: FROGFOOT-RESOURCES-MIB |
SNMP agent | vm.memory.free[memFree.0] Preprocessing
|
| Total memory | MIB: FROGFOOT-RESOURCES-MIB The total memory expressed in bytes. |
SNMP agent | vm.memory.total[memTotal.0] Preprocessing
|
| Memory (buffers) | MIB: FROGFOOT-RESOURCES-MIB Memory used by kernel buffers (Buffers in /proc/meminfo). |
SNMP agent | vm.memory.buffers[memBuffer.0] Preprocessing
|
| Memory (cached) | MIB: FROGFOOT-RESOURCES-MIB Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo). |
SNMP agent | vm.memory.cached[memCache.0] Preprocessing
|
| Memory utilization | Memory utilization in %. |
Calculated | vm.memory.util[memoryUsedPercentage] |
| Hardware model name | MIB: IEEE802dot11-MIB A printable string used to identify the manufacturer's product name of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.model Preprocessing
|
| Firmware version | MIB: IEEE802dot11-MIB Printable string used to identify the manufacturer's product version of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.firmware Preprocessing
|
| Uptime (network) | MIB: SNMPv2-MIB 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
|
| 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
|
| SNMP traps (fallback) | The item is used to collect all SNMP traps unmatched by other snmptrap items |
SNMP trap | snmptrap.fallback |
| System location | MIB: SNMPv2-MIB Physical location of the node (e.g., |
SNMP agent | system.location[sysLocation.0] Preprocessing
|
| 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
|
| 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 |
SNMP agent | system.objectid[sysObjectID.0] Preprocessing
|
| 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
|
| 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
|
| SNMP agent availability | Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list. Possible values: 0 - not available 1 - available 2 - unknown |
Zabbix internal | zabbix[host,snmp,available] |
| ICMP ping | The host accessibility by ICMP ping. 0 - ICMP ping fails; 1 - ICMP ping successful. |
Simple check | icmpping |
| ICMP loss | The percentage of lost packets. |
Simple check | icmppingloss |
| ICMP response time | The ICMP ping response time (in seconds). |
Simple check | icmppingsec |
Triggers
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Ubiquiti AirOS: High memory utilization | The system is running out of free memory. |
min(/Ubiquiti AirOS by SNMP/vm.memory.util[memoryUsedPercentage],5m)>{$MEMORY.UTIL.MAX} |
Average | |
| Ubiquiti AirOS: Firmware has changed | Firmware version has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#1)<>last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#2) and length(last(/Ubiquiti AirOS by SNMP/system.hw.firmware))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: Host has been restarted | Uptime is less than 10 minutes. |
(last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/Ubiquiti AirOS by SNMP/system.net.uptime[sysUpTime.0])<10m) |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: System name has changed | The name of the system has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.name,#1)<>last(/Ubiquiti AirOS by SNMP/system.name,#2) and length(last(/Ubiquiti AirOS by SNMP/system.name))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: No SNMP data collection | SNMP is not available for polling. Please check device connectivity and SNMP settings. |
max(/Ubiquiti AirOS by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 |
Warning | Depends on:
|
| Ubiquiti AirOS: Unavailable by ICMP ping | Last three attempts returned timeout. Please check device connectivity. |
max(/Ubiquiti AirOS by SNMP/icmpping,#3)=0 |
High | |
| Ubiquiti AirOS: High ICMP ping loss | ICMP packets loss detected. |
min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)<100 |
Warning | Depends on:
|
| Ubiquiti AirOS: High ICMP ping response time | Average ICMP response time is too high. |
avg(/Ubiquiti AirOS by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} |
Warning | Depends on:
|
LLD rule Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Network interfaces discovery | Discovering interfaces from IF-MIB. |
SNMP agent | net.if.discovery Preprocessing
|
Item prototypes for Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.status[ifOperStatus.{#SNMPINDEX}] |
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in[ifInOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out[ifOutOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.errors[ifInErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.errors[ifOutErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.discards[ifOutDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.discards[ifInDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.type[ifType.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.speed[ifSpeed.{#SNMPINDEX}] |
Trigger prototypes for Network interfaces discovery
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): Link down | This trigger expression works as follows: |
{$IFCONTROL:"{#IFNAME}"}=1 and last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#2)) |
Average | Manual close: Yes |
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): High bandwidth usage | The utilization of the network interface is close to its estimated maximum bandwidth. |
(avg(/Ubiquiti AirOS by SNMP/net.if.in[ifInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) or avg(/Ubiquiti AirOS by SNMP/net.if.out[ifOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])) and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): High error rate | It recovers when it is below 80% of the |
min(/Ubiquiti AirOS by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/Ubiquiti AirOS by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): 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(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])<0 and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 and ( last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/Ubiquiti AirOS 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
You can also provide feedback, discuss the template, or ask for help at ZABBIX forums
Ubiquiti AirOS by SNMP
Overview
This template is designed for the effortless deployment of Ubiquiti AirOS monitoring by Zabbix via SNMP and doesn't require any external scripts.
Known issues
- Description: 'UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces'
- version: 'Firmware: BZ.ar7240.v3.7.51.6230.170322.1513'
- device: UBNT UAP-LR
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and other types'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: ifXTable is not provided in IF-MIB. So Interfaces Simple Template is used instead
- version: all above
- device: NanoStation, UAP-LR
Requirements
Zabbix version: 7.2 and higher.
Tested versions
This template has been tested on:
- Ubiquiti AirOS
Configuration
Zabbix should be configured according to the instructions in the Templates out of the box section.
Setup
Refer to the vendor documentation.
Macros used
| Name | Description | Default |
|---|---|---|
| {$MEMORY.UTIL.MAX} | 90 |
|
| {$SNMP.TIMEOUT} | Time interval for the SNMP availability trigger. |
5m |
| {$ICMP_LOSS_WARN} | Warning threshold of ICMP packet loss in %. |
20 |
| {$ICMP_RESPONSE_TIME_WARN} | Warning threshold of the average ICMP response time in seconds. |
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} | ^.* |
|
| {$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 |
|
| {$NET.IF.IFALIAS.MATCHES} | .* |
|
| {$NET.IF.IFALIAS.NOT_MATCHES} | CHANGE_IF_NEEDED |
|
| {$IF.ERRORS.WARN} | 2 |
Items
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Load average (5m avg) | MIB: FROGFOOT-RESOURCES-MIB 5 minute load average of processor load. |
SNMP agent | system.cpu.load.avg5[loadValue.2] Preprocessing
|
| Load average (1m avg) | MIB: FROGFOOT-RESOURCES-MIB 1 minute load average of processor load. |
SNMP agent | system.cpu.load.avg1[loadValue.1] Preprocessing
|
| Load average (15m avg) | MIB: FROGFOOT-RESOURCES-MIB 15 minute load average of processor load. |
SNMP agent | system.cpu.load.avg15[loadValue.3] Preprocessing
|
| Free memory | MIB: FROGFOOT-RESOURCES-MIB |
SNMP agent | vm.memory.free[memFree.0] Preprocessing
|
| Total memory | MIB: FROGFOOT-RESOURCES-MIB The total memory expressed in bytes. |
SNMP agent | vm.memory.total[memTotal.0] Preprocessing
|
| Memory (buffers) | MIB: FROGFOOT-RESOURCES-MIB Memory used by kernel buffers (Buffers in /proc/meminfo). |
SNMP agent | vm.memory.buffers[memBuffer.0] Preprocessing
|
| Memory (cached) | MIB: FROGFOOT-RESOURCES-MIB Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo). |
SNMP agent | vm.memory.cached[memCache.0] Preprocessing
|
| Memory utilization | Memory utilization in %. |
Calculated | vm.memory.util[memoryUsedPercentage] |
| Hardware model name | MIB: IEEE802dot11-MIB A printable string used to identify the manufacturer's product name of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.model Preprocessing
|
| Firmware version | MIB: IEEE802dot11-MIB Printable string used to identify the manufacturer's product version of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.firmware Preprocessing
|
| Uptime (network) | MIB: SNMPv2-MIB 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
|
| 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
|
| SNMP traps (fallback) | The item is used to collect all SNMP traps unmatched by other snmptrap items |
SNMP trap | snmptrap.fallback |
| System location | MIB: SNMPv2-MIB Physical location of the node (e.g., |
SNMP agent | system.location[sysLocation.0] Preprocessing
|
| 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
|
| 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 |
SNMP agent | system.objectid[sysObjectID.0] Preprocessing
|
| 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
|
| 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
|
| SNMP agent availability | Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list. Possible values: 0 - not available 1 - available 2 - unknown |
Zabbix internal | zabbix[host,snmp,available] |
| ICMP ping | Simple check | icmpping | |
| ICMP loss | Simple check | icmppingloss | |
| ICMP response time | Simple check | icmppingsec |
Triggers
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Ubiquiti AirOS: High memory utilization | The system is running out of free memory. |
min(/Ubiquiti AirOS by SNMP/vm.memory.util[memoryUsedPercentage],5m)>{$MEMORY.UTIL.MAX} |
Average | |
| Ubiquiti AirOS: Firmware has changed | Firmware version has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#1)<>last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#2) and length(last(/Ubiquiti AirOS by SNMP/system.hw.firmware))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: Host has been restarted | Uptime is less than 10 minutes. |
(last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/Ubiquiti AirOS by SNMP/system.net.uptime[sysUpTime.0])<10m) |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: System name has changed | The name of the system has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.name,#1)<>last(/Ubiquiti AirOS by SNMP/system.name,#2) and length(last(/Ubiquiti AirOS by SNMP/system.name))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: No SNMP data collection | SNMP is not available for polling. Please check device connectivity and SNMP settings. |
max(/Ubiquiti AirOS by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 |
Warning | Depends on:
|
| Ubiquiti AirOS: Unavailable by ICMP ping | Last three attempts returned timeout. Please check device connectivity. |
max(/Ubiquiti AirOS by SNMP/icmpping,#3)=0 |
High | |
| Ubiquiti AirOS: High ICMP ping loss | min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)<100 |
Warning | Depends on:
|
|
| Ubiquiti AirOS: High ICMP ping response time | Average ICMP response time is too high. |
avg(/Ubiquiti AirOS by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} |
Warning | Depends on:
|
LLD rule Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Network interfaces discovery | Discovering interfaces from IF-MIB. |
SNMP agent | net.if.discovery Preprocessing
|
Item prototypes for Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.status[ifOperStatus.{#SNMPINDEX}] |
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in[ifInOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out[ifOutOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.errors[ifInErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.errors[ifOutErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.discards[ifOutDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.discards[ifInDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.type[ifType.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.speed[ifSpeed.{#SNMPINDEX}] |
Trigger prototypes for Network interfaces discovery
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): Link down | This trigger expression works as follows: |
{$IFCONTROL:"{#IFNAME}"}=1 and last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#2)) |
Average | Manual close: Yes |
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): High bandwidth usage | The utilization of the network interface is close to its estimated maximum bandwidth. |
(avg(/Ubiquiti AirOS by SNMP/net.if.in[ifInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) or avg(/Ubiquiti AirOS by SNMP/net.if.out[ifOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])) and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): High error rate | It recovers when it is below 80% of the |
min(/Ubiquiti AirOS by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/Ubiquiti AirOS by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): 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(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])<0 and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 and ( last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/Ubiquiti AirOS 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
You can also provide feedback, discuss the template, or ask for help at ZABBIX forums
Ubiquiti AirOS by SNMP
Overview
This template is designed for the effortless deployment of Ubiquiti AirOS monitoring by Zabbix via SNMP and doesn't require any external scripts.
Known issues
- Description: 'UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces'
- version: 'Firmware: BZ.ar7240.v3.7.51.6230.170322.1513'
- device: UBNT UAP-LR
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and other types'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: ifXTable is not provided in IF-MIB. So Interfaces Simple Template is used instead
- version: all above
- device: NanoStation, UAP-LR
Requirements
Zabbix version: 7.0 and higher.
Tested versions
This template has been tested on:
- Ubiquiti AirOS
Configuration
Zabbix should be configured according to the instructions in the Templates out of the box section.
Setup
Refer to the vendor documentation.
Macros used
| Name | Description | Default |
|---|---|---|
| {$MEMORY.UTIL.MAX} | 90 |
|
| {$SNMP.TIMEOUT} | Time interval for the SNMP availability trigger. |
5m |
| {$ICMP_LOSS_WARN} | Warning threshold of ICMP packet loss in %. |
20 |
| {$ICMP_RESPONSE_TIME_WARN} | Warning threshold of the average ICMP response time in seconds. |
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} | ^.* |
|
| {$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 |
|
| {$NET.IF.IFALIAS.MATCHES} | .* |
|
| {$NET.IF.IFALIAS.NOT_MATCHES} | CHANGE_IF_NEEDED |
|
| {$IF.ERRORS.WARN} | 2 |
Items
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Load average (5m avg) | MIB: FROGFOOT-RESOURCES-MIB 5 minute load average of processor load. |
SNMP agent | system.cpu.load.avg5[loadValue.2] Preprocessing
|
| Load average (1m avg) | MIB: FROGFOOT-RESOURCES-MIB 1 minute load average of processor load. |
SNMP agent | system.cpu.load.avg1[loadValue.1] Preprocessing
|
| Load average (15m avg) | MIB: FROGFOOT-RESOURCES-MIB 15 minute load average of processor load. |
SNMP agent | system.cpu.load.avg15[loadValue.3] Preprocessing
|
| Free memory | MIB: FROGFOOT-RESOURCES-MIB |
SNMP agent | vm.memory.free[memFree.0] Preprocessing
|
| Total memory | MIB: FROGFOOT-RESOURCES-MIB The total memory expressed in bytes. |
SNMP agent | vm.memory.total[memTotal.0] Preprocessing
|
| Memory (buffers) | MIB: FROGFOOT-RESOURCES-MIB Memory used by kernel buffers (Buffers in /proc/meminfo). |
SNMP agent | vm.memory.buffers[memBuffer.0] Preprocessing
|
| Memory (cached) | MIB: FROGFOOT-RESOURCES-MIB Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo). |
SNMP agent | vm.memory.cached[memCache.0] Preprocessing
|
| Memory utilization | Memory utilization in %. |
Calculated | vm.memory.util[memoryUsedPercentage] |
| Hardware model name | MIB: IEEE802dot11-MIB A printable string used to identify the manufacturer's product name of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.model Preprocessing
|
| Firmware version | MIB: IEEE802dot11-MIB Printable string used to identify the manufacturer's product version of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.firmware Preprocessing
|
| Uptime (network) | MIB: SNMPv2-MIB 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
|
| 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
|
| SNMP traps (fallback) | The item is used to collect all SNMP traps unmatched by other snmptrap items |
SNMP trap | snmptrap.fallback |
| System location | MIB: SNMPv2-MIB Physical location of the node (e.g., |
SNMP agent | system.location[sysLocation.0] Preprocessing
|
| 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
|
| 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 |
SNMP agent | system.objectid[sysObjectID.0] Preprocessing
|
| 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
|
| 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
|
| SNMP agent availability | Availability of SNMP checks on the host. The value of this item corresponds to availability icons in the host list. Possible values: 0 - not available 1 - available 2 - unknown |
Zabbix internal | zabbix[host,snmp,available] |
| ICMP ping | The host accessibility by ICMP ping. 0 - ICMP ping fails; 1 - ICMP ping successful. |
Simple check | icmpping |
| ICMP loss | The percentage of lost packets. |
Simple check | icmppingloss |
| ICMP response time | The ICMP ping response time (in seconds). |
Simple check | icmppingsec |
Triggers
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Ubiquiti AirOS: High memory utilization | The system is running out of free memory. |
min(/Ubiquiti AirOS by SNMP/vm.memory.util[memoryUsedPercentage],5m)>{$MEMORY.UTIL.MAX} |
Average | |
| Ubiquiti AirOS: Firmware has changed | Firmware version has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#1)<>last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#2) and length(last(/Ubiquiti AirOS by SNMP/system.hw.firmware))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: Host has been restarted | Uptime is less than 10 minutes. |
(last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/Ubiquiti AirOS by SNMP/system.net.uptime[sysUpTime.0])<10m) |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: System name has changed | The name of the system has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.name,#1)<>last(/Ubiquiti AirOS by SNMP/system.name,#2) and length(last(/Ubiquiti AirOS by SNMP/system.name))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: No SNMP data collection | SNMP is not available for polling. Please check device connectivity and SNMP settings. |
max(/Ubiquiti AirOS by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 |
Warning | Depends on:
|
| Ubiquiti AirOS: Unavailable by ICMP ping | Last three attempts returned timeout. Please check device connectivity. |
max(/Ubiquiti AirOS by SNMP/icmpping,#3)=0 |
High | |
| Ubiquiti AirOS: High ICMP ping loss | ICMP packets loss detected. |
min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)<100 |
Warning | Depends on:
|
| Ubiquiti AirOS: High ICMP ping response time | Average ICMP response time is too high. |
avg(/Ubiquiti AirOS by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} |
Warning | Depends on:
|
LLD rule Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Network interfaces discovery | Discovering interfaces from IF-MIB. |
SNMP agent | net.if.discovery Preprocessing
|
Item prototypes for Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.status[ifOperStatus.{#SNMPINDEX}] |
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in[ifInOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out[ifOutOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.errors[ifInErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.errors[ifOutErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.discards[ifOutDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.discards[ifInDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.type[ifType.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.speed[ifSpeed.{#SNMPINDEX}] |
Trigger prototypes for Network interfaces discovery
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): Link down | This trigger expression works as follows: |
{$IFCONTROL:"{#IFNAME}"}=1 and last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#2)) |
Average | Manual close: Yes |
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): High bandwidth usage | The utilization of the network interface is close to its estimated maximum bandwidth. |
(avg(/Ubiquiti AirOS by SNMP/net.if.in[ifInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) or avg(/Ubiquiti AirOS by SNMP/net.if.out[ifOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])) and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): High error rate | It recovers when it is below 80% of the |
min(/Ubiquiti AirOS by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/Ubiquiti AirOS by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: Interface {#IFNAME}({#IFALIAS}): 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(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])<0 and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 and ( last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/Ubiquiti AirOS 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
You can also provide feedback, discuss the template, or ask for help at ZABBIX forums
Ubiquiti AirOS by SNMP
Overview
This template is designed for the effortless deployment of Ubiquiti AirOS monitoring by Zabbix via SNMP and doesn't require any external scripts.
Known issues
- Description: 'UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces'
- version: 'Firmware: BZ.ar7240.v3.7.51.6230.170322.1513'
- device: UBNT UAP-LR
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and other types'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: ifXTable is not provided in IF-MIB. So Interfaces Simple Template is used instead
- version: all above
- device: NanoStation, UAP-LR
Requirements
Zabbix version: 6.4 and higher.
Tested versions
This template has been tested on:
- Ubiquiti AirOS
Configuration
Zabbix should be configured according to the instructions in the 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} | ^.* |
|
| {$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 |
|
| {$NET.IF.IFALIAS.MATCHES} | .* |
|
| {$NET.IF.IFALIAS.NOT_MATCHES} | CHANGE_IF_NEEDED |
|
| {$IF.ERRORS.WARN} | 2 |
Items
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Ubiquiti AirOS: CPU utilization | MIB: FROGFOOT-RESOURCES-MIB 5 minute load average of processor load. |
SNMP agent | system.cpu.util[loadValue.2] |
| Ubiquiti AirOS: Free memory | MIB: FROGFOOT-RESOURCES-MIB |
SNMP agent | vm.memory.free[memFree.0] Preprocessing
|
| Ubiquiti AirOS: Total memory | MIB: FROGFOOT-RESOURCES-MIB The total memory expressed in bytes. |
SNMP agent | vm.memory.total[memTotal.0] Preprocessing
|
| Ubiquiti AirOS: Memory (buffers) | MIB: FROGFOOT-RESOURCES-MIB Memory used by kernel buffers (Buffers in /proc/meminfo). |
SNMP agent | vm.memory.buffers[memBuffer.0] Preprocessing
|
| Ubiquiti AirOS: Memory (cached) | MIB: FROGFOOT-RESOURCES-MIB Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo). |
SNMP agent | vm.memory.cached[memCache.0] Preprocessing
|
| Ubiquiti AirOS: Memory utilization | Memory utilization in %. |
Calculated | vm.memory.util[memoryUsedPercentage] |
| Ubiquiti AirOS: Hardware model name | MIB: IEEE802dot11-MIB A printable string used to identify the manufacturer's product name of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.model Preprocessing
|
| Ubiquiti AirOS: Firmware version | MIB: IEEE802dot11-MIB Printable string used to identify the manufacturer's product version of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.firmware Preprocessing
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: SNMP traps (fallback) | The item is used to collect all SNMP traps unmatched by other snmptrap items |
SNMP trap | snmptrap.fallback |
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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 |
SNMP agent | system.objectid[sysObjectID.0] Preprocessing
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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] |
| Ubiquiti AirOS: ICMP ping | Simple check | icmpping | |
| Ubiquiti AirOS: ICMP loss | Simple check | icmppingloss | |
| Ubiquiti AirOS: ICMP response time | Simple check | icmppingsec |
Triggers
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Ubiquiti AirOS: High CPU utilization | The CPU utilization is too high. The system might be slow to respond. |
min(/Ubiquiti AirOS by SNMP/system.cpu.util[loadValue.2],5m)>{$CPU.UTIL.CRIT} |
Warning | |
| Ubiquiti AirOS: High memory utilization | The system is running out of free memory. |
min(/Ubiquiti AirOS by SNMP/vm.memory.util[memoryUsedPercentage],5m)>{$MEMORY.UTIL.MAX} |
Average | |
| Ubiquiti AirOS: Firmware has changed | Firmware version has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#1)<>last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#2) and length(last(/Ubiquiti AirOS by SNMP/system.hw.firmware))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: Host has been restarted | Uptime is less than 10 minutes. |
(last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/Ubiquiti AirOS by SNMP/system.net.uptime[sysUpTime.0])<10m) |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: System name has changed | The name of the system has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.name,#1)<>last(/Ubiquiti AirOS by SNMP/system.name,#2) and length(last(/Ubiquiti AirOS by SNMP/system.name))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: No SNMP data collection | SNMP is not available for polling. Please check device connectivity and SNMP settings. |
max(/Ubiquiti AirOS by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 |
Warning | Depends on:
|
| Ubiquiti AirOS: Unavailable by ICMP ping | Last three attempts returned timeout. Please check device connectivity. |
max(/Ubiquiti AirOS by SNMP/icmpping,#3)=0 |
High | |
| Ubiquiti AirOS: High ICMP ping loss | min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)<100 |
Warning | Depends on:
|
|
| Ubiquiti AirOS: High ICMP ping response time | avg(/Ubiquiti AirOS by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} |
Warning | Depends on:
|
LLD rule Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Network interfaces discovery | Discovering interfaces from IF-MIB. |
SNMP agent | net.if.discovery Preprocessing
|
Item prototypes for Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.status[ifOperStatus.{#SNMPINDEX}] |
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in[ifInOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out[ifOutOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.errors[ifInErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.errors[ifOutErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.discards[ifOutDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.discards[ifInDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.type[ifType.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.speed[ifSpeed.{#SNMPINDEX}] |
Trigger prototypes for Network interfaces discovery
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Interface {#IFNAME}({#IFALIAS}): Link down | This trigger expression works as follows: |
{$IFCONTROL:"{#IFNAME}"}=1 and last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#2)) |
Average | Manual close: Yes |
| Interface {#IFNAME}({#IFALIAS}): High bandwidth usage | The utilization of the network interface is close to its estimated maximum bandwidth. |
(avg(/Ubiquiti AirOS by SNMP/net.if.in[ifInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) or avg(/Ubiquiti AirOS by SNMP/net.if.out[ifOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])) and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 |
Warning | Manual close: Yes Depends on:
|
| Interface {#IFNAME}({#IFALIAS}): High error rate | It recovers when it is below 80% of the |
min(/Ubiquiti AirOS by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/Ubiquiti AirOS by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} |
Warning | Manual close: Yes Depends on:
|
| Interface {#IFNAME}({#IFALIAS}): 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(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])<0 and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 and ( last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/Ubiquiti AirOS 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
You can also provide feedback, discuss the template, or ask for help at ZABBIX forums
Ubiquiti AirOS by SNMP
Overview
For Zabbix version: 6.2 and higher.
Setup
Refer to the vendor documentation.
Zabbix configuration
No specific Zabbix configuration is required.
Macros used
| Name | Description | Default |
|---|---|---|
| {$CPU.UTIL.CRIT} | - |
90 |
| {$ICMP_LOSS_WARN} | - |
20 |
| {$ICMP_RESPONSE_TIME_WARN} | - |
0.15 |
| {$IF.ERRORS.WARN} | - |
2 |
| {$IF.UTIL.MAX} | - |
95 |
| {$IFCONTROL} | - |
1 |
| {$MEMORY.UTIL.MAX} | - |
90 |
| {$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.IFNAME.MATCHES} | - |
^.*$ |
| {$NET.IF.IFNAME.NOT_MATCHES} | Filter out loopbacks, nulls, docker veth links and docker0 bridge by default |
`(^Software Loopback Interface |
| {$NET.IF.IFOPERSTATUS.MATCHES} | - |
^.*$ |
| {$NET.IF.IFOPERSTATUS.NOT_MATCHES} | Ignore notPresent(6) |
^6$ |
| {$NET.IF.IFTYPE.MATCHES} | - |
.* |
| {$NET.IF.IFTYPE.NOT_MATCHES} | - |
CHANGE_IF_NEEDED |
| {$SNMP.TIMEOUT} | - |
5m |
Template links
There are no template links in this template.
Discovery rules
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Network interfaces discovery | Discovering interfaces from IF-MIB. |
SNMP | net.if.discovery Filter: AND- {#IFADMINSTATUS} MATCHES_REGEX - {#IFADMINSTATUS} NOT_MATCHES_REGEX - {#IFOPERSTATUS} MATCHES_REGEX - {#IFOPERSTATUS} NOT_MATCHES_REGEX - {#IFNAME} MATCHES_REGEX - {#IFNAME} NOT_MATCHES_REGEX - {#IFDESCR} MATCHES_REGEX - {#IFDESCR} NOT_MATCHES_REGEX - {#IFTYPE} MATCHES_REGEX - {#IFTYPE} NOT_MATCHES_REGEX |
Items collected
| Group | Name | Description | Type | Key and additional info |
|---|---|---|---|---|
| CPU | CPU utilization | MIB: FROGFOOT-RESOURCES-MIB 5 minute load average of processor load. |
SNMP | system.cpu.util[loadValue.2] |
| General | SNMP traps (fallback) | The item is used to collect all SNMP traps unmatched by other snmptrap items |
SNMP_TRAP | snmptrap.fallback |
| General | 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 | system.location[sysLocation.0] Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| General | 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 | system.contact[sysContact.0] Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| General | 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 |
SNMP | system.objectid[sysObjectID.0] Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| General | 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 | system.name Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| General | 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 | system.descr[sysDescr.0] Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| Inventory | Hardware model name | MIB: IEEE802dot11-MIB A printable string used to identify the manufacturer's product name of the resource. Maximum string length is 128 octets. |
SNMP | system.hw.model Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| Inventory | Firmware version | MIB: IEEE802dot11-MIB Printable string used to identify the manufacturer's product version of the resource. Maximum string length is 128 octets. |
SNMP | system.hw.firmware Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| Memory | Free memory | MIB: FROGFOOT-RESOURCES-MIB |
SNMP | vm.memory.free[memFree.0] Preprocessing: - MULTIPLIER: |
| Memory | Total memory | MIB: FROGFOOT-RESOURCES-MIB Total memory in Bytes. |
SNMP | vm.memory.total[memTotal.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory (buffers) | MIB: FROGFOOT-RESOURCES-MIB Memory used by kernel buffers (Buffers in /proc/meminfo). |
SNMP | vm.memory.buffers[memBuffer.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory (cached) | MIB: FROGFOOT-RESOURCES-MIB Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo). |
SNMP | vm.memory.cached[memCache.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory utilization | Memory utilization in %. |
CALCULATED | vm.memory.util[memoryUsedPercentage] Expression: (last(//vm.memory.total[memTotal.0])-(last(//vm.memory.free[memFree.0])+last(//vm.memory.buffers[memBuffer.0])+last(//vm.memory.cached[memCache.0])))/last(//vm.memory.total[memTotal.0])*100 |
| Network interfaces | 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. |
SNMP | net.if.status[ifOperStatus.{#SNMPINDEX}] |
| Network interfaces | 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 atother times as indicated by the value of ifCounterDiscontinuityTime. |
SNMP | net.if.in[ifInOctets.{#SNMPINDEX}] Preprocessing: - CHANGE_PER_SECOND - MULTIPLIER: |
| Network interfaces | 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. |
SNMP | net.if.out[ifOutOctets.{#SNMPINDEX}] Preprocessing: - CHANGE_PER_SECOND - MULTIPLIER: |
| Network interfaces | 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. |
SNMP | net.if.in.errors[ifInErrors.{#SNMPINDEX}] Preprocessing: - CHANGE_PER_SECOND |
| Network interfaces | 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. |
SNMP | net.if.out.errors[ifOutErrors.{#SNMPINDEX}] Preprocessing: - CHANGE_PER_SECOND |
| Network interfaces | 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. |
SNMP | net.if.out.discards[ifOutDiscards.{#SNMPINDEX}] Preprocessing: - CHANGE_PER_SECOND |
| Network interfaces | 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. |
SNMP | net.if.in.discards[ifInDiscards.{#SNMPINDEX}] Preprocessing: - CHANGE_PER_SECOND |
| Network interfaces | 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. |
SNMP | net.if.type[ifType.{#SNMPINDEX}] Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| Network interfaces | 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. |
SNMP | net.if.speed[ifSpeed.{#SNMPINDEX}] |
| Status | 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 | system.net.uptime[sysUpTime.0] Preprocessing: - MULTIPLIER: |
| Status | 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 | system.hw.uptime[hrSystemUptime.0] Preprocessing: - CHECK_NOT_SUPPORTED ⛔️ON_FAIL: - MULTIPLIER: |
| Status | 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 |
INTERNAL | zabbix[host,snmp,available] |
| Status | ICMP ping | - |
SIMPLE | icmpping |
| Status | ICMP loss | - |
SIMPLE | icmppingloss |
| Status | ICMP response time | - |
SIMPLE | icmppingsec |
Triggers
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| High CPU utilization | CPU utilization is too high. The system might be slow to respond. |
min(/Ubiquiti AirOS by SNMP/system.cpu.util[loadValue.2],5m)>{$CPU.UTIL.CRIT} |
WARNING | |
| System name has changed | System name has changed. Ack to close. |
last(/Ubiquiti AirOS by SNMP/system.name,#1)<>last(/Ubiquiti AirOS by SNMP/system.name,#2) and length(last(/Ubiquiti AirOS by SNMP/system.name))>0 |
INFO | Manual close: YES |
| Firmware has changed | Firmware version has changed. Ack to close |
last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#1)<>last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#2) and length(last(/Ubiquiti AirOS by SNMP/system.hw.firmware))>0 |
INFO | Manual close: YES |
| High memory utilization | The system is running out of free memory. |
min(/Ubiquiti AirOS by SNMP/vm.memory.util[memoryUsedPercentage],5m)>{$MEMORY.UTIL.MAX} |
AVERAGE | |
| Interface {#IFDESCR}: Link down | This trigger expression works as follows: 1. Can be triggered if operations status is down. 2. {$IFCONTROL:"{#IFNAME}"}=1 - 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) - trigger fires only if operational status was up(1) sometime before. (So, do not fire 'ethernal off' interfaces.) WARNING: if closed manually - won't fire again on next poll, because of .diff. |
{$IFCONTROL:"{#IFNAME}"}=1 and last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#2))Recovery expression: last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])<>2 or {$IFCONTROL:"{#IFNAME}"}=0 |
AVERAGE | Manual close: YES |
| Interface {#IFDESCR}: High bandwidth usage | The network interface utilization is close to its estimated maximum bandwidth. |
(avg(/Ubiquiti AirOS by SNMP/net.if.in[ifInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) or avg(/Ubiquiti AirOS by SNMP/net.if.out[ifOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])) and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0Recovery expression: avg(/Ubiquiti AirOS by SNMP/net.if.in[ifInOctets.{#SNMPINDEX}],15m)<(({$IF.UTIL.MAX:"{#IFNAME}"}-3)/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) and avg(/Ubiquiti AirOS by SNMP/net.if.out[ifOutOctets.{#SNMPINDEX}],15m)<(({$IF.UTIL.MAX:"{#IFNAME}"}-3)/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) |
WARNING | Manual close: YES Depends on: - Interface {#IFDESCR}: Link down |
| Interface {#IFDESCR}: High error rate | Recovers when below 80% of {$IF.ERRORS.WARN:"{#IFNAME}"} threshold |
min(/Ubiquiti AirOS by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/Ubiquiti AirOS by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"}Recovery expression: max(/Ubiquiti AirOS by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)<{$IF.ERRORS.WARN:"{#IFNAME}"}*0.8 and max(/Ubiquiti AirOS by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)<{$IF.ERRORS.WARN:"{#IFNAME}"}*0.8 |
WARNING | Manual close: YES Depends on: - Interface {#IFDESCR}: Link down |
| 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. Ack to close. |
change(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])<0 and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 and ( last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])<>2) Recovery expression: (change(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}],#2)>0) or (last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2) |
INFO | Manual close: YES Depends on: - Interface {#IFDESCR}: Link down |
| Host has been restarted | Uptime is less than 10 minutes. |
(last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/Ubiquiti AirOS by SNMP/system.net.uptime[sysUpTime.0])<10m) |
WARNING | Manual close: YES Depends on: - No SNMP data collection |
| No SNMP data collection | SNMP is not available for polling. Please check device connectivity and SNMP settings. |
max(/Ubiquiti AirOS by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 |
WARNING | Depends on: - Unavailable by ICMP ping |
| Unavailable by ICMP ping | Last three attempts returned timeout. Please check device connectivity. |
max(/Ubiquiti AirOS by SNMP/icmpping,#3)=0 |
HIGH | |
| High ICMP ping loss | - |
min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)<100 |
WARNING | Depends on: - Unavailable by ICMP ping |
| High ICMP ping response time | - |
avg(/Ubiquiti AirOS by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} |
WARNING | Depends on: - High ICMP ping loss - Unavailable by ICMP ping |
Feedback
Please report any issues with the template at https://support.zabbix.com.
Known Issues
-
Description: UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces
- Version: Firmware: BZ.ar7240.v3.7.51.6230.170322.1513
- Device: UBNT UAP-LR
-
Description: UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces
- Version: Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836
- Device: NanoStation M5
-
Description: UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and other types
- Version: Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836
- Device: NanoStation M5
-
Description: ifXTable is not provided in IF-MIB. So Interfaces Simple Template is used instead
- Version: all above
- Device: NanoStation, UAP-LR
Ubiquiti AirOS by SNMP
Overview
This template is designed for the effortless deployment of Ubiquiti AirOS monitoring by Zabbix via SNMP and doesn't require any external scripts.
Known issues
- Description: 'UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces'
- version: 'Firmware: BZ.ar7240.v3.7.51.6230.170322.1513'
- device: UBNT UAP-LR
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: 'UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and other types'
- version: 'Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836'
- device: NanoStation M5
- Description: ifXTable is not provided in IF-MIB. So Interfaces Simple Template is used instead
- version: all above
- device: NanoStation, UAP-LR
Requirements
Zabbix version: 6.0 and higher.
Tested versions
This template has been tested on:
- Ubiquiti AirOS
Configuration
Zabbix should be configured according to the instructions in the 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} | ^.* |
|
| {$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 |
|
| {$NET.IF.IFALIAS.MATCHES} | .* |
|
| {$NET.IF.IFALIAS.NOT_MATCHES} | CHANGE_IF_NEEDED |
|
| {$IF.ERRORS.WARN} | 2 |
Items
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Ubiquiti AirOS: CPU utilization | MIB: FROGFOOT-RESOURCES-MIB 5 minute load average of processor load. |
SNMP agent | system.cpu.util[loadValue.2] |
| Ubiquiti AirOS: Free memory | MIB: FROGFOOT-RESOURCES-MIB |
SNMP agent | vm.memory.free[memFree.0] Preprocessing
|
| Ubiquiti AirOS: Total memory | MIB: FROGFOOT-RESOURCES-MIB The total memory expressed in bytes. |
SNMP agent | vm.memory.total[memTotal.0] Preprocessing
|
| Ubiquiti AirOS: Memory (buffers) | MIB: FROGFOOT-RESOURCES-MIB Memory used by kernel buffers (Buffers in /proc/meminfo). |
SNMP agent | vm.memory.buffers[memBuffer.0] Preprocessing
|
| Ubiquiti AirOS: Memory (cached) | MIB: FROGFOOT-RESOURCES-MIB Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo). |
SNMP agent | vm.memory.cached[memCache.0] Preprocessing
|
| Ubiquiti AirOS: Memory utilization | Memory utilization in %. |
Calculated | vm.memory.util[memoryUsedPercentage] |
| Ubiquiti AirOS: Hardware model name | MIB: IEEE802dot11-MIB A printable string used to identify the manufacturer's product name of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.model Preprocessing
|
| Ubiquiti AirOS: Firmware version | MIB: IEEE802dot11-MIB Printable string used to identify the manufacturer's product version of the resource. Maximum string length is 128 octets. |
SNMP agent | system.hw.firmware Preprocessing
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: SNMP traps (fallback) | The item is used to collect all SNMP traps unmatched by other snmptrap items |
SNMP trap | snmptrap.fallback |
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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 |
SNMP agent | system.objectid[sysObjectID.0] Preprocessing
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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
|
| Ubiquiti AirOS: 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] |
| Ubiquiti AirOS: ICMP ping | Simple check | icmpping | |
| Ubiquiti AirOS: ICMP loss | Simple check | icmppingloss | |
| Ubiquiti AirOS: ICMP response time | Simple check | icmppingsec |
Triggers
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Ubiquiti AirOS: High CPU utilization | The CPU utilization is too high. The system might be slow to respond. |
min(/Ubiquiti AirOS by SNMP/system.cpu.util[loadValue.2],5m)>{$CPU.UTIL.CRIT} |
Warning | |
| Ubiquiti AirOS: High memory utilization | The system is running out of free memory. |
min(/Ubiquiti AirOS by SNMP/vm.memory.util[memoryUsedPercentage],5m)>{$MEMORY.UTIL.MAX} |
Average | |
| Ubiquiti AirOS: Firmware has changed | Firmware version has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#1)<>last(/Ubiquiti AirOS by SNMP/system.hw.firmware,#2) and length(last(/Ubiquiti AirOS by SNMP/system.hw.firmware))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: Host has been restarted | Uptime is less than 10 minutes. |
(last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/Ubiquiti AirOS by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/Ubiquiti AirOS by SNMP/system.net.uptime[sysUpTime.0])<10m) |
Warning | Manual close: Yes Depends on:
|
| Ubiquiti AirOS: System name has changed | The name of the system has changed. Acknowledge to close the problem manually. |
last(/Ubiquiti AirOS by SNMP/system.name,#1)<>last(/Ubiquiti AirOS by SNMP/system.name,#2) and length(last(/Ubiquiti AirOS by SNMP/system.name))>0 |
Info | Manual close: Yes |
| Ubiquiti AirOS: No SNMP data collection | SNMP is not available for polling. Please check device connectivity and SNMP settings. |
max(/Ubiquiti AirOS by SNMP/zabbix[host,snmp,available],{$SNMP.TIMEOUT})=0 |
Warning | Depends on:
|
| Ubiquiti AirOS: Unavailable by ICMP ping | Last three attempts returned timeout. Please check device connectivity. |
max(/Ubiquiti AirOS by SNMP/icmpping,#3)=0 |
High | |
| Ubiquiti AirOS: High ICMP ping loss | min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/Ubiquiti AirOS by SNMP/icmppingloss,5m)<100 |
Warning | Depends on:
|
|
| Ubiquiti AirOS: High ICMP ping response time | avg(/Ubiquiti AirOS by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} |
Warning | Depends on:
|
LLD rule Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Network interfaces discovery | Discovering interfaces from IF-MIB. |
SNMP agent | net.if.discovery Preprocessing
|
Item prototypes for Network interfaces discovery
| Name | Description | Type | Key and additional info |
|---|---|---|---|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.status[ifOperStatus.{#SNMPINDEX}] |
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in[ifInOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out[ifOutOctets.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.errors[ifInErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.errors[ifOutErrors.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.out.discards[ifOutDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.in.discards[ifInDiscards.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.type[ifType.{#SNMPINDEX}] Preprocessing
|
| Interface {#IFNAME}({#IFALIAS}): 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. |
SNMP agent | net.if.speed[ifSpeed.{#SNMPINDEX}] |
Trigger prototypes for Network interfaces discovery
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| Interface {#IFNAME}({#IFALIAS}): Link down | This trigger expression works as follows: |
{$IFCONTROL:"{#IFNAME}"}=1 and last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/Ubiquiti AirOS by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#2)) |
Average | Manual close: Yes |
| Interface {#IFNAME}({#IFALIAS}): High bandwidth usage | The utilization of the network interface is close to its estimated maximum bandwidth. |
(avg(/Ubiquiti AirOS by SNMP/net.if.in[ifInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}]) or avg(/Ubiquiti AirOS by SNMP/net.if.out[ifOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])) and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 |
Warning | Manual close: Yes Depends on:
|
| Interface {#IFNAME}({#IFALIAS}): High error rate | It recovers when it is below 80% of the |
min(/Ubiquiti AirOS by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/Ubiquiti AirOS by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} |
Warning | Manual close: Yes Depends on:
|
| Interface {#IFNAME}({#IFALIAS}): 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(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])<0 and last(/Ubiquiti AirOS by SNMP/net.if.speed[ifSpeed.{#SNMPINDEX}])>0 and ( last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/Ubiquiti AirOS by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/Ubiquiti AirOS 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
You can also provide feedback, discuss the template, or ask for help at ZABBIX forums
Ubiquiti AirOS SNMP
Overview
For Zabbix version: 5.4 and higher
Setup
Refer to the vendor documentation.
Zabbix configuration
No specific Zabbix configuration is required.
Macros used
| Name | Description | Default |
|---|---|---|
| {$CPU.UTIL.CRIT} | - |
90 |
| {$MEMORY.UTIL.MAX} | - |
90 |
Template links
| Name |
|---|
| Generic SNMP |
| Interfaces Simple SNMP |
Discovery rules
Items collected
| Group | Name | Description | Type | Key and additional info |
|---|---|---|---|---|
| CPU | CPU utilization | MIB: FROGFOOT-RESOURCES-MIB 5 minute load average of processor load. |
SNMP | system.cpu.util[loadValue.2] |
| Inventory | Hardware model name | MIB: IEEE802dot11-MIB A printable string used to identify the manufacturer's product name of the resource. Maximum string length is 128 octets. |
SNMP | system.hw.model Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| Inventory | Firmware version | MIB: IEEE802dot11-MIB Printable string used to identify the manufacturer's product version of the resource. Maximum string length is 128 octets. |
SNMP | system.hw.firmware Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| Memory | Free memory | MIB: FROGFOOT-RESOURCES-MIB |
SNMP | vm.memory.free[memFree.0] Preprocessing: - MULTIPLIER: |
| Memory | Total memory | MIB: FROGFOOT-RESOURCES-MIB Total memory in Bytes |
SNMP | vm.memory.total[memTotal.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory (buffers) | MIB: FROGFOOT-RESOURCES-MIB Memory used by kernel buffers (Buffers in /proc/meminfo) |
SNMP | vm.memory.buffers[memBuffer.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory (cached) | MIB: FROGFOOT-RESOURCES-MIB Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo) |
SNMP | vm.memory.cached[memCache.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory utilization | Memory utilization in % |
CALCULATED | vm.memory.util[memoryUsedPercentage] Expression: (last(//vm.memory.total[memTotal.0])-(last(//vm.memory.free[memFree.0])+last(//vm.memory.buffers[memBuffer.0])+last(//vm.memory.cached[memCache.0])))/last(//vm.memory.total[memTotal.0])*100 |
Triggers
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| High CPU utilization (over {$CPU.UTIL.CRIT}% for 5m) | CPU utilization is too high. The system might be slow to respond. |
min(/Ubiquiti AirOS SNMP/system.cpu.util[loadValue.2],5m)>{$CPU.UTIL.CRIT} |
WARNING | |
| Firmware has changed | Firmware version has changed. Ack to close |
last(/Ubiquiti AirOS SNMP/system.hw.firmware,#1)<>last(/Ubiquiti AirOS SNMP/system.hw.firmware,#2) and length(last(/Ubiquiti AirOS SNMP/system.hw.firmware))>0 |
INFO | Manual close: YES |
| High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m) | The system is running out of free memory. |
min(/Ubiquiti AirOS SNMP/vm.memory.util[memoryUsedPercentage],5m)>{$MEMORY.UTIL.MAX} |
AVERAGE |
Feedback
Please report any issues with the template at https://support.zabbix.com
Known Issues
-
Description: UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces
- Version: Firmware: BZ.ar7240.v3.7.51.6230.170322.1513
- Device: UBNT UAP-LR
-
Description: UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces
- Version: Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836
- Device: NanoStation M5
-
Description: UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and other types
- Version: Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836
- Device: NanoStation M5
-
Description: ifXTable is not provided in IF-MIB. So Interfaces Simple Template is used instead
- Version: all above
- Device: NanoStation, UAP-LR
Template Net Ubiquiti AirOS SNMP
Overview
For Zabbix version: 5.0 and higher
Setup
Refer to the vendor documentation.
Zabbix configuration
No specific Zabbix configuration is required.
Macros used
| Name | Description | Default |
|---|---|---|
| {$CPU.UTIL.CRIT} | - |
90 |
| {$MEMORY.UTIL.MAX} | - |
90 |
Template links
| Name |
|---|
| Generic SNMP |
| Interfaces Simple SNMP |
Discovery rules
Items collected
| Group | Name | Description | Type | Key and additional info |
|---|---|---|---|---|
| CPU | CPU utilization | MIB: FROGFOOT-RESOURCES-MIB 5 minute load average of processor load. |
SNMP | system.cpu.util[loadValue.2] |
| Inventory | Hardware model name | MIB: IEEE802dot11-MIB A printable string used to identify the manufacturer's product name of the resource. Maximum string length is 128 octets. |
SNMP | system.hw.model Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| Inventory | Firmware version | MIB: IEEE802dot11-MIB Printable string used to identify the manufacturer's product version of the resource. Maximum string length is 128 octets. |
SNMP | system.hw.firmware Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: |
| Memory | Free memory | MIB: FROGFOOT-RESOURCES-MIB |
SNMP | vm.memory.free[memFree.0] Preprocessing: - MULTIPLIER: |
| Memory | Total memory | MIB: FROGFOOT-RESOURCES-MIB Total memory in Bytes |
SNMP | vm.memory.total[memTotal.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory (buffers) | MIB: FROGFOOT-RESOURCES-MIB Memory used by kernel buffers (Buffers in /proc/meminfo) |
SNMP | vm.memory.buffers[memBuffer.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory (cached) | MIB: FROGFOOT-RESOURCES-MIB Memory used by the page cache and slabs (Cached and Slab in /proc/meminfo) |
SNMP | vm.memory.cached[memCache.0] Preprocessing: - MULTIPLIER: |
| Memory | Memory utilization | Memory utilization in % |
CALCULATED | vm.memory.util[memoryUsedPercentage] Expression: (last("vm.memory.total[memTotal.0]")-(last("vm.memory.free[memFree.0]")+last("vm.memory.buffers[memBuffer.0]")+last("vm.memory.cached[memCache.0]")))/last("vm.memory.total[memTotal.0]")*100 |
Triggers
| Name | Description | Expression | Severity | Dependencies and additional info |
|---|---|---|---|---|
| High CPU utilization (over {$CPU.UTIL.CRIT}% for 5m) | CPU utilization is too high. The system might be slow to respond. |
{TEMPLATE_NAME:system.cpu.util[loadValue.2].min(5m)}>{$CPU.UTIL.CRIT} |
WARNING | |
| Firmware has changed | Firmware version has changed. Ack to close |
{TEMPLATE_NAME:system.hw.firmware.diff()}=1 and {TEMPLATE_NAME:system.hw.firmware.strlen()}>0 |
INFO | Manual close: YES |
| High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m) | The system is running out of free memory. |
{TEMPLATE_NAME:vm.memory.util[memoryUsedPercentage].min(5m)}>{$MEMORY.UTIL.MAX} |
AVERAGE |
Feedback
Please report any issues with the template at https://support.zabbix.com
Known Issues
-
Description: UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces
- Version: Firmware: BZ.ar7240.v3.7.51.6230.170322.1513
- Device: UBNT UAP-LR
-
Description: UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces
- Version: Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836
- Device: NanoStation M5
-
Description: UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and other types
- Version: Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836
- Device: NanoStation M5
-
Description: ifXTable is not provided in IF-MIB. So Interfaces Simple Template is used instead
- Version: all above
- Device: NanoStation, UAP-LR
Vendor and Community integrations are created by third parties and are not verified by Zabbix. Zabbix is not responsible for their functionality or quality.
Zabbix community templates
16 Contributed to the zabbix/community-templates repositoryMIBs used: IF-MIB SNMPv2-MIB UCD-SNMP-MIB UI-MIB Validated on UAP-AC-Lite firmware 6.8.2.15592 with Zabbix 7.4. Numeric OIDs are used, so MIB files are not required on the Zabbix server.
unifi zabbix snmpv3based on Alex Mouras work.Ubiquity Controller > Settings > Services > SNMP v3 > enable, set username and passwortZabbix > Macro >{$SNMP_USERNAME}
This template monitors Ubiquiti UniFi Security Gateway (USG), UniFi Dream Machine (UDM), and EdgeRouter series devices using SNMPv2. It provides metrics on system health, interfaces, CPU, memory, active sessions, and basic traffic statistics.
Template para Ubiquiti Unifi AP e Wifi
MIBs used: FROGFOOT-RESOURCES-MIB HOST-RESOURCES-MIB SNMPv2-MIB IEEE802dot11-MIB IF-MIB Known Issues: Description: UBNT unifi reports speed: like IF-MIB::ifSpeed.1 = Gauge32: 4294967295 for all interfaces Version: Firmware: BZ.ar7240.v3.7.51.6230.170322.1513 Device: UBNT UAP-LR Description: UBNT AirMax(NanoStation, NanoBridge etc) reports ifSpeed: as 0 for VLAN and wireless(ath0) interfaces Version: Firmware: XW.ar934x.v5.6-beta4.22359.140521.1836 Device: NanoStation M5 Description: UBNT AirMax(NanoStation, NanoBridge etc) reports always return ifType: as ethernet(6) even for wifi,vlans and
Template monitora as estações conectadas no AP Ubiquiti (testado somente na linha M5) Métricas: Capacidade Airmax CCQ Distancia AP MAC Prioridade Airmax Qualidade Airmax RX Rate Sinal Uptime Tx Rate Author Luís Henrique Nascimento
This macros are mandatory: - {$UNIFI.IP}: Unifi IP or fqdn - {$UNIFI.USERNAME}: Unifi username - {$UNIFI.PASSWORD}: Unifi password - {$UNIFI.API.AUTH.URI}: change if using unifi controller vm - {$UNIFI.API.AUTH.TOKEN}: change if using unifi controller vm - {$UNIFI.API.URI}: change if using unifi controller vm For security reason create a dedicated zabbix view only user on Unifi.
Explicação detalhada no link do site.Detailed instructions on website link.This template retrieve SNMP data from Unifi AP devices.Model, Firmware Version, Uptime, IP Address, MAC Address, Interface speed, LAN port Speed and real time traffic, CPU Load, CPU usage, WIFI SSIDs, Traffic/SSID, Users/SSID, AP Hostname, Channel Utilization 2G and 3G,Traffic graphics, Users graphics,Triggers: CPU Load, Channel usage.MIBS requirements:FROGFOOT-RESOURCES-MIB . IANAifType-MIB , IF-MIB , SNMP-FRAMEWORK-MIB , SNMPv2-CONF. SNMPv2-MIB, SNMPv2-SMI, SNMPv2-TCUBNT-MIB, UBNT-UniFi-MIBTested on: (LOCAL and PROXY environments)Models tested: UAP, UAP-LR. UAP-LRv2, UAP-AC-LR, UAP-AC-Lite(in progress)Requirements:AP firmware above 3.9.XAP SNMP feature enabledIf you Like let a comment to help me make this template better.Se voce gostou deixe um comentário com sugestões para melhoria do template.
Nesse templete você vai coletaPINGTEMPO DE RESPOSTALATÊNCIACCQESTAÇÃOSINALPORTA LANUPTIMETRAFEGOE-MAIL: [email protected]: (81) 982670619
Adds 2 temperature sensors and 4 PoE temperature sensors for rackmountable Unifi Switches.Tested with Unif Switch 16 POE-150W.Information at 70°C and Warning at 90°C just like Unifi specifies in console output. The temperatures are the ones you can see in the screenshot.
Explicação em Português no link do site.This template retrieve SNMP data from Unifi AP devices.Model, Firmware Version, Uptime, IP Address, MAC Address, LAN port Speed and real time traffic, WIFI SSIDs, Traffic/SSID, Users/SSIDTraffic graphics, Users graphics.MIBS requirements:FROGFOOT-RESOURCES-MIB . IANAifType-MIB , IF-MIB , SNMP-FRAMEWORK-MIB , SNMPv2-CONF. SNMPv2-MIB, SNMPv2-SMI, SNMPv2-TCUBNT-MIB, UBNT-UniFi-MIBTested on: (LOCAL and PROXY environments)Models tested: UAP, UAP LR. UAP AC LR(in progress)Requirements:AP firmware above 3.9.XAP SNMP feature enabledIf you Like let a comment to help me make this template better.Se voce gostou deixe um comentário com sugestões para melhoria do template.
Retorna as informações abaixo:ModeloFrequência WiFiSSIDQuantidade de usuários conectadosVersão Firmware.É necessário habilitar o protocolo SNMP nas antenas.
Zabbix version 5.SNMPv2Items for AP: Wireless Role, Wireless channel bandwidth, Tx power EIRP, Tx modulation, The percentage of total memory usage, The percentage of total CPU usage, The main frequency to use, The MAC address of this device, The list of alternative frequencies, The firmware version running, The device name, The device model, Radio SSID, Radio connected, Packet per second for tx, Packet per second for rx, GPS status, GPS Satellites Visible, GPS Satellites Tracked, GPS Longitude, GPS Latitude, GPS Horizontal Dilution of Precision, GPS Fix Obtained, GPS Altitude (m), GPS Altitude (ft), Ethernet packet per second for tx, Ethernet packet per second for rx, Ethernet Data port plugged, Cable loss, Automatic Tx modulation selection, Antenna gain.Items for CPE discovery: Device Model, Device Name, Distance, Firmware, IdealRxPower0 (ap), IdealRxPower1 (ap), Last IP address, Latency, Registration Attempts, Rx Capacity, RxIdealPower0 (cpe), RxIdealPower1 (cpe), RxPower0 (ap), RxPower0 (cpe), RxPower1 (ap), RxPower1 (cpe), RxPowerLevel0 (ap), RxPowerLevel0 (cpe), RxPowerLevel1 (ap), RxPowerLevel1 (cpe), RxRate, Tx Capacity, TxPower EIRP (cpe), TxRate.Just data retrieval. Template has no triggers, graphs or screens.
Version 1.0This is a template which I use to monitor a point to point Ubiquiti link with two IS‑5AC devices; that´s what I test with.I would think it should work with other AirOS8 devices as well. Perhaps not very well suited for "normal" access points as it creates a graph for every station connected.It discovers the remote station and greates a graph to show noise floor, signal level, RX/TX capacity and the latency.The only trigger in there is when the connection resets; none on disconnect.
This template allows you to quickly get up and running with monitoring of Ubiquiti´s EdgeRouter line of devices. It allows for auto-discovering of network interfaces and automatically applies appropriate triggers for the discovered network interfaces.Please see @ Github (albinbatman/zabbix-edgemax-template)
Community repositories
1 Independent projects on GitHubZabbix SNMP Ubiquiti AirMax Template