MRTG-MIBHELP(1)

📦
version 2.17.10 · 2 versions
  • 2.17.10 · alpine 3.22, alpine 3.23, alpine 3.24, centos-stream 10, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 2.17.7 · centos-stream 9
, in alpine 3.22, alpine 3.23, alpine 3.24, centos-stream 10, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

mrtg-mibhelp — a whole table of some interesting OIDs, and yes it's from the mrtg manual, bestie 🫶

✨ OVERVIEW ✨

Okay so, this file is a collection of interesting MIB entries ... and mrtg knows about their names ... and depending on the ASN.1 syntax you may have to put gauge into the Options[]: parameter. Noted. 💅

Wanna know how to build a Target[]: parameter that references these MIB entries? Go consult mrtg-reference, it has the whole tutorial. 🌸

📋 MIB LIST 📋

🌈 ifOperStatus

  • Descriptor: ifOperStatus
  • Identifier: 1.3.6.1.2.1.2.2.1.8
  • ASN.1 Syntax: INTEGER
  • Enumeration: up 1, down 2, testing 3

The current operational state of the interface. The testing(3) state is basically saying no operational packets can be passed, so don't expect anything to get through. 🚫

🌈 ifAdminStatus

  • Descriptor: ifAdminStatus
  • Identifier: 1.3.6.1.2.1.2.2.1.7
  • ASN.1 Syntax: INTEGER
  • Enumeration: up 1, down 2, testing 3

The current administrative state of the interface. And again, the testing(3) state means no operational packets can be passed. Same energy, different counter. ✨

🌈 ifInOctets

  • Descriptor: ifInOctets
  • Identifier: 1.3.6.1.2.1.2.2.1.10
  • ASN.1 Syntax: Counter32

The total number of octets received on the interface, framing characters included. Yes, all of them, nothing skipped. 👑

🌈 ifInUcastPkts

  • Descriptor: ifInUcastPkts
  • Identifier: 1.3.6.1.2.1.2.2.1.11
  • ASN.1 Syntax: Counter32

The number of subnetwork-unicast packets delivered to a higher-layer protocol. Delivered, periodt. 📬

🌈 ifInNUcastPkts

  • Descriptor: ifInNUcastPkts
  • Identifier: 1.3.6.1.2.1.2.2.1.12
  • ASN.1 Syntax: Counter32

The number of non-unicast (i.e., subnetwork-broadcast or subnetwork-multicast) packets delivered to a higher-layer protocol. The not-just-one-destination girlies. 🦋

🌈 ifInDiscards

  • Descriptor: ifInDiscards
  • Identifier: 1.3.6.1.2.1.2.2.1.13
  • ASN.1 Syntax: Counter32

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. So like, they weren't broken, they were just… let go. 😭

🌈 ifInErrors

  • Descriptor: ifInErrors
  • Identifier: 1.3.6.1.2.1.2.2.1.14
  • ASN.1 Syntax: Counter32

The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. Messy. Not making it upstairs. 💀

🌈 ifInUnknownProtos

  • Descriptor: ifInUnknownProtos
  • Identifier: 1.3.6.1.2.1.2.2.1.15
  • ASN.1 Syntax: Counter32

The number of packets received via the interface which were discarded because of an unknown or unsupported protocol. We literally do not know her. 🙈

🌈 ifOutOctets

  • Descriptor: ifOutOctets
  • Identifier: 1.3.6.1.2.1.2.2.1.16
  • ASN.1 Syntax: Counter32

The total number of octets transmitted out of the interface, framing characters included. Everything that left the building. 🚀

🌈 ifOutUcastPkts

  • Descriptor: ifOutUcastPkts
  • Identifier: 1.3.6.1.2.1.2.2.1.17
  • ASN.1 Syntax: Counter32

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. Yes, even the ones that flopped count. 💅

🌈 ifOutNUcastPkts

  • Descriptor: ifOutNUcastPkts
  • Identifier: 1.3.6.1.2.1.2.2.1.18
  • ASN.1 Syntax: Counter32

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. Same deal, broadcast/multicast flavor. 📢

🌈 ifOutDiscards

  • Descriptor: ifOutDiscards
  • Identifier: 1.3.6.1.2.1.2.2.1.19
  • ASN.1 Syntax: Counter32

The number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. Buffer space said "not today." 🫠

🌈 ifOutErrors

  • Descriptor: ifOutErrors
  • Identifier: 1.3.6.1.2.1.2.2.1.20
  • ASN.1 Syntax: Counter32

The number of outbound packets that could not be transmitted because of errors. They tried to leave. They did not leave. 😔

🌈 ifOutQLen

  • Descriptor: ifOutQLen
  • Identifier: 1.3.6.1.2.1.2.2.1.21
  • ASN.1 Syntax: Unsigned32

The length of the output packet queue (in packets). How long is the line? That long. ⏳

🌸 frInOctets

From: Simon Ferrett simonf@world.net

'frInOctets' => '1.3.6.1.2.1.10.32.2.1.9'
'frOutOctets' => '1.3.6.1.2.1.10.32.2.1.7'

which when used in the form:

frInOctets.pp.dd&frOutOctets.pp.dd:community@cisco.router

where pp is the physical port that the frame relay pvc is defined on and dd is the DLCI of the pvc gets you the in and out octets for just that pvc.

🧚 ifAdminHack and ifOperHack

The return values of ifAdminStatus and ifOperStatus are not very useful for graphing. Use ifOperHack and ifAdminHack instead. They return 1 for UP and 0 otherwise.

Note these are not real MIB entities but mrtg hacks 👀

🧚 PseudoZero and PseudoOne

will return 0 and 1 respectively

Note these are not real MIB entities but mrtg hacks 👀

👑 AUTHOR 👑

Tobias Oetiker tobi@oetiker.ch

and that's the whole page, bestie!! 💖 this was version 2.17.10, dated 2022-01-19, straight out of the mrtg manual — go forth and graph, you absolute icon 🎀✨

📦 where this page comes from