doc/mrtg-mibhelp

# NAME

mrtg-mibhelp - A Table of some interesting OIDs

# OVERVIEW

This File Contains a collection of interesting MIB Entries ... mrtg knows about their names ... depending on the ASN.1 Syntax you may have to put gauge into the Options[]: parameter.

For information about how to create a Target[]: parameter which references these MIB entries, please consult the mrtg-reference manpage.

# 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 indicates that no operational packets can be passed.

## 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. The `testing(3)` state indicates that no operational packets can be passed.

## 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, including framing characters.

## 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.

## 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.

## 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.

## 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.

## 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.

## 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, including framing characters.

## 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.

## 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.

## 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.

## 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.

## 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).

## 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 usefull 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 <oetiker@ee.ethz.ch>