This MIB contains information about the traceroute (tracert) utility defined by RFC 4560 and the traceroute notifications. The traceroute utility is implemented by NQA UDP traceroute operations.

To implement DISMAN TRACEROUTE, the devices must support this MIB. This MIB cannot be used together with CLI.

Root object

iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).traceRouteMIB(81)

Scalar objects

traceRouteMaxConcurrentRequests

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteMaxConcurrentRequests (1.3.6.1.2.1.81.1.1)	read-only	Unsigned32	Standard MIB values.	Maximum number of concurrent active traceroute requests that are allowed within an agent implementation.	Same as ping MaxConcurrentRequests.

Tabular objects

traceRouteCtlTable

About this table

Use this table to define probe parameters for a traceroute operation.

Support for operations

Create	Edit/Modify	Delete	Read
· When create a traceroute operation entry, the default value of traceRouteCtlType is traceRouteUsingUdpProbes. At present, the traceRouteCtlType object supports only traceRouteUsingUdpProbes. · When create a traceroute operation entry, the values of the traceRouteCtlOwnerIndex and traceRouteCtlTestName objects must be different than the pingCtlOwnerIndex and pingCtlTestName objects.	· Modifying any object in the traceRouteCtlTable except the following objects will clear the corresponding probe results, history records, and statistics information: ¡ traceRouteCtlTrapGeneration. ¡ traceRouteCtlDescr. ¡ traceRouteCtlMaxRows. If the new value for this object is lower than the previous value, the system deletes the excessive history records. · You must specify traceRouteCtlTargetAddressType and traceRouteCtlTargetAddress in pairs in an SNMP request. · You must specify traceRouteCtlSourceAddressType and traceRouteCtlSourceAddress in pairs in an SNMP request. · When traceRouteCtlAdminStatus is enabled, you cannot change the configuration in the traceRouteCtlTable.	Supported	Supported

Create

Edit/Modify

Delete

Read

· When create a traceroute operation entry, the default value of traceRouteCtlType is traceRouteUsingUdpProbes. At present, the traceRouteCtlType object supports only traceRouteUsingUdpProbes.

· When create a traceroute operation entry, the values of the traceRouteCtlOwnerIndex and traceRouteCtlTestName objects must be different than the pingCtlOwnerIndex and pingCtlTestName objects.

· Modifying any object in the traceRouteCtlTable except the following objects will clear the corresponding probe results, history records, and statistics information:

¡ traceRouteCtlTrapGeneration.

¡ traceRouteCtlDescr.

¡ traceRouteCtlMaxRows. If the new value for this object is lower than the previous value, the system deletes the excessive history records.

· You must specify traceRouteCtlTargetAddressType and traceRouteCtlTargetAddress in pairs in an SNMP request.

· You must specify traceRouteCtlSourceAddressType and traceRouteCtlSourceAddress in pairs in an SNMP request.

· When traceRouteCtlAdminStatus is enabled, you cannot change the configuration in the traceRouteCtlTable.

Supported

Columns

The table indexes are traceRouteCtlOwnerIndex and traceRouteCtlTestName.

