Standard view Table view

DOCS-DIAG-MIB

        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.

Source file: DOCS-DIAG-MIB
Last revised: 7 Dec 2006, 00:00 UTC
Identity: docsDiagMib
Base OID: 1.3.6.1.4.1.4491.2.1.9

Imported Objects

CLAB-DEF-MIB	clabProjDocsis
DOCS-CABLE-DEVICE-MIB	docsDevEvId docsDevEvLevel
DOCS-IF3-MIB	CmtsCmRegState docsIf3CmtsCmRegStatusId
SNMP-FRAMEWORK-MIB	SnmpAdminString
SNMPv2-CONF	MODULE-COMPLIANCE (no object page) NOTIFICATION-GROUP (no object page) OBJECT-GROUP (no object page)
SNMPv2-SMI	Counter32 Gauge32 MODULE-IDENTITY (no object page) NOTIFICATION-TYPE (no object page) OBJECT-TYPE (no object page) Unsigned32
SNMPv2-TC	DateAndTime MacAddress TEXTUAL-CONVENTION (no object page) TruthValue

Net-SNMP examples using the rfc MIB directory Show commands

These commands use the standard Observium installation path and load the selected MIB variant before the RFC and Net-SNMP directories.

Translate the module identity

/usr/bin/snmptranslate -Pud -Ir -On -m 'DOCS-DIAG-MIB' -M '/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'DOCS-DIAG-MIB::docsDiagMib'

Walk the MIB subtree

/usr/bin/snmpbulkwalk -v2c -c '<community>' -Pud -Ir -OQUs -m 'DOCS-DIAG-MIB' -M '/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'udp:<hostname>:161' 'DOCS-DIAG-MIB::docsDiagMib'

How SNMP, Net-SNMP, MIB paths, and variants work

Objects (39)

