5.02021-11-21T21:39:47ZTemplates/ModulesModule Interfaces Simple SNMPv3Module Interfaces Simple SNMPv3## Description
MIBs used: IF-MIB
## Overview
This is a module based on the "TTemplate Module Interfaces Simple SNMPv2" module. For correct use, you need to define the macro "{$SNMP\_SECNAME\_CONTEXT}", this macro is also used in the rest of my templates using SNMPv3. I do not use authentication and encryption in my templates, which corresponds to security level = noAuthNoPriv
## Author
Alexey Glotkin
Templates/ModulesNetwork InterfacesNetwork Interfaces DiscoverySNMP_AGENTdiscovery[{#SNMPVALUE},1.3.6.1.2.1.2.2.1.8,{#IFADMINSTATUS},1.3.6.1.2.1.2.2.1.7,{#IFALIAS},1.3.6.1.2.1.31.1.1.1.18,{#IFNAME},1.3.6.1.2.1.2.2.1.2,{#IFDESCR},1.3.6.1.2.1.2.2.1.2,{#IFTYPE},1.3.6.1.2.1.2.2.1.3]net.if.discovery3600AND{#IFADMINSTATUS}(1|3)A{#IFNAME}@Network interfaces for discoveryBDiscovering interfaces from IF-MIB. Interfaces with down(2) Administrative Status are not discovered.Interface {#IFDESCR}: Inbound pkts discardedSNMP_AGENT1.3.6.1.2.1.2.2.1.13.{#SNMPINDEX}net.if.in.discards[ifInDiscards.{#SNMPINDEX}]3001wMIB: 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.Network InterfacesCHANGE_PER_SECONDInterface {#IFDESCR}: Inbound non-unicast pktsSNMP_AGENT1.3.6.1.2.1.2.2.1.12.{#SNMPINDEX}net.if.in.discards[ifInNUcastPkts.{#SNMPINDEX}]1801wppsMIB: IF-MIB
The number of non-unicast (i.e., subnetwork- broadcast or subnetwork-multicast) packets delivered to a higher-layer protocol.Network InterfacesCHANGE_PER_SECONDInterface {#IFDESCR}: Inbound unicast pktsSNMP_AGENT1.3.6.1.2.1.2.2.1.11.{#SNMPINDEX}net.if.in.discards[ifInUcastPkts.{#SNMPINDEX}]1801wppsMIB: IF-MIB
The number of subnetwork-unicast packets delivered to a higher-layer protocol.Network InterfacesCHANGE_PER_SECONDInterface {#IFDESCR}: Inbound pkts with errorsSNMP_AGENT1.3.6.1.2.1.2.2.1.14.{#SNMPINDEX}net.if.in.errors[ifInErrors.{#SNMPINDEX}]3001wMIB: 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.Network InterfacesCHANGE_PER_SECONDInterface {#IFDESCR}: Bits receivedSNMP_AGENT1.3.6.1.2.1.2.2.1.10.{#SNMPINDEX}net.if.in[ifInOctets.{#SNMPINDEX}]18030dbpsMIB: IF-MIB
The total number of octets received on the interface,including framing characters. Discontinuities in the value of this counter can occurat re-initialization of the management system, and atother times as indicated by the value of ifCounterDiscontinuityTime.Network InterfacesCHANGE_PER_SECONDMULTIPLIER8Interface {#IFDESCR}: Outbound pkts discardedSNMP_AGENT1.3.6.1.2.1.2.2.1.19.{#SNMPINDEX}net.if.out.discards[ifOutDiscards.{#SNMPINDEX}]3001wMIB: 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.Network InterfacesCHANGE_PER_SECONDInterface {#IFDESCR}: Outbound pkts with errorsSNMP_AGENT1.3.6.1.2.1.2.2.1.20.{#SNMPINDEX}net.if.out.errors[ifOutErrors.{#SNMPINDEX}]3001wMIB: 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.Network InterfacesCHANGE_PER_SECONDInterface {#IFDESCR}: Outbound non-unicast pktsSNMP_AGENT1.3.6.1.2.1.2.2.1.18.{#SNMPINDEX}net.if.out[ifOutNUcastPkts.{#SNMPINDEX}]1801wppsMIB: IF-MIB
The total number of packets that higher-level protocols requested be transmitted to a non- unicast (i.e., a subnetwork-broadcast or subnetwork-multicast) address, including those that were discarded or not sent.Network InterfacesCHANGE_PER_SECONDInterface {#IFDESCR}: Bits sentSNMP_AGENT1.3.6.1.2.1.2.2.1.16.{#SNMPINDEX}net.if.out[ifOutOctets.{#SNMPINDEX}]18030dbpsMIB: IF-MIB
The total number of octets transmitted out of the interface, including framing characters. Discontinuities in the value of this counter can occurat re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime.Network InterfacesCHANGE_PER_SECONDMULTIPLIER8Interface {#IFDESCR}: Outbound unicast pktsSNMP_AGENT1.3.6.1.2.1.2.2.1.17.{#SNMPINDEX}net.if.out[ifOutUcastPkts.{#SNMPINDEX}]1801wppsMIB: IF-MIB
The total number of packets that higher-level protocols requested be transmitted to a subnetwork-unicast address, including those that were discarded or not sent.Network InterfacesCHANGE_PER_SECONDInterface {#IFDESCR}: SpeedSNMP_AGENT1.3.6.1.2.1.2.2.1.5.{#SNMPINDEX}net.if.speed[ifSpeed.{#SNMPINDEX}]3001w0dbpsMIB: 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 interace's speed.
For a sub-layer which has no concept of bandwidth, this object should be zero.Network InterfacesInterface {#IFDESCR}: Operational statusSNMP_AGENT1.3.6.1.2.1.2.2.1.8.{#SNMPINDEX}net.if.status[ifOperStatus.{#SNMPINDEX}]6014d0dMIB: 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.Network InterfacesIF-MIB::ifOperStatus{$IFCONTROL:"{#IFNAME}"}=1 and ({last()}=2 and {diff()}=1)Interface {#IFDESCR}: Link downAVERAGELast value: {ITEM.LASTVALUE1}.
Interface is downInterface {#IFDESCR}: Interface typeSNMP_AGENT1.3.6.1.2.1.2.2.1.3.{#SNMPINDEX}net.if.type[ifType.{#SNMPINDEX}]36001w0dMIB: IF-MIB
The type of interface.
Additional values for ifType are assigned by the Internet Assigned NumbersAuthority (IANA),
through updating the syntax of the IANAifType textual convention.Network InterfacesIF-MIB::ifTypeInterface {#IFDESCR}: MAC AddressSNMP_AGENT1.3.6.1.2.1.2.2.1.6.{#SNMPINDEX}net.if[ifPhysAddress.{#SNMPINDEX}]1h30d0CHARMIB: IF-MIB
The interface's address at the protocol layer immediately `below' the network layer in the protocol stack. For interfaces which do not have such an address (e.g., a serial line), this object should contain an octet string of zero length.Network Interfaces{Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].change()}<0 and {Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].last()}>0
and (
{Module Interfaces Simple SNMPv3:net.if.type[ifType.{#SNMPINDEX}].last()}=6 or
{Module Interfaces Simple SNMPv3:net.if.type[ifType.{#SNMPINDEX}].last()}=7 or
{Module Interfaces Simple SNMPv3:net.if.type[ifType.{#SNMPINDEX}].last()}=11 or
{Module Interfaces Simple SNMPv3:net.if.type[ifType.{#SNMPINDEX}].last()}=62 or
{Module Interfaces Simple SNMPv3:net.if.type[ifType.{#SNMPINDEX}].last()}=69 or
{Module Interfaces Simple SNMPv3:net.if.type[ifType.{#SNMPINDEX}].last()}=117
)
and
({Module Interfaces Simple SNMPv3:net.if.status[ifOperStatus.{#SNMPINDEX}].last()}<>2)
RECOVERY_EXPRESSION({Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].change()}>0 and {Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].prev()}>0) or
({Module Interfaces Simple SNMPv3:net.if.status[ifOperStatus.{#SNMPINDEX}].last()}=2)Interface {#IFDESCR}: Ethernet has changed to lower speed than it was beforeINFOLast value: {ITEM.LASTVALUE1}.
This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Ack to close.Interface {#IFDESCR}: Link down{$IFCONTROL:"{#IFNAME}"}=1 and ({Module Interfaces Simple SNMPv3:net.if.status[ifOperStatus.{#SNMPINDEX}].last()}=2 and {Module Interfaces Simple SNMPv3:net.if.status[ifOperStatus.{#SNMPINDEX}].diff()}=1)({Module Interfaces Simple SNMPv3:net.if.in[ifInOctets.{#SNMPINDEX}].avg(15m)}>({$IF_UTIL_MAX:"{#IFNAME}"}/100)*{Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].last()} or
{Module Interfaces Simple SNMPv3:net.if.out[ifOutOctets.{#SNMPINDEX}].avg(15m)}>({$IF_UTIL_MAX:"{#IFNAME}"}/100)*{Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].last()}) and
{Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].last()}>0RECOVERY_EXPRESSION{Module Interfaces Simple SNMPv3:net.if.in[ifInOctets.{#SNMPINDEX}].avg(15m)}<(({$IF_UTIL_MAX:"{#IFNAME}"}-3)/100)*{Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].last()} and
{Module Interfaces Simple SNMPv3:net.if.out[ifOutOctets.{#SNMPINDEX}].avg(15m)}<(({$IF_UTIL_MAX:"{#IFNAME}"}-3)/100)*{Module Interfaces Simple SNMPv3:net.if.speed[ifSpeed.{#SNMPINDEX}].last()}Interface {#IFDESCR}: High bandwidth usage >{$IF_UTIL_MAX:"{#IFNAME}"}%WARNINGLast value: {ITEM.LASTVALUE1}.Interface {#IFDESCR}: Link down{$IFCONTROL:"{#IFNAME}"}=1 and ({Module Interfaces Simple SNMPv3:net.if.status[ifOperStatus.{#SNMPINDEX}].last()}=2 and {Module Interfaces Simple SNMPv3:net.if.status[ifOperStatus.{#SNMPINDEX}].diff()}=1){Module Interfaces Simple SNMPv3:net.if.in.errors[ifInErrors.{#SNMPINDEX}].avg(5m)}>{$IF_ERRORS_WARN:"{#IFNAME}"}
or {Module Interfaces Simple SNMPv3:net.if.out.errors[ifOutErrors.{#SNMPINDEX}].avg(5m)}>{$IF_ERRORS_WARN:"{#IFNAME}"}RECOVERY_EXPRESSION{Module Interfaces Simple SNMPv3:net.if.in.errors[ifInErrors.{#SNMPINDEX}].avg(5m)}<{$IF_ERRORS_WARN:"{#IFNAME}"}-2
and {Module Interfaces Simple SNMPv3:net.if.out.errors[ifOutErrors.{#SNMPINDEX}].avg(5m)}<{$IF_ERRORS_WARN:"{#IFNAME}"}-2Interface {#IFDESCR}: High error rateWARNINGLast value: {ITEM.LASTVALUE1}.Interface {#IFDESCR}: Link down{$IFCONTROL:"{#IFNAME}"}=1 and ({Module Interfaces Simple SNMPv3:net.if.status[ifOperStatus.{#SNMPINDEX}].last()}=2 and {Module Interfaces Simple SNMPv3:net.if.status[ifOperStatus.{#SNMPINDEX}].diff()}=1)Interface {#IFDESCR}: Network trafficGRADIENT_LINE1A7C11- Module Interfaces Simple SNMPv3net.if.in[ifInOctets.{#SNMPINDEX}]
1BOLD_LINE2774A4- Module Interfaces Simple SNMPv3net.if.out[ifOutOctets.{#SNMPINDEX}]
2F63100RIGHT- Module Interfaces Simple SNMPv3net.if.out.errors[ifOutErrors.{#SNMPINDEX}]
3A54F10RIGHT- Module Interfaces Simple SNMPv3net.if.in.errors[ifInErrors.{#SNMPINDEX}]
4FC6EA3RIGHT- Module Interfaces Simple SNMPv3net.if.out.discards[ifOutDiscards.{#SNMPINDEX}]
56C59DCRIGHT- Module Interfaces Simple SNMPv3net.if.in.discards[ifInDiscards.{#SNMPINDEX}]
Interface {#IFDESCR}: Network traffic in ppsAA0000- Module Interfaces Simple SNMPv3net.if.in.discards[ifInNUcastPkts.{#SNMPINDEX}]
1008800- Module Interfaces Simple SNMPv3net.if.in.discards[ifInUcastPkts.{#SNMPINDEX}]
2990099- Module Interfaces Simple SNMPv3net.if.out[ifOutNUcastPkts.{#SNMPINDEX}]
3000088- Module Interfaces Simple SNMPv3net.if.out[ifOutUcastPkts.{#SNMPINDEX}]
{$IFCONTROL}1{$IF_ERRORS_WARN}2{$IF_UTIL_MAX}95IF-MIB::ifOperStatus1up2down3testing4unknown5dormant6notPresent7lowerLayerDownIF-MIB::ifType1other2regular18223hdh18224ddnX255rfc877x256ethernetCsmacd7iso88023Csmacd8iso88024TokenBus9iso88025TokenRing10iso88026Man11starLan12proteon10Mbit13proteon80Mbit14hyperchannel15fddi16lapb17sdlc18ds119e120basicISDN21primaryISDN22propPointToPointSerial23ppp24softwareLoopback25eon26ethernet3Mbit27nsip28slip29ultra30ds331sip32frameRelay33rs23234para35arcnet36arcnetPlus37atm38miox2539sonet40x25ple41iso88022llc42localTalk43smdsDxi44frameRelayService45v3546hssi47hippi48modem49aal550sonetPath51sonetVT52smdsIcip53propVirtual54propMultiplexor55ieee8021256fibreChannel57hippiInterface58frameRelayInterconnect59aflane802360aflane802561cctEmul62fastEther63isdn64v1165v3666g703at64k67g703at2mb68qllc69fastEtherFX70channel71ieee8021172ibm370parChan73escon74dlsw75isdns76isdnu77lapd78ipSwitch79rsrb80atmLogical81ds082ds0Bundle83bsc84async85cnr86iso88025Dtr87eplrs88arap89propCnls90hostPad91termPad92frameRelayMPI93x21394adsl95radsl96sdsl97vdsl98iso88025CRFPInt99myrinet100voiceEM101voiceFXO102voiceFXS103voiceEncap104voiceOverIp105atmDxi106atmFuni107atmIma108pppMultilinkBundle109ipOverCdlc110ipOverClaw111stackToStack112virtualIpAddress113mpc114ipOverAtm115iso88025Fiber116tdlc117gigabitEthernet118hdlc119lapf120v37121x25mlp122x25huntGroup123trasnpHdlc124interleave125fast126ip127docsCableMaclayer128docsCableDownstream129docsCableUpstream130a12MppSwitch131tunnel132coffee133ces134atmSubInterface135l2vlan136l3ipvlan137l3ipxvlan138digitalPowerline139mediaMailOverIp140dtm141dcn142ipForward143msdsl144ieee1394145if-gsn146dvbRccMacLayer147dvbRccDownstream148dvbRccUpstream149atmVirtual150mplsTunnel151srp152voiceOverAtm153voiceOverFrameRelay154idsl155compositeLink156ss7SigLink157propWirelessP2P158frForward159rfc1483160usb161ieee8023adLag162bgppolicyaccounting163frf16MfrBundle164h323Gatekeeper165h323Proxy166mpls167mfSigLink168hdsl2169shdsl170ds1FDL171pos172dvbAsiIn173dvbAsiOut174plc175nfas176tr008177gr303RDT178gr303IDT179isup180propDocsWirelessMaclayer181propDocsWirelessDownstream182propDocsWirelessUpstream183hiperlan2184propBWAp2Mp185sonetOverheadChannel186digitalWrapperOverheadChannel187aal2188radioMAC189atmRadio190imt191mvl192reachDSL193frDlciEndPt194atmVciEndPt195opticalChannel196opticalTransport197propAtm198voiceOverCable199infiniband200teLink201q2931202virtualTg203sipTg204sipSig205docsCableUpstreamChannel206econet207pon155208pon622209bridge210linegroup211voiceEMFGD212voiceFGDEANA213voiceDID214mpegTransport215sixToFour216gtp217pdnEtherLoop1218pdnEtherLoop2219opticalChannelGroup220homepna221gfp222ciscoISLvlan223actelisMetaLOOP224fcipLink225rpr226qam227lmp228cblVectaStar229docsCableMCmtsDownstream230adsl2231macSecControlledIF232macSecUncontrolledIF233aviciOpticalEther234atmbond235voiceFGDOS236mocaVersion1237ieee80216WMAN238adsl2plus239dvbRcsMacLayer240dvbTdm241dvbRcsTdma242x86Laps243wwanPP244wwanPP2245voiceEBS246ifPwType247ilan248pip249aluELP250gpon251vdsl2252capwapDot11Profile253capwapDot11Bss254capwapWtpVirtualRadio255bits256docsCableUpstreamRfPort257cableDownstreamRfPort258vmwareVirtualNic259ieee802154260otnOdu261otnOtu262ifVfiType263g9981264g9982265g9983266aluEpon267aluEponOnu268aluEponPhysicalUni269aluEponLogicalLink270aluGponOnu271aluGponPhysicalUni272vmwareNicTeam277docsOfdmDownstream278docsOfdmaUpstream279gfast280sdci281xboxWireless282fastdsl283docsCableScte55d1FwdOob284docsCableScte55d1RetOob285docsCableScte55d2DsOob286docsCableScte55d2UsOob287docsCableNdf288docsCableNdr289ptm290ghn