Table OID: 1.3.6.1.2.1.81.1.2.

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteCtlOwnerIndex (1.3.6.1.2.1.81.1.2.1.1)	not-accessible	SnmpAdminString	OCTET STRING (0..32)	Administrator name.	For the set operation, the uppercase letters in the value will be converted to lowercase letters. The value cannot contain a minus sign (-) or question mark (?).
traceRouteCtlTestName (1.3.6.1.2.1.81.1.2.1.2)	not-accessible	SnmpAdminString	OCTET STRING (0..32)	Operation tag.	For the set operation, the uppercase letters in the value will be converted to lowercase letters. The value cannot contain a minus sign (-) or question mark (?).
traceRouteCtlTargetAddressType (1.3.6.1.2.1.81.1.2.1.3)	read-create	InetAddressType	Standard MIB values.	Destination address type.	Supports only ipv4(1), dns(16), and unknown(0).
traceRouteCtlTargetAddress (1.3.6.1.2.1.81.1.2.1.4)	read-create	InetAddress	Standard MIB values.	Destination address.	If the value for the traceRouteCtlTargetAddressType object is ipv4(1), the value for this object must be an IPv4 address. If the value for the traceRouteCtlTargetAddressType object is dns(16), the value for this object can be a host name. If the value for the traceRouteCtlTargetAddressType object is unknown(0), the value for this object must be a zero-length string.
traceRouteCtlByPassRouteTable(1.3.6.1.2.1.81.1.2.1.5)	read-create	TruthValue	Standard MIB values.	Whether to bypass the routing table.	As per the MIB.
traceRouteCtlDataSize (1.3.6.1.2.1.81.1.2.1.6)	read-create	Unsigned32	Unsigned32 (0..65507)	Size of the data portion of a traceroute request, in octets.	Value range: 20 to 65507 octets. Default: 100 octets.
traceRouteCtlTimeOut (1.3.6.1.2.1.81.1.2.1.7)	read-create	Unsigned32	Unsigned32 (1-60)	Timeout time for waiting for a response to a probe request..	Same as the standard MIB file.
traceRouteCtlProbesPerHop (1.3.6.1.2.1.81.1.2.1.8)	read-create	Unsigned32	Unsigned32 (1-10)	Number of times to reissue a traceroute request with the same time-to-live (TTL) value.	Same as the standard MIB file..
traceRouteCtlPort (1.3.6.1.2.1.81.1.2.1.9)	read-create	Unsigned32	Unsigned32 (1-65535)	Destination port number.	Same as the standard MIB file.
traceRouteCtlMaxTtl (1.3.6.1.2.1.81.1.2.1.10)	read-create	Unsigned32	Unsigned32 (1-255)	Maximum TTL value.	Same as the standard MIB file.
traceRouteCtlDSField (1.3.6.1.2.1.81.1.2.1.11)	read-create	Unsigned32	Unsigned32 (0-255)	Service type.	As per the MIB.
traceRouteCtlSourceAddressType (1.3.6.1.2.1.81.1.2.1.12)	read-create	InetAddressType	Standard MIB values.	Source address type.	Supports only ipv4(1) and unknown(0). Default: unknown(0).
traceRouteCtlSourceAddress (1.3.6.1.2.1.81.1.2.1.13)	read-create	InetAddress	Standard MIB values.	Source address.	If the value for the traceRouteCtlSourceAddressType object is ipv4(1), the value for this object must be an IPV4 address. If the value for the traceRouteCtlSourceAddressType object is unknown(0), the value for this object must be a zero-length string.
traceRouteCtlIfIndex (1.3.6.1.2.1.81.1.2.1.14)	read-create	InterfaceIndexOrZero	Standard MIB values.	Output interface index.	Same as the standard MIB file.
traceRouteCtlMiscOptions (1.3.6.1.2.1.81.1.2.1.15)	read-create	SnmpAdminString	OCTET STRING (0..255)	Implementation-dependent options.	Value range: 0 to 200 characters. The corresponding function is not supported.
traceRouteCtlMaxFailures (1.3.6.1.2.1.81.1.2.1.16)	read-create	Unsigned32	Unsigned32 (0-255)	Maximum number of consecutive timeouts allowed before a remote traceroute request is terminated.	Same as the standard MIB file.
traceRouteCtlDontFragment (1.3.6.1.2.1.81.1.2.1.17)	read-create	TruthValue	Standard MIB values.	Whether to enable setting of the don't fragment flag (DF) in the IP header.	Same as the standard MIB file.
traceRouteCtlInitialTtl (1.3.6.1.2.1.81.1.2.1.18)	read-create	Unsigned32	Unsigned32 (1..255)	Initial TTL value.	Same as the standard MIB file.
traceRouteCtlFrequency (1.3.6.1.2.1.81.1.2.1.19)	read-create	Unsigned32	Standard MIB values.	Interval between two consecutive traceroute probes.	Value range: 0 to 604800 seconds. The return value for the read operation is not accurate if the value is not set to integer seconds at the CLI. For example, if the value configured at the CLI is 1050 milliseconds, the return value for the read operation will be 2 seconds. Default: 0 seconds.
traceRouteCtlStorageType (1.3.6.1.2.1.81.1.2.1.20)	read-create	StorageType	Standard MIB values.	Storage type.	As per the MIB.
traceRouteCtlAdminStatus (1.3.6.1.2.1.81.1.2.1.21)	read-create	INTEGER	enabled(1) disabled(2)	Operation status.	As per the MIB.
traceRouteCtlDescr (1.3.6.1.2.1.81.1.2.1.22)	read-create	SnmpAdminString	OCTET STRING (0..255)	Description string for the remote traceroute operation.	Value range: 0 to 200 characters. The value cannot start with a space.
traceRouteCtlMaxRows (1.3.6.1.2.1.81.1.2.1.23)	read-create	Unsigned32	Standard MIB values.	Maximum number of history records.	Value range: 0 to 50.
traceRouteCtlTrapGeneration (1.3.6.1.2.1.81.1.2.1.24)	read-create	BITS	BITS { pathChange(0), testFailure(1), testCompletion(2) }	Conditions to generate notifications.	As per the MIB.
traceRouteCtlCreateHopsEntries(1.3.6.1.2.1.81.1.2.1.25)	read-create	TruthValue	Standard MIB values.	Whether to generate the hop table.	As per the MIB.
traceRouteCtlType (1.3.6.1.2.1.81.1.2.1.26)	read-create	OBJECT IDENTIFIER	Standard MIB values.	Traceroute operation type.	This object cannot be edited after creation.
traceRouteCtlRowStatus (1.3.6.1.2.1.81.1.2.1.27)	read-create	RowStatus	Standard MIB values.	Row status.	Supports only active(1), createAndgo(4), and destroy(6).