docsDiagMib		`.1.3.6.1.4.1.4491.2.1.9`
docsDiagLogNotifications		`.1.3.6.1.4.1.4491.2.1.9.0`
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`
docsDiagLogMaxSize r/w	entriesUnsigned32	`.1.3.6.1.4.1.4491.2.1.9.1.1.1`
docsDiagLogNotifCtrl r/w	Bits	`.1.3.6.1.4.1.4491.2.1.9.1.1.10`
docsDiagLogCurrentSize	entriesUnsigned32	`.1.3.6.1.4.1.4491.2.1.9.1.1.2`
docsDiagLogNotifyLogSizeHighThrshld r/w	entriesUnsigned32	`.1.3.6.1.4.1.4491.2.1.9.1.1.3`
docsDiagLogNotifyLogSizeLowThrshld r/w	entriesUnsigned32	`.1.3.6.1.4.1.4491.2.1.9.1.1.4`
docsDiagLogAging r/w	minutesUnsigned32	`.1.3.6.1.4.1.4491.2.1.9.1.1.5`
docsDiagLogResetAll r/w	SNMPv2-TCTruthValue	`.1.3.6.1.4.1.4491.2.1.9.1.1.6`
docsDiagLogLastResetTime	SNMPv2-TCDateAndTime	`.1.3.6.1.4.1.4491.2.1.9.1.1.7`
docsDiagLogClearAll r/w	SNMPv2-TCTruthValue	`.1.3.6.1.4.1.4491.2.1.9.1.1.8`
docsDiagLogLastClearTime	SNMPv2-TCDateAndTime	`.1.3.6.1.4.1.4491.2.1.9.1.1.9`
docsDiagLogTriggersCfg		`.1.3.6.1.4.1.4491.2.1.9.1.2`
docsDiagLogIncludeTriggers r/w	TriggerFlag	`.1.3.6.1.4.1.4491.2.1.9.1.2.1`
docsDiagLogEnableAgingTriggers r/w	TriggerFlag	`.1.3.6.1.4.1.4491.2.1.9.1.2.2`
docsDiagLogRegTimeInterval r/w	secondsUnsigned32	`.1.3.6.1.4.1.4491.2.1.9.1.2.3`
docsDiagLogRegDetail r/w	RegistrationDetailFlag	`.1.3.6.1.4.1.4491.2.1.9.1.2.4`
docsDiagLogRangingRetryType r/w	Enumeration	`.1.3.6.1.4.1.4491.2.1.9.1.2.5`
docsDiagLogRangingRetryThrhld r/w	Unsigned32	`.1.3.6.1.4.1.4491.2.1.9.1.2.6`
docsDiagLogRangingRetryStationMaintNum r/w	Unsigned32	`.1.3.6.1.4.1.4491.2.1.9.1.2.7`
docsDiagLogTable		`.1.3.6.1.4.1.4491.2.1.9.1.3`
docsDiagLogEntry	DOCS-IF3-MIBdocsIf3CmtsCmRegStatusId	`.1.3.6.1.4.1.4491.2.1.9.1.3.1`
docsDiagLogCmMacAddr	SNMPv2-TCMacAddress	`.1.3.6.1.4.1.4491.2.1.9.1.3.1.1`
docsDiagLogLastUpdateTime	SNMPv2-TCDateAndTime	`.1.3.6.1.4.1.4491.2.1.9.1.3.1.2`
docsDiagLogCreateTime	SNMPv2-TCDateAndTime	`.1.3.6.1.4.1.4491.2.1.9.1.3.1.3`
docsDiagLogLastRegTime	SNMPv2-TCDateAndTime	`.1.3.6.1.4.1.4491.2.1.9.1.3.1.4`
docsDiagLogRegCount	SNMPv2-SMICounter32	`.1.3.6.1.4.1.4491.2.1.9.1.3.1.5`
docsDiagLogRangingRetryCount	SNMPv2-SMICounter32	`.1.3.6.1.4.1.4491.2.1.9.1.3.1.6`
docsDiagLogDetailTable		`.1.3.6.1.4.1.4491.2.1.9.1.4`
docsDiagLogDetailEntry	DOCS-IF3-MIBdocsIf3CmtsCmRegStatusIddocsDiagLogDetailTypeValue	`.1.3.6.1.4.1.4491.2.1.9.1.4.1`
docsDiagLogDetailTypeValue	DOCS-IF3-MIBCmtsCmRegState	`.1.3.6.1.4.1.4491.2.1.9.1.4.1.1`
docsDiagLogDetailCount	SNMPv2-SMICounter32	`.1.3.6.1.4.1.4491.2.1.9.1.4.1.2`
docsDiagLogDetailLastUpdate	SNMPv2-TCDateAndTime	`.1.3.6.1.4.1.4491.2.1.9.1.4.1.3`
docsDiagLogDetailLastErrorText	SNMP-FRAMEWORK-MIBSnmpAdminString	`.1.3.6.1.4.1.4491.2.1.9.1.4.1.4`
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`
docsDiagLogGroups		`.1.3.6.1.4.1.4491.2.1.9.2.2`

Dependencies (25) 7 direct · 18 transitive Show tree and compile order Hide dependency details

Each imported module is resolved in the importing module's source directory first, then through the normal default-variant rules.

Dependency tree

DOCS-DIAG-MIBrfcselected
- CLAB-DEF-MIBrfc1 symbol
  - DOCS-IETF-BPI2-MIBrfc1 symbol
    - IF-MIBrfc1 symbol
      - IANAifType-MIBrfc1 symbol
        SNMPv2-SMIrfc2 symbols
        SNMPv2-TCrfc1 symbol
        SNMPv2-SMIrfcshared1 symbol
      - SNMPv2-CONFrfc3 symbols
        SNMPv2-SMIrfcshared3 symbols
      - SNMPv2-MIBrfc1 symbol
        SNMPv2-CONFrfcshared3 symbols
        SNMPv2-SMIrfcshared7 symbols
        SNMPv2-TCrfcshared3 symbols
      - SNMPv2-SMIrfcshared9 symbols
      - SNMPv2-TCrfcshared8 symbols
    - INET-ADDRESS-MIBrfc2 symbols
      - SNMPv2-SMIrfcshared3 symbols
      - SNMPv2-TCrfcshared1 symbol
    - SNMP-FRAMEWORK-MIBrfc1 symbol
      - SNMPv2-CONFrfcshared2 symbols
      - SNMPv2-SMIrfcshared4 symbols
      - SNMPv2-TCrfcshared1 symbol
    - SNMPv2-CONFrfcshared2 symbols
    - SNMPv2-SMIrfcshared6 symbols
    - SNMPv2-TCrfcshared6 symbols
  - SNMPv2-SMIrfcshared3 symbols
  - SNMPv2-TCrfcshared1 symbol
