SNMP Overview
Common Tasks
previous next
XRatel Knowledge Base knowledge base
Introduction | SNMP Architecture | the Protocol
Structure of Management Information | Object Identifier
Management Information Base | Common Tasks | References


Common Tasks

01. System Monitoring

The system MIB group is a very simple group consisted of seven objects numbered below as it can be found on the MIB:

OID

Name

Datatype

Writable

Description

1 sysDescr Display
String
no Description of the
monitored device
2 sysObjectID ObjectID no Vendor's identification of the device. It is localized at 1.3.6.1.4.1.
3 sysUpTime TimeTicks no Time since the last network management reboot in nanoseconds.
4 sysContact Display
String
yes Information about the contact person of this node.
5 sysName Display
String
yes Node's domain name.
6 sysLocation Display
String
yes Location of the node.
7 sysServices INTEGER no This variable indicates the OSI
layers avaiable in the node.
The first bit indicates the physical layer, the second
indicates the datalink layer,
the third is for internet,
the fourth is used to
end-to-end, the fifth to

The SNMP OID of the system group is 1.3.6.1.2.1.1(mib.system)

02. Interfaces Monitoring

This is a very powerful group. It has only a variable(ifNumber) and a table(ifTable). It OID is 1.3.6.1.2.1.2(mib.interfaces).

The variable ifNumber is a read-only INTEGER wich displays the number of network interfaces on a system.

The table ifTable is a list of interfaces entries (ifEntry). It has the number entries specified in ifNumbers. Each ifEntry has the following variables:

OID

Name

Datatype

Writable

Description

1 ifIndex INTEGER no The index of the interface
2 ifDescr Display
String
no The description of the interface
3 ifType INTEGER no Type of the interface, like: 5(X.25), 6(Ethernet CSMA-CD), 7(802.3 Ethernet), 9(802.5 token ring), 23(PPP). Another values can be found at The Internet Task Force - Management Information Base for Network Management of TCP/IP-based internets: MIB-II
4 ifMtu INTEGER no The largest IP datagram this interface can send or receive
5 ifSpeed Gauge no The current bandwith of
the interface in bits/sec
6 ifPhysAddress Phys
Address
no Physical address of the interface
7 ifAdminStatus INTEGER yes Desired status of the
interface. It can be 1 to
pass all packets, 2 to
become down and 3 to
enter the testing mode
8 ifOperStatus INTEGER no Current status of the
interface. It can be 1 to
pass all packets, 2 to
become down and 3 to
enter the testing mode
9 ifLastChange TimeTicks no Displays the value found
in sysUpTime
when the status of the
interface changed.
10 ifInOctets Counter no Total number of bytes received
11 ifInUcastPkts Counter no Total number of unicast packets sent to a higher layer protocol
12 ifInNUcastPkts Counter no Number of nonunicast packets sent to a higher layer protocol
13 ifInDiscards Counter no Total number of discarded packets even though no
error was detected
14 ifInErrors Counter no Total number of
received packets
discarded because an
error was detected
15 ifInUnknown
Protos
Counter no Displays the total
number of received
packets discarded
because an unknown
protocol was used
16 ifOutOctets Counter no Total number of sent bytes
17 ifOutUcastPkts Counter no Total number of unicast packets received from a higher layer protocol
18 ifOutNUcastPkts Counter no Total number of nonunicast packets received from a
higher layer protocol
19 ifOutDiscards Counter no Number of sent packets discarded even though no
error was detected
20 ifOutErrors Counter no Number of sent packets discarded due to any
error was found
21 ifOutQLen Gauge no Length of output packets queue
22 ifSpecific ObjectID no A reference to MIB
definitions specific to the
particular type of media
being used to realize the
interface. If this interface
is realized by ethernet,
this object will reference to
a document defining objects specific to ethernet

03. IP Monitoring

IP monitoring is an important task in network management. The ip group OID is 1.3.6.1.2.1.4(mib.ip). This group defines 20 variables and three tables. All variables are ordered in the next table by its OID.

OID

Name

Datatype

Writable

Description

