DOCS-DIAG-MIB
AI MIB Summary
The DOCS-DIAG-MIB monitors DOCSIS Cable Modem Termination Systems (CMTS) to track Registration and Ranging Retry diagnostic triggers, which count specific cable modem behaviors indicative of network instability or service degradation. These counters enable fault management and troubleshooting by identifying modems exhibiting problematic registration or ranging patterns before they cause service interruptions.
This is the MIB Module for the Diagnostic Log for DOCSIS-compliant Cable Modem Termination Systems (CMTS).
The purpose of the Diagnostic Log is to prevent service interruptions by early detection of potential problems. It can also be used for fault management and for troubleshooting the cable network.
The Diagnostic Log contains Cable Modems that show certain potential problematic behaviors, as determined by the CMTS. These detection criteria are defined as diagnostictriggers.
The diagnostic trigger is an information filter to avoid inundating a management agent with data which is less meaningful as a function of size.
There are 2 diagnostic triggers defined. Each trigger maintains a counter for each Cable Modem that is caught by that trigger.
(1) Registration Trigger
(2) Ranging Retry Trigger
Copyright 1999-2007 Cable Television Laboratories, Inc. All rights reserved.
Main OID:
docsDiagMib.1.3.6.1.4.1.4491.2.1.9
43
Objects
Active
Status
7
Dependencies
Imported Objects
Objects
43 total| Object Name |
|---|
docsDiagMibThis is the MIB Module for the Diagnostic Log for
DOCSIS-compliant Cable Modem Termination Systems (CMTS).
The purpose of the Diagnostic Log is to prevent service
interruptions by early detection of potential problems.
It can also be used for fault management and for
troubleshooting the cable network.
The Diagnostic Log contains Cable Modems that show certain
potential problematic behaviors, as determined by the CMTS.
These detection criteria are defined as diagnostictriggers.
The diagnostic trigger is an information filter to avoid
inundating a management agent with data which is less
meaningful as a function of size.
There are 2 diagnostic triggers defined. Each trigger
maintains a counter for each Cable Modem that is caught
by that trigger.
(1) Registration Trigger
(2) Ranging Retry Trigger
Copyright 1999-2007 Cable Television Laboratories, Inc.
All rights reserved. MODULE-IDENTITY .1.3.6.1.4.1.4491.2.1.9 |
IMPORTSThis is the MIB Module for the Diagnostic Log for
DOCSIS-compliant Cable Modem Termination Systems (CMTS).
The purpose of the Diagnostic Log is to prevent service
interruptions by early detection of potential problems.
It can also be used for fault management and for
troubleshooting the cable network.
The Diagnostic Log contains Cable Modems that show certain
potential problematic behaviors, as determined by the CMTS.
These detection criteria are defined as diagnostictriggers.
The diagnostic trigger is an information filter to avoid
inundating a management agent with data which is less
meaningful as a function of size.
There are 2 diagnostic triggers defined. Each trigger
maintains a counter for each Cable Modem that is caught
by that trigger.
(1) Registration Trigger
(2) Ranging Retry Trigger
Copyright 1999-2007 Cable Television Laboratories, Inc.
All rights reserved. NOTIFICATION-TYPE .1.3.6.1.4.1.4491.2.1.9 |
docsDiagLogNotifications OBJECT IDENTIFIER .1.3.6.1.4.1.4491.2.1.9.0 |
docsDiagLogSizeHighThrshldReachedThis notification indicates that the current size of
Diagnostic Log grows beyond
docsDiagLogNotifyLogSizeHighThrshld. NOTIFICATION-TYPE .1.3.6.1.4.1.4491.2.1.9.0.1 |
docsDiagLogSizeLowThrshldReachedThis notification indicates that the current size of
Diagnostic Log drops to docsDiagLogNotifyLogSizeLowThrshld
after it exceeded docsDiagLogNotifyLogSizeHighThrshld
earlier. NOTIFICATION-TYPE .1.3.6.1.4.1.4491.2.1.9.0.2 |
docsDiagLogSizeFullThis notification indicates that the Diagnostic Log is
full. NOTIFICATION-TYPE .1.3.6.1.4.1.4491.2.1.9.0.3 |
docsDiagLogMibObjects OBJECT IDENTIFIER .1.3.6.1.4.1.4491.2.1.9.1 |
docsDiagLogGlobal OBJECT IDENTIFIER .1.3.6.1.4.1.4491.2.1.9.1.1 |
docsDiagLogMaxSizeThe maximum number of Cable Modem entries that
docsDiagLogTable can report.rw Unsigned32 .1.3.6.1.4.1.4491.2.1.9.1.1.1 |
docsDiagLogCurrentSizeThe total number of Cable Modem entries reported in the
docsDiagLogTable.
The maximum value possible will be docsDiagLogMaxSize.ro Gauge32 .1.3.6.1.4.1.4491.2.1.9.1.1.2 |
docsDiagLogNotifyLogSizeHighThrshldIf the number of entries in docsDiagLogTable exceeds
this value, CMTS will trigger the appropriate event.rw Unsigned32 .1.3.6.1.4.1.4491.2.1.9.1.1.3 |
docsDiagLogNotifyLogSizeLowThrshldIf the number of entries in docsDiagLogTable exceeded
docsDiagLogNotifyLogSizeHighThrshld earlier and then drops
to this value, CMTS will trigger the appropriate event.rw Unsigned32 .1.3.6.1.4.1.4491.2.1.9.1.1.4 |
docsDiagLogAgingAging threshold for the Diagnostic Log. Periodically, a
process scans through the Diagnostic log and removes those
Cable Modems from docsDiagLogTable and
docsDiagLogDetailTable that have no new detections for a
time interval longer than this threshold in minutes.rw Unsigned32 .1.3.6.1.4.1.4491.2.1.9.1.1.5 |
docsDiagLogResetAllIf set to 'true', all counter objects for
all entries in docsDiagLogTable and docsDiagLogDetailTable
are reset to zero. Reading this object always returns
'false'.rw TruthValue (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.1.6 |
docsDiagLogLastResetTimeThe last time that all the counters in the
docsDiagLogTable and docsDiagLogDetailTable are
reset to 0. The special value of all '00'Hs indicates
that the Entries in these tables have never been reset.ro DateAndTime (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.1.7 |
docsDiagLogClearAllIf set to 'true', all entries from the
docsDiagLogTable and docsDiagLogDetailTable are removed.
Reading this object always returns 'false'.rw TruthValue (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.1.8 |
docsDiagLogLastClearTimeThe last time that all the entries in the docsDiagLogTable
and docsDiagLogDetailTable are destroyed. The special
value of all '00'Hs indicates that the
entries in these tables have never been destroyed.ro DateAndTime (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.1.9 |
docsDiagLogNotifCtrlUsed to enable diagnostic log related notifications.
Setting bit 0 enables notification for reaching log size
high threshold,
Setting bit 1 enables notification for returning back to
log size low threshold after reaching log size high
threshold,
Setting bit 2 enables notification for diagnostic log size
full.rw Bits .1.3.6.1.4.1.4491.2.1.9.1.1.10 |
docsDiagLogTriggersCfg OBJECT IDENTIFIER .1.3.6.1.4.1.4491.2.1.9.1.2 |
docsDiagLogIncludeTriggersTurns individual diagnostic triggers on and off.
Multiple triggers can be turned on or off at a given time.
Setting a particular bit to '1' turns on correspon
dingdiagnostic trigger. Setting a particular bit to '0' turns
off corresponding diagnostic trigger.rw TriggerFlag .1.3.6.1.4.1.4491.2.1.9.1.2.1 |
docsDiagLogEnableAgingTriggersEnables and disables the aging of triggers
based on the trigger type. Aging out can be enabled or
disabled for multiple triggers at a given time. Setting
a particular bit to '1' enables the aging out of log
entries that are created by corresponding diagnostic
trigger. Setting a particular bit to '0' disables the
aging out of log entries that are created by corresponding
diagnostic trigger.rw TriggerFlag .1.3.6.1.4.1.4491.2.1.9.1.2.2 |
docsDiagLogRegTimeIntervalConfigurable parameter for the Registration trigger.
The registration time interval is an empirically derived,
worst-case number of seconds which the Cable Modem requires
to complete registration. If the Cable Modem has not
completed the registration stage within this registration
time interval, the Cable Modem will be added to the
Diagnostic Log.rw Unsigned32 .1.3.6.1.4.1.4491.2.1.9.1.2.3 |
docsDiagLogRegDetailSetting a bit representing a CM registration state will
enable counting the number of times the CMTS determines
that such CM reaches that state as the last state before
failing to proceed further in the registration process and
within the time interval considered for the CM
registration trigger detection.rw RegistrationDetailFlag .1.3.6.1.4.1.4491.2.1.9.1.2.4 |
docsDiagLogRangingRetryTypeConfiguration parameter for the Ranging Retry Trigger.
When a Cable Modem failed to perform ranging when a ranging
opportunity is scheduled by CMTS, it is counted as ranging
miss.
Ranging retry trigger can be configured to either look at
consecutive ranging misses or ranging miss ratio over
total number of station maintenance opportunities for a
certain time period.
If set to '1', this will select consecutive ranging
misses as ranging retry trigger criteria.
If set to '2', this will select ranging miss ratio
as ranging retry trigger criteria.rw Enumeration .1.3.6.1.4.1.4491.2.1.9.1.2.5 |
docsDiagLogRangingRetryThrhldConfigurable parameter for the Ranging Retry Trigger.
When the number of times a Cable Modem does not acknowledge
a MAC-layer station maintenance message from a CMTS exceeds
this threshold, the Cable Modem will be add to the
Diagnostic Log.
The value of docsDiagLogRangingRetryType, decides if
consecutive ranging miss or ranging miss ratio is used as
trigger.rw Unsigned32 .1.3.6.1.4.1.4491.2.1.9.1.2.6 |
docsDiagLogRangingRetryStationMaintNumNumber of station maintenance opportunities to monitor for
ranging retry trigger. This value implies time intervals
in a certain range. DOCSIS requires the CMTS to schedule
ranging opportunity to Cable Modem sufficiently smaller
than T4.
There is no fixed formula to derive at a fixed time
interval, how many ranging opportunities would be offered
to a Cable Modem by the CMTS, hence using the number of
station maintenance opportunities provides ratio with the
fixed denominators while also taking time factor into
consideration.rw Unsigned32 .1.3.6.1.4.1.4491.2.1.9.1.2.7 |
docsDiagLogTableThis table keeps the Diagnostic Log of the Cable Modems,
it is indexed by docsIf3CmtsCmRegStatusId. SEQUENCE OF DocsDiagLogEntry .1.3.6.1.4.1.4491.2.1.9.1.3 |
docsDiagLogEntryA conceptual row entry in this table is a per Cable Modem
summary of the diagnostic information detected by one or
more triggers.
There can be only one entry in this for a given Cable
Modem. DocsDiagLogEntry .1.3.6.1.4.1.4491.2.1.9.1.3.1 |
docsDiagLogCmMacAddrMAC address of the Cable Modem.ro MacAddress (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.3.1.1 |
docsDiagLogLastUpdateTimeThe time and date value when this entry was last updated.
When a Cable Modem is detected by one of the diagnostic
trigger, if this table already has an entry for that
Cable Modem, the entry will be updated.ro DateAndTime (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.3.1.2 |
docsDiagLogCreateTimeThe time and date value that this entry was added to this
table. When a Cable Modem is detected by one of the
diagnostic triggers, if this table has no entry for that
cable mode, a new entry will be created. If an entry is
removed and then re-added, there can be a discontinuity in
the statistical objects associated with this entry.
This timestamp can be used to detect those discontinuities.ro DateAndTime (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.3.1.3 |
docsDiagLogLastRegTimeThe last time this Cable Modem registered.ro DateAndTime (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.3.1.4 |
docsDiagLogRegCountThe number of times the registration trigger condition was
detected for this Cable Modem.ro Counter32 .1.3.6.1.4.1.4491.2.1.9.1.3.1.5 |
docsDiagLogRangingRetryCountThe number of times the ranging retry trigger condition was
detected for this Cable Modem.ro Counter32 .1.3.6.1.4.1.4491.2.1.9.1.3.1.6 |
docsDiagLogDetailTableThis table contains detailed diagnostic information
for Cable Modems already in docsDiagLogTable. SEQUENCE OF DocsDiagLogDetailEntry .1.3.6.1.4.1.4491.2.1.9.1.4 |
docsDiagLogDetailEntryA conceptual row in this table contains one single type of
detailed diagnostic information for a Cable Modem.
This table shall be instantiated only if at least one
detail condition is enabled, via docsDiagLogRegDetail.
There can be multiple entries in this table for a given
cable modem, if more than one detail condition is enabled. DocsDiagLogDetailEntry .1.3.6.1.4.1.4491.2.1.9.1.4.1 |
docsDiagLogDetailTypeValueThe diagnostic detail type this entry represents. CmtsCmRegState (DOCS-IF3-MIB) .1.3.6.1.4.1.4491.2.1.9.1.4.1.1 |
docsDiagLogDetailCountThe counter value of this Cable Modem that reached
this diagnostic detail state as the last state before
it failed to proceed further.ro Counter32 .1.3.6.1.4.1.4491.2.1.9.1.4.1.2 |
docsDiagLogDetailLastUpdateTime and date value when this entry was last updated.ro DateAndTime (SNMPv2-TC) .1.3.6.1.4.1.4491.2.1.9.1.4.1.3 |
docsDiagLogDetailLastErrorTextContains the Event ID and Event Text of the event condition
that triggers this entry. The format is:
<Event ID> Event Textro SnmpAdminString (SNMP-FRAMEWORK-MIB) .1.3.6.1.4.1.4491.2.1.9.1.4.1.4 |
docsDiagLogConformance OBJECT IDENTIFIER .1.3.6.1.4.1.4491.2.1.9.2 |
docsDiagLogCompliances OBJECT IDENTIFIER .1.3.6.1.4.1.4491.2.1.9.2.1 |
docsDiagLogGroups OBJECT IDENTIFIER .1.3.6.1.4.1.4491.2.1.9.2.2 |