- DOCS-CABLE-DEVICE-MIBrfc2 symbols
  - DIFFSERV-MIBrfc23 symbols
    - DIFFSERV-DSCP-TCrfc2 symbols
      - SNMPv2-SMIrfcshared3 symbols
      - SNMPv2-TCrfcshared1 symbol
    - IF-MIBrfcshared3 symbols
    - INET-ADDRESS-MIBrfcshared4 symbols
    - INTEGRATED-SERVICES-MIBrfc1 symbol
      - IF-MIBrfcshared2 symbols
      - SNMPv2-CONFrfcshared2 symbols
      - SNMPv2-SMIrfcshared6 symbols
      - SNMPv2-TCrfcshared4 symbols
    - SNMPv2-CONFrfcshared2 symbols
    - SNMPv2-SMIrfcshared7 symbols
    - SNMPv2-TCrfcshared5 symbols
  - IF-MIBrfcshared1 symbol
  - INET-ADDRESS-MIBrfcshared2 symbols
  - RMON2-MIBrfc1 symbol
    - IF-MIBrfcshared1 symbol
    - RMON-MIBrfc12 symbols
      - SNMPv2-CONFrfcshared3 symbols
      - SNMPv2-SMIrfcshared8 symbols
      - SNMPv2-TCrfcshared2 symbols
    - SNMPv2-CONFrfcshared2 symbols
    - SNMPv2-SMIrfcshared8 symbols
    - SNMPv2-TCrfcshared4 symbols
    - TOKEN-RING-RMON-MIBrfc5 symbols
      - RFC-1212rfc1 symbol
      - RFC1155-SMIrfc2 symbols
      - RFC1271-MIBrfc5 symbols
        RFC-1212rfcshared1 symbol
        RFC1155-SMIrfcshared1 symbol
        RFC1213-MIBrfc1 symbol
        IANAifType-MIBrfcshared1 symbol
        RFC-1212rfcshared1 symbol
        RFC1155-SMIrfcshared6 symbols
  - SNMP-FRAMEWORK-MIBrfcshared1 symbol
  - SNMPv2-CONFrfcshared2 symbols
  - SNMPv2-SMIrfcshared8 symbols
  - SNMPv2-TCrfcshared5 symbols
- DOCS-IF3-MIBrfc2 symbols
  - CLAB-DEF-MIBrfcshared1 symbol
  - CLAB-TOPO-MIBrfc1 symbol
    - CLAB-DEF-MIBrfcshared1 symbol
    - IF-MIBrfcshared1 symbol
    - SNMP-FRAMEWORK-MIBrfcshared1 symbol
    - SNMPv2-CONFrfcshared2 symbols
    - SNMPv2-SMIrfcshared2 symbols
    - SNMPv2-TCrfcshared2 symbols
  - DOCS-CABLE-DEVICE-MIBrfcshared4 symbols
  - DOCS-IF-MIBrfc5 symbols
    - IANAifType-MIBrfcshared1 symbol
    - IF-MIBrfcshared2 symbols
    - INET-ADDRESS-MIBrfcshared2 symbols
    - SNMPv2-CONFrfcshared2 symbols
    - SNMPv2-SMIrfcshared9 symbols
    - SNMPv2-TCrfcshared7 symbols
  - IF-MIBrfcshared3 symbols
  - INET-ADDRESS-MIBrfcshared2 symbols
  - SNMP-FRAMEWORK-MIBrfcshared1 symbol
  - SNMP-TARGET-MIBrfc1 symbol
    - SNMP-FRAMEWORK-MIBrfcshared4 symbols
    - SNMPv2-CONFrfcshared2 symbols
    - SNMPv2-SMIrfcshared5 symbols
    - SNMPv2-TCrfcshared7 symbols
  - SNMPv2-CONFrfcshared3 symbols
  - SNMPv2-MIBrfcshared1 symbol
  - SNMPv2-SMIrfcshared6 symbols
  - SNMPv2-TCrfcshared6 symbols
