Ubiquiti

Ubiquiti Inc. is an American technology company founded in 2003. Ubiquiti manufactures and sells wireless data communication and wired products for enterprises and homes under multiple brand names.

Available solutions




This template is for Zabbix version: 6.4
Also available for: 6.2 6.0 5.4 5.0

Source: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/ubiquiti_airos_snmp?at=release/6.4

Ubiquiti AirOS by SNMP

Overview

For Zabbix version: 6.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
{$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|^NULL[0-9.]*$|^[Ll]o[0-9.]*$|^[Ss]ystem$|^Nu[0-9.]*$|^veth[0-9a-z]+$|docker[0-9]+|br-[a-z0-9]{12})
{$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 {$NET.IF.IFADMINSTATUS.MATCHES}

- {#IFADMINSTATUS} NOT_MATCHES_REGEX {$NET.IF.IFADMINSTATUS.NOT_MATCHES}

- {#IFOPERSTATUS} MATCHES_REGEX {$NET.IF.IFOPERSTATUS.MATCHES}

- {#IFOPERSTATUS} NOT_MATCHES_REGEX {$NET.IF.IFOPERSTATUS.NOT_MATCHES}

- {#IFNAME} MATCHES_REGEX {$NET.IF.IFNAME.MATCHES}

- {#IFNAME} NOT_MATCHES_REGEX {$NET.IF.IFNAME.NOT_MATCHES}

- {#IFDESCR} MATCHES_REGEX {$NET.IF.IFDESCR.MATCHES}

- {#IFDESCR} NOT_MATCHES_REGEX {$NET.IF.IFDESCR.NOT_MATCHES}

- {#IFTYPE} MATCHES_REGEX {$NET.IF.IFTYPE.MATCHES}

- {#IFTYPE} NOT_MATCHES_REGEX {$NET.IF.IFTYPE.NOT_MATCHES}

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.</p> |SNMP |system.location[sysLocation.0]<p>**Preprocessing**:</p><p>- DISCARD_UNCHANGED_HEARTBEAT:12h`

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: 12h

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 determiningwhat kind of box' is being managed. For example, if vendorFlintstones, Inc.' was assigned the subtree1.3.6.1.4.1.4242, it could assign the identifier 1.3.6.1.4.1.4242.1.1 to its Fred Router'.</p> |SNMP |system.objectid[sysObjectID.0]<p>**Preprocessing**:</p><p>- DISCARD_UNCHANGED_HEARTBEAT:12h`

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: 12h

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: 12h

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: 1d

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: 1d

Memory Free memory

MIB: FROGFOOT-RESOURCES-MIB

SNMP vm.memory.free[memFree.0]

Preprocessing:

- MULTIPLIER: 1024

Memory Total memory

MIB: FROGFOOT-RESOURCES-MIB

Total memory in Bytes.

SNMP vm.memory.total[memTotal.0]

Preprocessing:

- MULTIPLIER: 1024

Memory Memory (buffers)

MIB: FROGFOOT-RESOURCES-MIB

Memory used by kernel buffers (Buffers in /proc/meminfo).

SNMP vm.memory.buffers[memBuffer.0]

Preprocessing:

- MULTIPLIER: 1024

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: 1024

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: 8

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: 8

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: 1d

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: 0.01

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: CUSTOM_VALUE -> 0

- MULTIPLIER: 0.01

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}])>0

Recovery 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

Articles and documentation

+ Propose new article

Didn't find what you are looking for?