traceRouteResultsTable

About this table

This table contains information about traceroute probe results.

Support for operations

Create	Edit/Modify	Delete	Read
Not supported	Not supported	Not supported	Supported

Columns

The table indexes are traceRouteCtlOwnerIndex and traceRouteCtlTestName.

Table OID: 1.3.6.1.2.1.81.1.3.

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteResultsOperStatus (1.3.6.1.2.1.81.1.3.1.1)	read-only	INTEGER	enabled(1) , disabled(2), completed(3)	Operation status of a remote traceroute operation.	As per the MIB.
traceRouteResultsCurHopCount (1.3.6.1.2.1.81.1.3.1.2)	read-only	Gauge32	Standard MIB values.	Current TTL value for the traceroute request.	As per the MIB.
traceRouteResultsCurProbeCount (1.3.6.1.2.1.81.1.3.1.3)	read-only	Gauge32	Standard MIB values.	Current probe count for the remote traceroute operation.	As per the MIB.
traceRouteResultsIpTgtAddrType (1.3.6.1.2.1.81.1.3.1.4)	read-only	InetAddressType	Standard MIB values.	Type of address stored in the corresponding traceRouteResultsIpTgtAddr object.	As per the MIB.
traceRouteResultsIpTgtAddr (1.3.6.1.2.1.81.1.3.1.5)	read-only	InetAddress	Standard MIB values.	IP address associated with a traceRouteCtlTargetAddress value when the destination address is specified as a DNS name.	As per the MIB.
traceRouteResultsTestAttempts (1.3.6.1.2.1.81.1.3.1.6)	read-only	Gauge32	Standard MIB values.	Current number of probe attempts.	As per the MIB.
traceRouteResultsTestSuccesses (1.3.6.1.2.1.81.1.3.1.7)	read-only	Gauge32	Standard MIB values.	Current number of succeeded probe attempts.	As per the MIB.
traceRouteResultsLastGoodPath (1.3.6.1.2.1.81.1.3.1.8)	read-only	DateAndTime	Standard MIB values.	Date and time when the last complete path was determined.	As per the MIB.

traceRouteProbeHistoryTable

About this table

Use this table to obtain history information about each probe in a traceroute operation.

Support for operations

Create	Edit/Modify	Delete	Read
Not supported	Not supported	Not supported	Supported

Columns

