455 lines
14 KiB
Plaintext
455 lines
14 KiB
Plaintext
-- *****************************************************************
|
|
-- RBN-PING-MIB Redback Ping MIB
|
|
--
|
|
-- Copyright (c) 2008 Redback Networks, Inc.
|
|
-- All rights reserved.
|
|
--
|
|
-- *****************************************************************
|
|
|
|
RBN-PING-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, Gauge32,
|
|
Unsigned32 FROM SNMPv2-SMI
|
|
DateAndTime, TruthValue FROM SNMPv2-TC
|
|
MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF
|
|
InetAddressType, InetAddress FROM INET-ADDRESS-MIB
|
|
pingCtlEntry, pingResultsEntry,
|
|
pingCtlOwnerIndex, pingCtlTestName FROM DISMAN-PING-MIB
|
|
rbnMgmt FROM RBN-SMI;
|
|
|
|
rbnPingMib MODULE-IDENTITY
|
|
LAST-UPDATED "200807300000Z" -- Jul 30, 2008
|
|
ORGANIZATION "Redback Networks, Inc."
|
|
CONTACT-INFO
|
|
" Redback Networks, Inc.
|
|
Postal: 300 Holger Way
|
|
San Jose, CA 95134
|
|
USA
|
|
|
|
Phone: +1 408 750 5000
|
|
Fax: +1 408 750 5599
|
|
|
|
E-mail: mib-info@redback.com
|
|
"
|
|
DESCRIPTION
|
|
"This Redback MIB supplements the standard Ping MIB, namely:
|
|
DISMAN-PING-MIB (RFC 4560)
|
|
|
|
This module defines additional objects for creating and
|
|
monitoring ping tests.
|
|
|
|
All MIB objects defined in this module are viewed within the
|
|
context identified in the SNMP protocol (i.e. the community
|
|
string in v1/v2c or the contextName in v3)."
|
|
REVISION "200807300000Z" -- Jul 30, 2008
|
|
DESCRIPTION
|
|
"Initial version."
|
|
::= { rbnMgmt 46 }
|
|
|
|
rbnPingObjects OBJECT IDENTIFIER ::= { rbnPingMib 1 }
|
|
rbnPingConformance OBJECT IDENTIFIER ::= { rbnPingMib 2 }
|
|
rbnPingNotifications OBJECT IDENTIFIER ::= { rbnPingMib 3 }
|
|
|
|
--
|
|
-- some structure for the mib objects
|
|
--
|
|
rbnPingGlobals OBJECT IDENTIFIER ::= { rbnPingObjects 1 }
|
|
rbnPingResults OBJECT IDENTIFIER ::= { rbnPingObjects 2 }
|
|
rbnPingControl OBJECT IDENTIFIER ::= { rbnPingObjects 3 }
|
|
rbnPingIp OBJECT IDENTIFIER ::= { rbnPingObjects 4 }
|
|
|
|
--
|
|
-- Global objects
|
|
--
|
|
|
|
rbnPingNumTests OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The number of entries in the pingCtlTable."
|
|
::= { rbnPingGlobals 1 }
|
|
|
|
--
|
|
-- Ping test results (common to all protocols)
|
|
--
|
|
|
|
rbnPingResultsTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF RbnPingResultsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table enhances the pingResultsTable, providing additional
|
|
statistics for completed ping tests."
|
|
::= { rbnPingResults 1 }
|
|
|
|
rbnPingResultsEntry OBJECT-TYPE
|
|
SYNTAX RbnPingResultsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A conceptual row in the rbnPingResultsTable."
|
|
AUGMENTS { pingResultsEntry }
|
|
::= { rbnPingResultsTable 1 }
|
|
|
|
RbnPingResultsEntry ::= SEQUENCE {
|
|
rbnPingResultsJitter Gauge32
|
|
}
|
|
|
|
rbnPingResultsJitter OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "milliseconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The calculated ping jitter value, which is the delta between
|
|
the minimum round-trip-time (RTT) and the maximum RTT. If no
|
|
RTT has been received, this object will have a value of 0."
|
|
::= { rbnPingResultsEntry 1 }
|
|
|
|
rbnPingHistoryTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF RbnPingHistoryEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Defines a table for storing the results of ping tests. This
|
|
is essentially a mirror of the pingResultsTable, with the
|
|
addition of an index object.
|
|
|
|
The number of entries in this table is limited per entry in
|
|
the pingCtlTable by the value of the corresponding
|
|
rbnPingCtlMaxHistoryRows object.
|
|
|
|
An entry in this table is created when a ping test completes.
|
|
The initial 2 instance identifier index values identify the
|
|
pingCtlEntry that these test results belong to. An entry is
|
|
removed from the table when its corresponding pingCtlEntry
|
|
is deleted.
|
|
|
|
The oldest entry in this table for a corresponding entry in
|
|
the pingCtlTable will be removed to allow the addition of a
|
|
new entry once the number of rows in this table reaches the
|
|
value specified by the rbnPingCtlMaxHistory for the
|
|
corresponding entry in the rbnPingCtlTable."
|
|
::= { rbnPingResults 2 }
|
|
|
|
rbnPingHistoryEntry OBJECT-TYPE
|
|
SYNTAX RbnPingHistoryEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A conceptual row in the rbnPingHistoryTable."
|
|
INDEX { pingCtlOwnerIndex, pingCtlTestName, rbnPingHistoryIndex }
|
|
::= { rbnPingHistoryTable 1 }
|
|
|
|
RbnPingHistoryEntry ::= SEQUENCE {
|
|
rbnPingHistoryIndex Unsigned32,
|
|
rbnPingHistoryIpTargetAddressType InetAddressType,
|
|
rbnPingHistoryIpTargetAddress InetAddress,
|
|
rbnPingHistoryMinRtt Unsigned32,
|
|
rbnPingHistoryMaxRtt Unsigned32,
|
|
rbnPingHistoryAverageRtt Unsigned32,
|
|
rbnPingHistoryProbeResponses Gauge32,
|
|
rbnPingHistorySentProbes Gauge32,
|
|
rbnPingHistoryRttSumOfSquares Unsigned32,
|
|
rbnPingHistoryLastGoodProbe DateAndTime,
|
|
rbnPingHistoryJitter Gauge32
|
|
}
|
|
|
|
rbnPingHistoryIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..'ffffffff'h)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry in this table is created when a ping test
|
|
completes. The initial 2 instance identifier index values
|
|
identify the pingCtlEntry that these results belongs to.
|
|
|
|
rbnPingHistoryIndex will be assigned values starting at 1 and
|
|
will wrap after exceeding the maximum possible value
|
|
('ffffffff'h)."
|
|
::= { rbnPingHistoryEntry 1 }
|
|
|
|
rbnPingHistoryIpTargetAddressType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the type of address stored
|
|
in the corresponding pingResultsIpTargetAddress
|
|
object."
|
|
DEFVAL { unknown }
|
|
::= { rbnPingHistoryEntry 2 }
|
|
|
|
rbnPingHistoryIpTargetAddress OBJECT-TYPE
|
|
SYNTAX InetAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object reports the IP address associated
|
|
with a pingCtlTargetAddress value when the destination
|
|
address is specified as a DNS name. The value of
|
|
this object should be a zero-length octet string
|
|
when a DNS name is not specified or when a
|
|
specified DNS name fails to resolve.
|
|
|
|
The address type (InetAddressType) that relates to
|
|
this object is specified by the corresponding value
|
|
of pingResultsIpTargetAddressType."
|
|
DEFVAL { ''H }
|
|
::= { rbnPingHistoryEntry 3 }
|
|
|
|
rbnPingHistoryMinRtt OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "milliseconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The minimum ping round-trip-time (RTT) received. A value
|
|
of 0 for this object implies that no RTT has been received."
|
|
::= { rbnPingHistoryEntry 4 }
|
|
|
|
rbnPingHistoryMaxRtt OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "milliseconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The maximum ping round-trip-time (RTT) received. A value
|
|
of 0 for this object implies that no RTT has been received."
|
|
::= { rbnPingHistoryEntry 5 }
|
|
|
|
rbnPingHistoryAverageRtt OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "milliseconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The current average ping round-trip-time (RTT)."
|
|
::= { rbnPingHistoryEntry 6 }
|
|
|
|
rbnPingHistoryProbeResponses OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "responses"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Number of responses received for the corresponding
|
|
pingCtlEntry and pingResultsEntry. The value of this object
|
|
MUST be reported as 0 when no probe responses have been
|
|
received."
|
|
::= { rbnPingHistoryEntry 7 }
|
|
|
|
rbnPingHistorySentProbes OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "probes"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of this object reflects the number of probes sent
|
|
for the corresponding pingCtlEntry and pingResultsEntry.
|
|
The value of this object MUST be reported as 0 when no probes
|
|
have been sent."
|
|
::= { rbnPingHistoryEntry 8 }
|
|
|
|
rbnPingHistoryRttSumOfSquares OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "milliseconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object contains the sum of the squares for all ping
|
|
responses received. Its purpose is to enable standard
|
|
deviation calculation. The value of this object MUST
|
|
be reported as 0 when no ping responses have been
|
|
received."
|
|
::= { rbnPingHistoryEntry 9 }
|
|
|
|
rbnPingHistoryLastGoodProbe OBJECT-TYPE
|
|
SYNTAX DateAndTime
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Date and time when the last response was received for
|
|
a probe."
|
|
::= { rbnPingHistoryEntry 10 }
|
|
|
|
rbnPingHistoryJitter OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "milliseconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The calculated ping jitter value, which is the delta between
|
|
the minimum round-trip-time (RTT) and the maximum RTT. If no
|
|
RTT has been received, this object will have a value of 0."
|
|
::= { rbnPingHistoryEntry 11 }
|
|
|
|
--
|
|
-- Ping test attributes (common to all protocols)
|
|
--
|
|
|
|
rbnPingCtlTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF RbnPingCtlEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table enhances the pingCtlTable, providing additional
|
|
options for ping tests."
|
|
::= { rbnPingControl 1 }
|
|
|
|
rbnPingCtlEntry OBJECT-TYPE
|
|
SYNTAX RbnPingCtlEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A conceptual row in the rbnPingCtlTable."
|
|
AUGMENTS { pingCtlEntry }
|
|
::= { rbnPingCtlTable 1 }
|
|
|
|
RbnPingCtlEntry ::= SEQUENCE {
|
|
rbnPingCtlMaxHistoryRows Unsigned32
|
|
}
|
|
|
|
rbnPingCtlMaxHistoryRows OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The maximum number of corresponding entries allowed in
|
|
the rbnPingHistoryTable. The oldest corresponding entry in
|
|
the rbnPingHistoryTable will be removed to allow the addition
|
|
of a new entry once the number of corresponding rows in the
|
|
rbnPingHistoryTable reaches this value.
|
|
|
|
When a pingCtlTable entry is removed, all corresponding
|
|
entries in the rbnPingHistoryTable will also be removed.
|
|
|
|
A value of 0 for this object disables creation of
|
|
rbnPingHistoryTable entries."
|
|
DEFVAL { 12 }
|
|
::= { rbnPingCtlEntry 1 }
|
|
|
|
--
|
|
-- Ping tests using IPv4
|
|
--
|
|
|
|
rbnPingCtlIpTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF RbnPingCtlIpEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table enhances the pingCtlTable, providing additional
|
|
options for IPv4 ping tests.
|
|
|
|
These objects are ignored in conceptual rows where the
|
|
pingCtlType instance does not equal pingIcmpEcho."
|
|
::= { rbnPingIp 1 }
|
|
|
|
rbnPingCtlIpEntry OBJECT-TYPE
|
|
SYNTAX RbnPingCtlIpEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A conceptual row in the rbnPingCtlIpTable."
|
|
AUGMENTS { pingCtlEntry }
|
|
::= { rbnPingCtlIpTable 1 }
|
|
|
|
RbnPingCtlIpEntry ::= SEQUENCE {
|
|
rbnPingCtlIpDontFragment TruthValue,
|
|
rbnPingCtlIpTtl Unsigned32
|
|
}
|
|
|
|
rbnPingCtlIpDontFragment OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Indicates whether the dont-fragment (DF) flag should be set
|
|
in the probe packet's IP header."
|
|
DEFVAL { false }
|
|
::= { rbnPingCtlIpEntry 1 }
|
|
|
|
rbnPingCtlIpTtl OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..255)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Specifies a time-to-live (TTL) value to use in the probe
|
|
packet's IP header."
|
|
DEFVAL { 255 }
|
|
::= { rbnPingCtlIpEntry 2 }
|
|
|
|
--
|
|
-- compliance statements
|
|
--
|
|
rbnPingCompliances OBJECT IDENTIFIER ::= { rbnPingConformance 1 }
|
|
rbnPingGroups OBJECT IDENTIFIER ::= { rbnPingConformance 2 }
|
|
|
|
rbnPingIpCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for SNMP entities which implement
|
|
the Redback Ping MIB for IPv4."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
rbnPingGlobalsGroup,
|
|
rbnPingResultsGroup,
|
|
rbnPingCtlGroup,
|
|
rbnPingIpGroup
|
|
}
|
|
::= { rbnPingCompliances 1 }
|
|
|
|
--
|
|
-- object groups
|
|
--
|
|
rbnPingGlobalsGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
rbnPingNumTests
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The collection of global objects for ping tests."
|
|
::= { rbnPingGroups 1 }
|
|
|
|
rbnPingResultsGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
rbnPingResultsJitter,
|
|
rbnPingHistoryIpTargetAddressType,
|
|
rbnPingHistoryIpTargetAddress,
|
|
rbnPingHistoryMinRtt,
|
|
rbnPingHistoryMaxRtt,
|
|
rbnPingHistoryAverageRtt,
|
|
rbnPingHistoryProbeResponses,
|
|
rbnPingHistorySentProbes,
|
|
rbnPingHistoryRttSumOfSquares,
|
|
rbnPingHistoryLastGoodProbe,
|
|
rbnPingHistoryJitter
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The collection of objects for ping test results."
|
|
::= { rbnPingGroups 2 }
|
|
|
|
rbnPingCtlGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
rbnPingCtlMaxHistoryRows
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The maximum number of corresponding entries allowed in
|
|
the rbnPingHistoryTable."
|
|
::= { rbnPingGroups 3 }
|
|
|
|
rbnPingIpGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
rbnPingCtlIpDontFragment,
|
|
rbnPingCtlIpTtl
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The collection of objects for executing a ping test over IPv4."
|
|
::= { rbnPingGroups 4 }
|
|
END
|