Huawei

Huawei

Huawei is a Chinese multinational networking, telecommunications equipment, and services company.

Available solutions




This template is for Zabbix version: 7.0

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

Huawei VRP by SNMP

Overview

Reference: https://www.slideshare.net/Huanetwork/huawei-s5700-naming-conventions-and-port-numbering-conventions Reference: http://support.huawei.com/enterprise/KnowledgebaseReadAction.action?contentId=KB1000090234

Requirements

Zabbix version: 7.0 and higher.

Tested versions

This template has been tested on:

  • Huawei VRP

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
{$CPU.UTIL.CRIT} 90
{$TEMP_CRIT} 60
{$TEMP_CRIT_LOW} 5
{$TEMP_WARN} 50
{$FAN_CRIT_STATUS} 2
{$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
{$IF.ERRORS.WARN}

Warning threshold of error packet rate. Can be used with interface name as context.

 2
{$IF.UTIL.MAX} 90
{$IFCONTROL} 1
{$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.IFALIAS.MATCHES} .*
{$NET.IF.IFALIAS.NOT_MATCHES} CHANGE_IF_NEEDED
{$NET.IF.IFTYPE.MATCHES} .*
{$NET.IF.IFTYPE.NOT_MATCHES} CHANGE_IF_NEEDED

Items

Name Description Type Key and additional info
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

  • Custom multiplier: 0.01
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

  • Check for not supported value: any error

    ⛔️Custom on fail: Set value to: 0

  • Custom multiplier: 0.01
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., equipment room, 3rd floor). If not provided, the value is a zero-length string.

 SNMP agent system.location[sysLocation.0]

Preprocessing

  • Discard unchanged with heartbeat: 12h
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

  • Discard unchanged with heartbeat: 12h
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'.

 SNMP agent system.objectid[sysObjectID.0]

Preprocessing

  • Discard unchanged with heartbeat: 12h
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

  • Discard unchanged with heartbeat: 12h
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

  • Discard unchanged with heartbeat: 12h
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
Host has been restarted

Uptime is less than 10 minutes.

 (last(/Huawei VRP by SNMP/system.hw.uptime[hrSystemUptime.0])>0 and last(/Huawei VRP by SNMP/system.hw.uptime[hrSystemUptime.0])<10m) or (last(/Huawei VRP by SNMP/system.hw.uptime[hrSystemUptime.0])=0 and last(/Huawei VRP by SNMP/system.net.uptime[sysUpTime.0])<10m) Warning Manual close: Yes
Depends on:
  • No SNMP data collection