The table indexes are traceRouteCtlOwnerIndex, traceRouteCtlTestName, traceRouteProbeHistoryIndex, traceRouteProbeHistoryHopIndex, and traceRouteProbeHistoryProbeIndex.

Table OID: 1.3.6.1.2.1.81.1.4.

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteProbeHistoryIndex (1.3.6.1.2.1.81.1.4.1.1)	not-accessible	Unsigned32	Unsigned32 (1..'ffffffff'h)	History record index of a traceroute operation.	As per the MIB.
traceRouteProbeHistoryHopIndex (1.3.6.1.2.1.81.1.4.1.2)	not-accessible	Unsigned32	Unsigned32 (1-255)	Index of a hop in the record.	As per the MIB.
traceRouteProbeHistoryProbeIndex (1.3.6.1.2.1.81.1.4.1.3)	not-accessible	Unsigned32	Unsigned (1-10)	Index of a probe for the hop in the traceroute path.	As per the MIB.
traceRouteProbeHistoryHAddrType(1.3.6.1.2.1.81.1.4.1.4)	read-only	InetAddressType	Standard MIB values.	Type of address for the hop in the traceroute path.	As per the MIB.
traceRouteProbeHistoryHAddr (1.3.6.1.2.1.81.1.4.1.5)	read-only	InetAddress	Standard MIB values.	Address of the hop in the traceroute path.	As per the MIB.
traceRouteProbeHistoryResponse (1.3.6.1.2.1.81.1.4.1.6)	read-only	Unsigned32	Standard MIB values.	Amount of time measured in milliseconds from when the probe was sent to when its response was received or when it timed out.	As per the MIB.
traceRouteProbeHistoryStatus (1.3.6.1.2.1.81.1.4.1.7)	read-only	OperationResponseStatus	Standard MIB values.	Probe result.	As per the MIB.
traceRouteProbeHistoryLastRC (1.3.6.1.2.1.81.1.4.1.8)	read-only	Integer32	Standard MIB values.	The last implementation-method-specific reply code received.	As per the MIB.
traceRouteProbeHistoryTime (1.3.6.1.2.1.81.1.4.1.9)	read-only	DateAndTime	Standard MIB values.	Time when the probe result was determined.	As per the MIB.

traceRouteHopsTable

About this table

This table contains information about each hop in a traceroute path.

Support for operations

Create	Edit/Modify	Delete	Read
Not supported	Not supported	Not supported	Supported

Columns

The table indexes are traceRouteCtlOwnerIndex, traceRouteCtlTestName, and traceRouteHopsHopIndex.

Table OID: 1.3.6.1.2.1.81.1.5.

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteHopsHopIndex (1.3.6.1.2.1.81.1.5.1.1)	not-accessible	Unsigned32	Unsigned32 (1..4294967295)	Hop index.	As per the MIB.
traceRouteHopsIpTgtAddressType (1.3.6.1.2.1.81.1.5.1.2)	read-only	InetAddressType	Standard MIB values.	Destination address type.	As per the MIB.
traceRouteHopsIpTgtAddress (1.3.6.1.2.1.81.1.5.1.3)	read-only	InetAddress	Standard MIB values.	Destination address.	As per the MIB.
traceRouteHopsMinRtt (1.3.6.1.2.1.81.1.5.1.4)	read-only	Unsigned32	Standard MIB values.	Minimum bidirectional delay.	As per the MIB.
traceRouteHopsMaxRtt (1.3.6.1.2.1.81.1.5.1.5)	read-only	Unsigned32	Standard MIB values.	Maximum bidirectional delay.	As per the MIB.
traceRouteHopsAverageRtt (1.3.6.1.2.1.81.1.5.1.6)	read-only	Unsigned32	Standard MIB values.	Average bidirectional delay	As per the MIB.
traceRouteHopsRttSumOfSquares (1.3.6.1.2.1.81.1.5.1.7)	read-only	Unsigned32	Standard MIB values.	Sum of squares for delay.	As per the MIB.
traceRouteHopsSentProbes (1.3.6.1.2.1.81.1.5.1.8)	read-only	Unsigned32	Standard MIB values.	Number of sent probe packets.	As per the MIB.
traceRouteHopsProbeResponses (1.3.6.1.2.1.81.1.5.1.9)	read-only	Unsigned32	Standard MIB values.	Number of received probe reply packets.	As per the MIB.
traceRouteHopsLastGoodProbe (1.3.6.1.2.1.81.1.5.1.10)	read-only	DateAndTime	Standard MIB values.	Date and time when the last probe reply packet was received.	As per the MIB.