1 ipForwading INTEGER yes Indicates if this device is working as a gateway
2 ipDefaultTTL INTEGER yes The default Time-To-Live
value if the transport protocol
doesn't provide one
3 ipInReceives Counter no Total number of ip
datagrams received
4 ipInHdrErrors Counter no Number of discarded datagrams because a header error was found
5 ipInAddrErrors Counter no Total number of discarded
datagrams because an error
in the destination address
was found
6 ipForwD
atagrams
Counter no Number of forwaded
ip datagrams
7 ipInUnknown
Protos
Counter no Number of received ip
datagrams discarded due
to an invalid protocol field
8 ipInDiscards Counter no Total number of input IP
datagrams without
processing errors, but
were discarded(e.g., lack
of buffer space)
9 ipInDelivers Counter no Number of received IP
datagrams correctly delivered
to the user-protocol.
10 ipOutRequests Counter no Total number of sent IP
datagrams. This counter
don't include those counted
in ipForwDatagrams
11 ipOutDiscards Counter no Number of output IP
datagrams discarded due
to lack of buffer space
12 ipOutNoRoute Counter no Total number of output
IP datagrams discarded
due no route could be
found to transmit them
to their destination
13 ipReasm
Timeout
INTEGER no Number of seconds that received fragments are
held awaiting reassembly
14 ipReasmReqds Counter no Total number of received
IP fragments that needed
to be reassembled
15 ipReasmOKs Counter no Total number of IP
datagrams successfully
reassembled
16 ipReasmFails Counter no Total number of IP
datagrams failed on
the reassembly
17 ipFragOKs Counter no Number of IP datagrams
successfully fragmented
18 ipFragFails Counter no Number of IP datagrams
failed during the fragmentation
19 ipFragCreates Counter no Number of IP fragments
created as a result
of fragmentation
23 ipRouting
Discards
Counter no Number of discarded
route entries even if no
error was found

The first table is the ipAddrTable with the OID 20. It has one row for each IP address on the system. All itens of this table is listed below:

OID

Name

Datatype

Writable

Description

1 ipAdEntAddr IpAddress no IP address of the
current table entry
2 ipAdEntIfIndex INTEGER no The interface number
specified in ifIndex
for this IP address
3 ipAdEnt
NetMask
IpAddress no Associated subnet
for this IP address
4 ipAdEntB
castAddr
INTEGER no Least-significant bit
in the IP broadcast
5 ipAdEntReasm
MaxSize
INTEGER no Maximum size of
the IP datagram can
be reassembled

The OID 21 of the ip group is the ipRouteTable. It is a table with 13 columns and a row for each destination address inserted.

OID

Name

Datatype

Writable

Description

1 ipRouteDest IpAddress yes Destination IP address
of this route.
2 ipRouteIfIndex INTEGER yes Corresponding interface id(ifIndex)
3 ipRouteMetric1 INTEGER yes Primary route metric for this route. The value depends of ipRouteProto. If it is not in use the value will be -1
4 ipRouteMetric2 INTEGER yes Alternative routing
metric for this route
5 ipRouteMetric3 INTEGER yes Alternative routing
metric for this route
6 ipRouteMetric4 INTEGER yes Alternative routing
metric for this route
7 ipRouteNextHop IpAddress yes The next hop of this route
8 ipRouteType INTEGER yes The type of the route that can be 1 for other, 2 for invalidated route, 3 for directly route and 4 for a non-local route
9 ipRouteProto INTEGER no Routing protocol for this route. Possible values are 1 to other, 2 for local, 4 to ICMP redirect. The complete possible values is in The Internet Task Force - Management Information Base for Network Management of TCP/IP-based internets: MIB-II
10 ipRouteAge INTEGER yes Time in seconds since the
last update of this route
11 ipRouteMask IpAddress yes A mask to be ANDed with the destination IP address before being compared to the value in ipRouteDest field
12 ipRouteMetric5 INTEGER yes Alternative routing
metric for this route
13 ipRouteInfo ObjectID no OID of the reference
of this routing protocol

And the last table in the ip group is the ipNetToMediaTable with the OID 22. It is used to mapping the IP address to physical address.

04. ICMP Monitoring

The icmp group has the OID 1.3.6.1.2.1.5(mib.icmp) and 26 variables: 13 for input ICMP messages and 13 for output ICMP messages. All these variables are ordered below by OID.

OID

Name

Datatype

Writable

Description