System name has changed

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

 last(/Huawei VRP by SNMP/system.name,#1)<>last(/Huawei VRP by SNMP/system.name,#2) and length(last(/Huawei VRP by SNMP/system.name))>0 Info Manual close: Yes
No SNMP data collection

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

 max(/Huawei VRP 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(/Huawei VRP by SNMP/icmpping,#3)=0 High
High ICMP ping loss min(/Huawei VRP by SNMP/icmppingloss,5m)>{$ICMP_LOSS_WARN} and min(/Huawei VRP by SNMP/icmppingloss,5m)<100 Warning Depends on:
  • Unavailable by ICMP ping
High ICMP ping response time

Average ICMP response time is too high.

 avg(/Huawei VRP by SNMP/icmppingsec,5m)>{$ICMP_RESPONSE_TIME_WARN} Warning Depends on:
  • High ICMP ping loss
  • Unavailable by ICMP ping

LLD rule MPU Discovery

Name Description Type Key and additional info
MPU Discovery

http://support.huawei.com/enterprise/KnowledgebaseReadAction.action?contentId=KB1000090234. Filter limits results to Main Processing Units

 SNMP agent mpu.discovery

Item prototypes for MPU Discovery

Name Description Type Key and additional info
{#ENT_NAME}: CPU utilization

MIB: HUAWEI-ENTITY-EXTENT-MIB

The CPU usage for this entity. Generally, the CPU usage will calculate the overall CPU usage on the entity, and itis not sensible with the number of CPU on the entity.

Reference: http://support.huawei.com/enterprise/KnowledgebaseReadAction.action?contentId=KB1000090234

 SNMP agent system.cpu.util[hwEntityCpuUsage.{#SNMPINDEX}]
{#ENT_NAME}: Memory utilization

MIB: HUAWEI-ENTITY-EXTENT-MIB

The memory usage for the entity. This object indicates what percent of memory are used.

Reference: http://support.huawei.com/enterprise/KnowledgebaseReadAction.action?contentId=KB1000090234

 SNMP agent vm.memory.util[hwEntityMemUsage.{#SNMPINDEX}]
{#ENT_NAME}: Temperature

MIB: HUAWEI-ENTITY-EXTENT-MIB

The temperature for the {#SNMPVALUE}.

 SNMP agent sensor.temp.value[hwEntityTemperature.{#SNMPINDEX}]
{#ENT_NAME}: Hardware serial number

MIB: ENTITY-MIB

 SNMP agent system.hw.serialnumber[entPhysicalSerialNum.{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 1d
{#ENT_NAME}: Hardware version(revision)

MIB: ENTITY-MIB

 SNMP agent system.hw.version[entPhysicalHardwareRev.{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 1d
{#ENT_NAME}: Operating system

MIB: ENTITY-MIB

 SNMP agent system.sw.os[entPhysicalSoftwareRev.{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 1d

Trigger prototypes for MPU Discovery

Name Description Expression Severity Dependencies and additional info
{#ENT_NAME}: High CPU utilization

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

 min(/Huawei VRP by SNMP/system.cpu.util[hwEntityCpuUsage.{#SNMPINDEX}],5m)>{$CPU.UTIL.CRIT} Warning
{#ENT_NAME}: High memory utilization

The system is running out of free memory.

 min(/Huawei VRP by SNMP/vm.memory.util[hwEntityMemUsage.{#SNMPINDEX}],5m)>{$MEMORY.UTIL.MAX} Average
{#ENT_NAME}: Temperature is above warning threshold

This trigger uses temperature sensor values as well as temperature sensor status if available

 avg(/Huawei VRP by SNMP/sensor.temp.value[hwEntityTemperature.{#SNMPINDEX}],5m)>{$TEMP_WARN:"{#ENT_NAME}"} Warning Depends on:
  • {#ENT_NAME}: Temperature is above critical threshold
{#ENT_NAME}: Temperature is above critical threshold

This trigger uses temperature sensor values as well as temperature sensor status if available

 avg(/Huawei VRP by SNMP/sensor.temp.value[hwEntityTemperature.{#SNMPINDEX}],5m)>{$TEMP_CRIT:"{#ENT_NAME}"} High
{#ENT_NAME}: Temperature is too low avg(/Huawei VRP by SNMP/sensor.temp.value[hwEntityTemperature.{#SNMPINDEX}],5m)<{$TEMP_CRIT_LOW:"{#ENT_NAME}"} Average
{#ENT_NAME}: Device has been replaced

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

 last(/Huawei VRP by SNMP/system.hw.serialnumber[entPhysicalSerialNum.{#SNMPINDEX}],#1)<>last(/Huawei VRP by SNMP/system.hw.serialnumber[entPhysicalSerialNum.{#SNMPINDEX}],#2) and length(last(/Huawei VRP by SNMP/system.hw.serialnumber[entPhysicalSerialNum.{#SNMPINDEX}]))>0 Info Manual close: Yes
{#ENT_NAME}: Operating system description has changed

Operating system description has changed. Possible reasons that system has been updated or replaced. Acknowledge to close the problem manually.

 last(/Huawei VRP by SNMP/system.sw.os[entPhysicalSoftwareRev.{#SNMPINDEX}],#1)<>last(/Huawei VRP by SNMP/system.sw.os[entPhysicalSoftwareRev.{#SNMPINDEX}],#2) and length(last(/Huawei VRP by SNMP/system.sw.os[entPhysicalSoftwareRev.{#SNMPINDEX}]))>0 Info Manual close: Yes
Depends on:
  • System name has changed

LLD rule Entity Discovery

Name Description Type Key and additional info
Entity Discovery SNMP agent entity.discovery

Item prototypes for Entity Discovery

Name Description Type Key and additional info
{#ENT_NAME}: Hardware model name

MIB: ENTITY-MIB

 SNMP agent system.hw.model[entPhysicalDescr.{#SNMPINDEX}]

Preprocessing

  • Discard unchanged with heartbeat: 1d

LLD rule FAN Discovery

Name Description Type Key and additional info
FAN Discovery SNMP agent discovery.fans

Item prototypes for FAN Discovery

Name Description Type Key and additional info
#{#SNMPVALUE}: Fan status

MIB: HUAWEI-ENTITY-EXTENT-MIB

 SNMP agent sensor.fan.status[hwEntityFanState.{#SNMPINDEX}]

Trigger prototypes for FAN Discovery

Name Description Expression Severity Dependencies and additional info
#{#SNMPVALUE}: Fan is in critical state

Please check the fan unit

 count(/Huawei VRP by SNMP/sensor.fan.status[hwEntityFanState.{#SNMPINDEX}],#1,"eq","{$FAN_CRIT_STATUS}")=1 Average

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

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. This object is a 64-bit version of ifInOctets. 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[ifHCInOctets.{#SNMPINDEX}]

Preprocessing

  • Change per second

  • Custom multiplier: 8
Interface {#IFNAME}({#IFALIAS}): Bits sent

MIB: IF-MIB

The total number of octets transmitted out of the interface, including framing characters. This object is a 64-bit version of ifOutOctets.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[ifHCOutOctets.{#SNMPINDEX}]

Preprocessing

  • Change per second

  • Custom multiplier: 8
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

  • Change per second
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

  • Change per second
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

  • Change per second
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

  • Change per second
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

  • Discard unchanged with heartbeat: 1d
Interface {#IFNAME}({#IFALIAS}): Speed

MIB: IF-MIB

An estimate of the interface's current bandwidth in units of 1,000,000 bits per second. If this object reports a value of n' then the speed of the interface is somewhere in the range of n-500,000' to`n+499,999'. 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. For a sub-layer which has no concept of bandwidth, this object should be zero.

 SNMP agent net.if.speed[ifHighSpeed.{#SNMPINDEX}]

Preprocessing

  • Custom multiplier: 1000000

  • Discard unchanged with heartbeat: 1h

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:
1. It can be triggered if the operations status is down.
2. {$IFCONTROL:"{#IFNAME}"}=1 - a user can redefine the context macro to "0", marking this interface as not important. No new trigger will be fired if this interface is down.
3. {TEMPLATE_NAME:METRIC.diff()}=1 - the trigger fires only if the operational status was up to (1) sometime before (so, does not fire for "eternal off" interfaces.)

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

 {$IFCONTROL:"{#IFNAME}"}=1 and last(/Huawei VRP by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])=2 and (last(/Huawei VRP by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}],#1)<>last(/Huawei VRP 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(/Huawei VRP by SNMP/net.if.in[ifHCInOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Huawei VRP by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}]) or avg(/Huawei VRP by SNMP/net.if.out[ifHCOutOctets.{#SNMPINDEX}],15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(/Huawei VRP by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}])) and last(/Huawei VRP by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}])>0 Warning Manual close: Yes
Depends on:
  • Interface {#IFNAME}({#IFALIAS}): Link down
Interface {#IFNAME}({#IFALIAS}): High error rate

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

 min(/Huawei VRP by SNMP/net.if.in.errors[ifInErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} or min(/Huawei VRP by SNMP/net.if.out.errors[ifOutErrors.{#SNMPINDEX}],5m)>{$IF.ERRORS.WARN:"{#IFNAME}"} Warning Manual close: Yes
Depends on:
  • Interface {#IFNAME}({#IFALIAS}): Link down
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(/Huawei VRP by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}])<0 and last(/Huawei VRP by SNMP/net.if.speed[ifHighSpeed.{#SNMPINDEX}])>0 and ( last(/Huawei VRP by SNMP/net.if.type[ifType.{#SNMPINDEX}])=6 or last(/Huawei VRP by SNMP/net.if.type[ifType.{#SNMPINDEX}])=7 or last(/Huawei VRP by SNMP/net.if.type[ifType.{#SNMPINDEX}])=11 or last(/Huawei VRP by SNMP/net.if.type[ifType.{#SNMPINDEX}])=62 or last(/Huawei VRP by SNMP/net.if.type[ifType.{#SNMPINDEX}])=69 or last(/Huawei VRP by SNMP/net.if.type[ifType.{#SNMPINDEX}])=117 ) and (last(/Huawei VRP by SNMP/net.if.status[ifOperStatus.{#SNMPINDEX}])<>2) Info Manual close: Yes
Depends on:
  • Interface {#IFNAME}({#IFALIAS}): Link down

LLD rule EtherLike-MIB Discovery

Name Description Type Key and additional info
EtherLike-MIB Discovery

Discovering interfaces from IF-MIB and EtherLike-MIB. Interfaces with up(1) Operational Status are discovered.

 SNMP agent net.if.duplex.discovery

Preprocessing

  • JavaScript: The text is too long. Please see the template.

Item prototypes for EtherLike-MIB Discovery

Name Description Type Key and additional info
Interface {#IFNAME}({#IFALIAS}): Duplex status

MIB: EtherLike-MIB

The current mode of operation of the MAC

entity. 'unknown' indicates that the current

duplex mode could not be determined.

Management control of the duplex mode is

accomplished through the MAU MIB. When

an interface does not support autonegotiation,

or when autonegotiation is not enabled, the

duplex mode is controlled using

ifMauDefaultType. When autonegotiation is

supported and enabled, duplex mode is controlled

using ifMauAutoNegAdvertisedBits. In either

case, the currently operating duplex mode is

reflected both in this object and in ifMauType.

Note that this object provides redundant

information with ifMauType. Normally, redundant

objects are discouraged. However, in this

instance, it allows a management application to

determine the duplex status of an interface

without having to know every possible value of

ifMauType. This was felt to be sufficiently

valuable to justify the redundancy.

Reference: [IEEE 802.3 Std.], 30.3.1.1.32,aDuplexStatus.

 SNMP agent net.if.duplex[dot3StatsDuplexStatus.{#SNMPINDEX}]

Trigger prototypes for EtherLike-MIB Discovery

Name Description Expression Severity Dependencies and additional info
Interface {#IFNAME}({#IFALIAS}): In half-duplex mode

Please check autonegotiation settings and cabling.

 last(/Huawei VRP by SNMP/net.if.duplex[dot3StatsDuplexStatus.{#SNMPINDEX}])=2 Warning Manual close: Yes

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

Articles and documentation

+ Propose new article

Didn't find what you are looking for?

Request custom integration

Zabbix integration team will develop custom integration based on your requirements and Zabbix best practices.

Request

Propose your integration

Have you already developed high quality integration and want to submit to Zabbix integration repository?

Propose