USR-TRACEROUTE-MIB
AI MIB Summary
The USR-TRACEROUTE-MIB enables commWorks devices to expose and manage TraceRoute diagnostic session parameters, including hop sequence, round-trip latency, and packet loss statistics, via SNMP.
The commWorks enterprise defined MIB objects for TraceRoute
Main OID:
usrTraceroute.1.3.6.1.4.1.77.1.1.40
27
Objects
Active
Status
3
Dependencies
Imported Objects
Objects
27 total| Object Name |
|---|
usrTracerouteThe commWorks enterprise defined MIB objects for TraceRoute MODULE-IDENTITY .1.3.6.1.4.1.77.1.1.40 |
IMPORTSThe commWorks enterprise defined MIB objects for TraceRoute Unknown .1.3.6.1.4.1.77.1.1.40 |
usrTracerouteBase OBJECT IDENTIFIER .1.3.6.1.4.1.77.1.1.40.1 |
usrTracerouteIndexNextThis object contains an appropriate value that can be used for
'usrTracerouteIndex' when creating a new row in the Traceroute
Table'. If the value 0 is returned, it indicates that the table
contains the maximum number of rows and thus it is not possible to add
another one.ro Integer32 .1.3.6.1.4.1.77.1.1.40.1.1 |
usrTracerouteIndexNRowsNumber of rows currently present in the Traceroute table.ro Integer32 .1.3.6.1.4.1.77.1.1.40.1.2 |
usrTracerouteMaxRowsMaximum number of rows allowed in the Traceroute table.
Note that setting this object to a number which is smaller than the
current number of rows will NOT cause any row deletions - rather, the
effect of such an action will be noted in future attempts at row creation.rw Integer32 .1.3.6.1.4.1.77.1.1.40.1.3 |
usrTracerouteConfigFileNameThe name of a ConfigFile to read/write permanent database records.
If the value of this object is an empty string, then the Traceroute
process uses the default name `@file://TracerouteProcess.cfg'.ro DisplayString (SNMPv2-TC) .1.3.6.1.4.1.77.1.1.40.1.4 |
usrTracerouteCFMStatusFlagSetting the value of this object to `save' causes the values of the
Remote Ping Group to be written out to the current config file, which
is stored in the usrTracerouteConfigFileName object. While the new
ConfigFile is being written, the Remote Ping process will set the value
of this flag set to `saving''. Any attempts to set the value while it
is not `normal' (i.e. the file is currently being written to the
ConfigFile) while result in a badValue error being returned. Setting
the value to `normal' will result in no action.rw UsrConfigStatus .1.3.6.1.4.1.77.1.1.40.1.5 |
usrTracerouteTableA table of traceroute entries. SEQUENCE OF UsrTracerouteEntry .1.3.6.1.4.1.77.1.1.40.2 |
usrTracerouteEntryA list of fields defining this traceroute UsrTracerouteEntry .1.3.6.1.4.1.77.1.1.40.2.1 |
usrTracerouteIndexA unique index identifying this entry in the table. Integer32 .1.3.6.1.4.1.77.1.1.40.2.1.1 |
usrTracerouteDestinationThe host name or IP address (in dot notation) of the target
destination being traced by this row. A row cannot be activated
unless this object has a length greater than zero.
Router DNS services will always be used to resolve (names) and/or
verify addresses in dot notation. If DNS fails, the object
usrTracerouteRowState will indicate 'dnsFailed' or 'badAddress'.
This object cannot be modified whenever usrTracerouteRowStatus is
'active'.rw DisplayString .1.3.6.1.4.1.77.1.1.40.2.1.2 |
usrTracerouteResolvedIPAddressThe IP address resolved from the destination address string.
If an IP address was set in the destination field it will
be reflected here as well.
If an address cannot be resolved, this object returns zero and the
state field is set to dnsFailro IpAddress .1.3.6.1.4.1.77.1.1.40.2.1.3 |
usrTracerouteHopTimeoutAmount of time in seconds before retrying a hop. This object cannot
be modified whenever usrTracerouteRowStatus is 'active'.rw Integer32 .1.3.6.1.4.1.77.1.1.40.2.1.4 |
usrTracerouteHopProbesThe maixmum number of times to try to discern a hop before moving
on to the next hoprw Integer32 .1.3.6.1.4.1.77.1.1.40.2.1.5 |
usrTracerouteMaxHopsThe maixmum number of hops to trace before quitting.rw Integer32 .1.3.6.1.4.1.77.1.1.40.2.1.6 |
usrTracerouteUDPPortThe UDP port value to use when attempting to find the routerw Integer32 .1.3.6.1.4.1.77.1.1.40.2.1.7 |
usrTracerouteDataSizeThe maixmum number of hops to trace before quitting.rw Integer32 .1.3.6.1.4.1.77.1.1.40.2.1.8 |
usrTracerouteHopCountThe number of hops taken to get to the destination.ro Integer32 .1.3.6.1.4.1.77.1.1.40.2.1.9 |
usrTracerouteStateThe state of the 'traceroute' process associated with this row.
Before this row is activated, this object will have the value
'notActive(1)'.
Upon activation, if DNS resolution is needed, the object will
receive the value 'waitingDns(2)'. If DNS times out or otherwise
fails, this object will receive the value 'dnsFailed(3)'.
If the resolved IP address is not legal, this object value will be
'badAddress(4)'.
If the a timeout occurs or the hop count is exceeded, the value will
be 'hopTimeout(6)' or 'hopsExceeded(7)'.
If a route to the host could not be found, a 'destUnreachable(8)'
value will be returned.
If none of the above fails, the first traceroute command will be sent
and this object will indicate the value 'tracing(9)'.
After the completes this object will receive the value
completed(10)'.ro Enumeration .1.3.6.1.4.1.77.1.1.40.2.1.10 |
usrTracerouteRowStatusThis object is used to create, modify or delete a row in this table.
Setting this object to 'createAndWait' creates the row with default
values. Right after creation the value of this object will be
'notReady'.
When all parameters are given proper values, this object
will return the value 'notInService', at which point the client can
set the object to 'active' to activate the row.
Modifying this object from 'active' to 'notInService' will cancel any
on-going traceroute and remove entries for it from the usrTracerouteHopTable.
Setting the object to 'active' again will start a new traceroute with the
supplied parameters
Setting this object to 'destroy' will stop any on-going activity and
delete the row.rw RowStatus (SNMPv2-TC) .1.3.6.1.4.1.77.1.1.40.2.1.11 |
usrTracerouteHopTableA table of traceroute hop entries. SEQUENCE OF UsrTracerouteHopEntry .1.3.6.1.4.1.77.1.1.40.3 |
usrTracerouteHopEntryA list of fields containing the hop information for all traceroute instances UsrTracerouteHopEntry .1.3.6.1.4.1.77.1.1.40.3.1 |
usrTracerouteTableIndexThe index into the usrTracerouteTable corresponding to this hop. Integer32 .1.3.6.1.4.1.77.1.1.40.3.1.1 |
usrTracerouteHopIndexThe hop number corresponding to the usrTracerouteHopIPAddress in this row. Integer32 .1.3.6.1.4.1.77.1.1.40.3.1.2 |
usrTracerouteHopIPAddressThe IP address for a hop. An address of zero means that there was no response
from that hop.ro IpAddress .1.3.6.1.4.1.77.1.1.40.3.1.3 |
usrTracerouteHopRoundTripTimeRound trip time for this hop in milliseconds.ro Integer32 .1.3.6.1.4.1.77.1.1.40.3.1.4 |