- SNMP-FRAMEWORK-MIBrfcshared1 symbol
- SNMPv2-CONFrfcshared3 symbols
- SNMPv2-SMIrfcshared6 symbols
- SNMPv2-TCrfcshared4 symbols

Dependency-first compile order

Type Definitions (2)

RegistrationDetailFlag	Bits	`other(0)` `initialRanging(1)` `rangingAutoAdjComplete(2)` `startEae(3)` `startDhcpv4(4)` `startDhcpv6(5)` `dhcpv4Complete(6)` `dhcpv6Complete(7)` `startConfigFileDownload(8)` `configFileDownloadComplete(9)` `startRegistration(10)` `registrationCmplete(11)` `bpiInit(12)` `operational(13)`
TriggerFlag	Bits	`registration(0)` `rangingRetry(1)`

Conformance Groups (2)

docsDiagLogBaseGroup	docsDiagLogMaxSize docsDiagLogCurrentSize docsDiagLogNotifyLogSizeHighThrshld docsDiagLogNotifyLogSizeLowThrshld docsDiagLogAging docsDiagLogResetAll docsDiagLogLastResetTime docsDiagLogClearAll docsDiagLogLastClearTime docsDiagLogNotifCtrl docsDiagLogIncludeTriggers docsDiagLogEnableAgingTriggers docsDiagLogRegTimeInterval docsDiagLogRegDetail docsDiagLogRangingRetryType docsDiagLogRangingRetryThrhld docsDiagLogRangingRetryStationMaintNum docsDiagLogCmMacAddr docsDiagLogLastUpdateTime docsDiagLogCreateTime docsDiagLogLastRegTime docsDiagLogRegCount docsDiagLogRangingRetryCount docsDiagLogDetailCount docsDiagLogDetailLastUpdate docsDiagLogDetailLastErrorText CMTS is required to support objects in this group	`.1.3.6.1.4.1.4491.2.1.9.2.2.1`
docsDiagLogNotificationGroup	docsDiagLogSizeHighThrshldReached docsDiagLogSizeLowThrshldReached docsDiagLogSizeFull CMTS is required to support objects in this group	`.1.3.6.1.4.1.4491.2.1.9.2.2.2`

Compliance Statements (1)

OID .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

Required groups

optional	docsDiagLogBaseGroup	Mandatary in all CMTSes
optional	docsDiagLogNotificationGroup	Mandatary in all CMTSes

Notifications / Traps (3)

Name	OID	Description
docsDiagLogSizeHighThrshldReached DOCS-CABLE-DEVICE-MIBdocsDevEvLevel DOCS-CABLE-DEVICE-MIBdocsDevEvId docsDiagLogIncludeTriggers docsDiagLogMaxSize	`.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.
docsDiagLogSizeLowThrshldReached DOCS-CABLE-DEVICE-MIBdocsDevEvLevel DOCS-CABLE-DEVICE-MIBdocsDevEvId docsDiagLogIncludeTriggers docsDiagLogMaxSize	`.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.
docsDiagLogSizeFull DOCS-CABLE-DEVICE-MIBdocsDevEvLevel DOCS-CABLE-DEVICE-MIBdocsDevEvId docsDiagLogIncludeTriggers docsDiagLogMaxSize	`.1.3.6.1.4.1.4491.2.1.9.0.3`	This notification indicates that the Diagnostic Log is full.