| OID symbolic | OID numeric | Type | Access | Description |
|---|
| docsDiagMib | 1.3.6.1.4.1.4491.2.1.9 | | | 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 diagnostic
triggers.
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. |
| docsDiagLogNotifications | 1.3.6.1.4.1.4491.2.1.9.0 | | | |
| NTF docsDiagLogSizeHighThrshldReached | 1.3.6.1.4.1.4491.2.1.9.0.1 | | | This notification indicates that the current size of
Diagnostic Log grows beyond
docsDiagLogNotifyLogSizeHighThrshld. |
| NTF docsDiagLogSizeLowThrshldReached | 1.3.6.1.4.1.4491.2.1.9.0.2 | | | This notification indicates that the current size of
Diagnostic Log drops to docsDiagLogNotifyLogSizeLowThrshld
after it exceeded docsDiagLogNotifyLogSizeHighThrshld
earlier. |
| NTF docsDiagLogSizeFull | 1.3.6.1.4.1.4491.2.1.9.0.3 | | | This notification indicates that the Diagnostic Log is
full. |
| docsDiagLogMibObjects | 1.3.6.1.4.1.4491.2.1.9.1 | | | |
| docsDiagLogGlobal | 1.3.6.1.4.1.4491.2.1.9.1.1 | | | |
| U32 docsDiagLogMaxSize | 1.3.6.1.4.1.4491.2.1.9.1.1.1 | Unsigned32 | read-write | The maximum number of Cable Modem entries that
docsDiagLogTable can report. |
| G32 docsDiagLogCurrentSize | 1.3.6.1.4.1.4491.2.1.9.1.1.2 | Gauge32 | read-only | The total number of Cable Modem entries reported in the
docsDiagLogTable.
The maximum value possible will be docsDiagLogMaxSize. |
| U32 docsDiagLogNotifyLogSizeHighThrshld | 1.3.6.1.4.1.4491.2.1.9.1.1.3 | Unsigned32 | read-write | If the number of entries in docsDiagLogTable exceeds
this value, CMTS will trigger the appropriate event. |
| U32 docsDiagLogNotifyLogSizeLowThrshld | 1.3.6.1.4.1.4491.2.1.9.1.1.4 | Unsigned32 | read-write | If the number of entries in docsDiagLogTable exceeded
docsDiagLogNotifyLogSizeHighThrshld earlier and then drops
to this value, CMTS will trigger the appropriate event. |
| U32 docsDiagLogAging | 1.3.6.1.4.1.4491.2.1.9.1.1.5 | Unsigned32 | read-write | Aging 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. |
| T/F docsDiagLogResetAll | 1.3.6.1.4.1.4491.2.1.9.1.1.6 | TruthValue | read-write | If set to 'true', all counter objects for
all entries in docsDiagLogTable and docsDiagLogDetailTable
are reset to zero. Reading this object always returns
'false'. |
| DAT docsDiagLogLastResetTime | 1.3.6.1.4.1.4491.2.1.9.1.1.7 | DateAndTime | read-only | The 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. |
| T/F docsDiagLogClearAll | 1.3.6.1.4.1.4491.2.1.9.1.1.8 | TruthValue | read-write | If set to 'true', all entries from the
docsDiagLogTable and docsDiagLogDetailTable are removed.
Reading this object always returns 'false'. |
| DAT docsDiagLogLastClearTime | 1.3.6.1.4.1.4491.2.1.9.1.1.9 | DateAndTime | read-only | The 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. |
| BIT docsDiagLogNotifCtrl | 1.3.6.1.4.1.4491.2.1.9.1.1.10 | Bits | read-write | Used 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. |
| docsDiagLogTriggersCfg | 1.3.6.1.4.1.4491.2.1.9.1.2 | | | |
| TRI docsDiagLogIncludeTriggers | 1.3.6.1.4.1.4491.2.1.9.1.2.1 | TriggerFlag | read-write | Turns 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 corresponding
diagnostic trigger. Setting a particular bit to '0' turns
off corresponding diagnostic trigger. |
| TRI docsDiagLogEnableAgingTriggers | 1.3.6.1.4.1.4491.2.1.9.1.2.2 | TriggerFlag | read-write | Enables 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. |
| U32 docsDiagLogRegTimeInterval | 1.3.6.1.4.1.4491.2.1.9.1.2.3 | Unsigned32 | read-write | Configurable 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. |
| REG docsDiagLogRegDetail | 1.3.6.1.4.1.4491.2.1.9.1.2.4 | RegistrationDetailFlag | read-write | Setting 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. |
| INT docsDiagLogRangingRetryType | 1.3.6.1.4.1.4491.2.1.9.1.2.5 | INTEGER | read-write | Configuration 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. |
| U32 docsDiagLogRangingRetryThrhld | 1.3.6.1.4.1.4491.2.1.9.1.2.6 | Unsigned32 | read-write | Configurable 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. |
| U32 docsDiagLogRangingRetryStationMaintNum | 1.3.6.1.4.1.4491.2.1.9.1.2.7 | Unsigned32 | read-write | Number 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. |
| docsDiagLogTable | 1.3.6.1.4.1.4491.2.1.9.1.3 | | not-accessible | This table keeps the Diagnostic Log of the Cable Modems,
it is indexed by docsIf3CmtsCmRegStatusId. |
| docsDiagLogEntry | 1.3.6.1.4.1.4491.2.1.9.1.3.1 | | not-accessible | A 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. |
| MAC docsDiagLogCmMacAddr | 1.3.6.1.4.1.4491.2.1.9.1.3.1.1 | MacAddress | read-only | MAC address of the Cable Modem. |
| DAT docsDiagLogLastUpdateTime | 1.3.6.1.4.1.4491.2.1.9.1.3.1.2 | DateAndTime | read-only | The 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. |
| DAT docsDiagLogCreateTime | 1.3.6.1.4.1.4491.2.1.9.1.3.1.3 | DateAndTime | read-only | The 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. |
| DAT docsDiagLogLastRegTime | 1.3.6.1.4.1.4491.2.1.9.1.3.1.4 | DateAndTime | read-only | The last time this Cable Modem registered. |
| C32 docsDiagLogRegCountEx | 1.3.6.1.4.1.4491.2.1.9.1.3.1.5 | Counter32 | read-only | The number of times the registration trigger condition was
detected for this Cable Modem. |
| C32 docsDiagLogRangingRetryCount | 1.3.6.1.4.1.4491.2.1.9.1.3.1.6 | Counter32 | read-only | The number of times the ranging retry trigger condition was
detected for this Cable Modem. |
| docsDiagLogDetailTable | 1.3.6.1.4.1.4491.2.1.9.1.4 | | not-accessible | This table contains detailed diagnostic information
for Cable Modems already in docsDiagLogTable. |
| docsDiagLogDetailEntry | 1.3.6.1.4.1.4491.2.1.9.1.4.1 | | not-accessible | A 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. |
| CMT docsDiagLogDetailTypeValue | 1.3.6.1.4.1.4491.2.1.9.1.4.1.1 | CmtsCmRegState | not-accessible | The diagnostic detail type this entry represents. |
| C32 docsDiagLogDetailCount | 1.3.6.1.4.1.4491.2.1.9.1.4.1.2 | Counter32 | read-only | The counter value of this Cable Modem that reached
this diagnostic detail state as the last state before
it failed to proceed further. |
| DAT docsDiagLogDetailLastUpdate | 1.3.6.1.4.1.4491.2.1.9.1.4.1.3 | DateAndTime | read-only | Time and date value when this entry was last updated. |
| STR docsDiagLogDetailLastErrorText | 1.3.6.1.4.1.4491.2.1.9.1.4.1.4 | SnmpAdminString | read-only | Contains the Event ID and Event Text of the event condition
that triggers this entry. The format is:
Event Text |
| docsDiagLogConformance | 1.3.6.1.4.1.4491.2.1.9.2 | | | |
| docsDiagLogCompliances | 1.3.6.1.4.1.4491.2.1.9.2.1 | | | |
| docsDiagLogCompliance | 1.3.6.1.4.1.4491.2.1.9.2.1.1 | | | The compliance statement for the diagnostic log MIB for
DOCSIS compliant Cable Modem Termination Systems |
| docsDiagLogGroups | 1.3.6.1.4.1.4491.2.1.9.2.2 | | | |
| docsDiagLogBaseGroup | 1.3.6.1.4.1.4491.2.1.9.2.2.1 | | | CMTS is required to support objects in this group |
| docsDiagLogNotificationGroup | 1.3.6.1.4.1.4491.2.1.9.2.2.2 | | | CMTS is required to support objects in this group |