1 icmpInMsgs Counter no Total number of all ICMP messages received
2 icmpInErrors Counter no Number of received ICMP messages with specific
ICMP errors
3 icmpInDest
Unreachs
Counter no Total number of received ICMP unreachable messages
4 icmpIn
TimeExcds
Counter no Number of received ICMP time exceeded messages
5 icmpIn
ParmProbs
Counter no Number of received ICMP parameter problem messages
6 icmpInSrc
Quenchs
Counter no Number of ICMP source quench messages received
7 icmpInRedirects Counter no Total number of ICMP redirect messages received
8 icmpInEchos Counter no Total number of ICMP echo request messages received
9 icmpInEchoReps Counter no Total number of ICMP echo reply messages received
10 icmpIn
Timestamps
Counter no The number of received ICMP timestamp request messages
11 icmpIn
TimestampsReps
Counter no The number of received ICMP timestamp reply messages
12 icmpIn
AddrMasks
Counter no Total number of ICMP
address mask request
messages received
13 icmpInAddr
MasksReps
Counter no Total number of ICMP address mask reply messages received
14 icmpOutMsgs Counter no Total number of all
ICMP messages sent
15 icmpOutErrors Counter no Number of sent ICMP messages with specific
ICMP errors
16 icmpOutDest
Unrechs
Counter no Total number of ICMP unreachable messages sent
17 icmpOut
TimeExcds
Counter no Number of sent ICMP time exceeded messages
18 icmpOut
ParmProbs
Counter no Number of sent ICMP parameter problem messages
19 icmpOutSrc
Quenchs
Counter no Number of ICMP source quench messages sent
20 icmpOut
Redirects
Counter no Total number of ICMP redirect messages sent
21 icmpOutEchos Counter no Total number of ICMP echo request messages sent
22 icmpOut
EchoReps
Counter no Total number of ICMP echo reply messages sent
23 icmpOut
Timestamp
Counter no The number of sent ICMP timestamp request messages
24 icmpOut
TimestampReps
Counter no The number of sent ICMP timestamp reply messages
25 icmpOut
AddrMasks
Counter no Total number of ICMP
address mask request
messages received
26 icmpOutAddr
MasksReps
Counter no Total number of ICMP address mask reply messages received

 

OID

Name

Datatype

Writable

Description

1 ipNetToMediaIfIndex INTEGER yes Wich interface this entry is effective
2 ipNetToMediaPhysAddress PhysAddress yes The physical address
3 ipNetToMediaNetAddress IpAddress yes Corresponding IP address to the physical address
4 ipNetToMediaType INTEGER yes The type of mapping. It can be 1 for other, 2 for invalidated, 3 for dynamic and 4 for static

05. TCP Monitoring

The tcp group manages information about TCP connections. It has 14 variables, a table called tcpConnTable and the OID 1.3.6.1.2.1.6(mib.tcp).

OID

Name

Datatype

Writable

Description