This notification is generated if the path obtained by the current traceroute operation is different from the path obtained by previous traceroute operations. The traceroute path changes if the value for the traceRouteCtlTrapGeneration object is pathChange(0).

Status control

ON

CLI: Use the reaction trap path-change command.

OFF

CLI: Use the undo reaction trap path-change command.

Objects

OID (object name)	Description	Index	Type	Value range
1.3.6.1.2.1.81.1.2.1.3 (traceRouteCtlTargetAddressType)	Destination address type.	No	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.2.1.4 (traceRouteCtlTargetAddress)	Destination address.	No	InetAddress	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.4 (traceRouteResultsIpTgtAddrType)	Destination address type in the probe result.	No	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.5 (traceRouteResultsIpTgtAddr)	Destination address in the probe result.	No	InetAddress	Standard MIB values.

This table does not contain indexes. For information about the index or indexes of a MIB object instance in an SNMP variable binding, see the section for that MIB object.

Recommended action

No action is required.

traceRouteTestFailed

Basic information

OID	Event	Type	Severity	Recovery notification	Default status
1.3.6.1.2.1.81.0.2	A traceroute operation failed.	Informational	N/A	N/A	OFF

Description

This notification is generated when a traceroute operation fails. A traceroute operation fails if the value for the traceRouteCtlTrapGeneration object is testFailure(1).

Status control

ON

CLI: Use the reaction trap test-failure [ accumulate-probe-failures ] command.

OFF

CLI: Use the undo reaction trap test-failure [ accumulate-probe-failures ] command.

Objects

OID (object name)	Description	Index	Type	Value range
1.3.6.1.2.1.81.1.2.1.3 (traceRouteCtlTargetAddressType)	Destination address type.	No	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.2.1.4 (traceRouteCtlTargetAddress)	Destination address.	No	InetAddress	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.4 (traceRouteResultsIpTgtAddrType)	Destination address type in the probe result.	No	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.5 (traceRouteResultsIpTgtAddr)	Destination address in the probe result.	No	InetAddress	Standard MIB values.

This table does not contain indexes. For information about the index or indexes of a MIB object instance in an SNMP variable binding, see the section for that MIB object.

Recommended action

No action is required.

traceRouteTestCompleted

Basic information

OID	Event	Type	Severity	Recovery notification	Default status
1.3.6.1.2.1.81.0.3	A traceroute operation completed.	Informational	N/A	N/A	OFF

Description

This notification is generated when a traceroute operation completes successfully. A traceroute operation completes successfully if the value for the traceRouteCtlTrapGeneration object is testCompletion(4).

Status control

ON

CLI: Use the reaction trap test-complete command.

OFF

CLI: Use the undo reaction trap test-complete command.

Objects

OID (object name)	Description	Index	Type	Value range
1.3.6.1.2.1.81.1.2.1.3 (traceRouteCtlTargetAddressType)	Destination address type.	No	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.2.1.4 (traceRouteCtlTargetAddress)	Destination address.	No	InetAddress	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.4 (traceRouteResultsIpTgtAddrType)	Destination address type in the probe result.	No	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.5 (traceRouteResultsIpTgtAddr)	Destination address in the probe result.	No	InetAddress	Standard MIB values.

This table does not contain indexes. For information about the index or indexes of a MIB object instance in an SNMP variable binding, see the section for that MIB object.

Recommended action

No action is required.

13-Network Management and Monitoring

About this table

Support for operations

Columns

About this table

Support for operations

Columns

About this table

Support for operations

Columns

About this table

Support for operations

Columns

ON

OFF

ON

OFF

ON

OFF

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us