1 tcpRtoAlgorithm INTEGER no This variable indicates the algorithm used to calculate
the timeout value for retransmitting unacknowledged octets. Possible values are: 1(none of the following), 2(a constant RTO), 3(MIL-STD-1778), 4(Van Jacobson's algorithm)
2 tcpRtoMin INTEGER no Minimum timeout value permitted in a TCP implementation for the retransmission in milliseconds
3 tcpRtoMax INTEGER no Maximum timeout value permitted in a TCP implementation for the retransmission in milliseconds
4 tcpMaxConn INTEGER no Maximum number of TCP connection this entity supports
5 tcpActiveOpens Counter no Total number of transitions to SYN_SENT state from
CLOSED state
6 tcpPassiveOpens Counter no Total number of transitions to SYN_RCVD state
from LISTEN state
7 tcpAttemptFails Counter no Total number of transitions to the CLOSED state from SYN_SENT or SYNRCVD states plus the transitions to LISTEN from SYN_RCVD
8 tcpEstabRestes Counter no Total number of transitions to CLOSED state from ESTABLISHED or
CLOSE-WAIT states
9 tcpCurrEstab Gauge no Number of currently TCP connections in ESTABLISHED or CLOSE-WAIT states
10 tcpInSegs Counter no Total number of
segments received
11 tcpOutsegs Counter no Total number of segments sent, excluding those containing only
retranmitted octets
12 tcpRetransSegs Counter no Number of segments transmitted with one or more previouly transmitted octets
14 tcpInErrs Counter no Number of received
segments with an error
15 tcpOutRsts Counter no Number of transmitted segments with the RST flag set

The following table is tcpConnTable. It has the OID 13 and a row for each TCP connection:

OID

Name

Datatype

Writable

Description

1 tcpConnState INTEGER yes Indicates the current state of the TCP connection. The user can only set the value 12, but can read: 1(closed), 2(listen), 3(synSent), 4(synReceived), 5(established), 6(finWait1), 7(finWait2), 8(closeWait), 9(lastAck), 10(closing), 11(timeWait), 12(deleteTCB)
2 tcpConn
LocalAddress
IpAddress no Local IP address of the current connection. The value 0.0.0.0 indicates that the listener is willing to accept TCP connections on any interface
3 tcpConn
LocalPort
Integer no Local port number of
this TCP connection
4 tcpConnRem
Address
IpAddress no Remote IP address of
this TCP connection
5 tcpConn
RemPort
Integer no Remote port number of the current TCP connection

06. UDP Monitoring

The udp group has the OID 1.3.6.1.2.1.7(mib.udp). It has only 4 variables and a table called udpTable. All these variables are ordered below by OID.

OID

Name

Datatype

Writable

Description

1 udpInDatagrams Counter no Total number of UDP datagrams delivered
to user processes
2 udpNoPorts Counter no Number of UDP datagrams for which no application was in
the destination port
3 udpInErrors Counter no Total number of UDP datagrams that cannot be delivered for another reasons than no application at destination port
4 udpOut
Datagrams
Counter no Total number of UDP datagrams sent

The table bellow lists the variables in the udpTable. This table has the OID 5.

OID

Name

Datatype

Writable

Description

1 udpLocal
Address
IpAddress no Local IP address for the current listener. The value 0.0.0.0 indicates thath the listener is willing to receive datagrams on any interface
2 udpLocalPort INTEGER no Local port number for
the current listener

07. SNMP Monitoring

The snmp group is the object 1.3.6.1.2.1.11(mib.snmp). It has 28 variables with important information about the Simple Network Management Protocol.

OID

Name

Datatype

Writable

Description

1 snmpInPkts Counter no Number of delivered messages to the SNMP entity from the transport service.
2 snmpOutPkts Counter no Number of delivered messages from the SNMP entity to the transport service.
3 snmpInBad
Versions
Counter no Total number of received messages from an unsupported SNMP version
4 snmpInBad
Community
Names
Counter no Total number of received messages with an unknowned community name
5 snmpInBad
Community
Uses
Counter no Total number of received messages with a not allowed operation
6 snmpInASN
ParseErrs
Counter no Total number of received messages with errors in
ASN.1 or BER
8 snmpIn
TooBigs
Counter no Number of received PDU's with the error-status tooBig
9 snmpInNo
SuchNames
Counter no Number of received PDU's with the error-status noSuchName
10 snmpInBad
Values
Counter no Number of received PDU's with the error-status badValue
11 snmpIn
ReadOnlys
Counter no Number of received SNMP PDU's with the
error-status readOnly
12 snmpInGenErrs Counter no Number of received SNMP PDU's with the
error-status genErr
13 snmpInTotal
ReqVars
Counter no Number of successfully retrieved MIB objects as result of received get-next and get-request messages
14 snmpInTotal
SetVars
Counter no Number of successfully edited MIB objects as result of received set-request messages
15 snmpInGet
Requests
Counter no Number of accepted and processed get-request messages
16 snmpInGetNexts Counter no Number of accepted and processed get-next messages
17 snmpInSet
Requests
Counter no Number of accepted and processed set-request messages
18 snmpInGet
Responses
Counter no Number of accepted and processed get-response messages
19 snmpInTraps Counter no Number of accepted and processed trap messages
20 snmpOut
TooBigs
Counter no Number of sent PDU's with the error-status tooBig
21 snmpOutNo
SuchNames
Counter no Number of sent PDU's with the error-status noSuchName
22 snmpOut
BadValues
Counter no Number of sent PDU's with the error-status badValue
24 snmpOut
GenErrs
Counter no Number of received SNMP PDU's with the
error-status genErr
25 snmpOutGet
Requests
Counter no Number of successfully generated get-request messages
26 snmpOut
GetNexts
Counter no Number of successfully generated get-next messages
27 snmpOutSet
Requests
Counter no Number of successfully generated set-request messages
28 snmpOutGet
Responses
Counter no Number of successfully generated get-response messages
29 snmpOutTraps Counter no Number of successfully generated trap messages
30 snmpEnable
AuthenTraps
INTEGER yes Indicates if the SNMP agent is enabled to create authentication-failure traps. Two values are possible here: 1 for enable and 2 for disable

previous top next

 
©2005-2008 XRatel Software. All rights reserved.