SNMP MIB for Timing on Routing Platforms

This topic talks about the Junos OS and Junos OS Evolved support for SNMP get, get-next, and walk management capabilities for timing features.

Junos OS and Junos OS Evolved support SNMP get, get-next, and walk management capabilities for timing features. These capabilities are enabled through the PTP MIB, SyncE MIB and GPS MIB timing objects.

Note:

The PTP MIB and SyncE MIB timing objects are grouped under the jnxTimingNotfObjects SNMP MIB object.

Table 1 shows the list of SNMP MIB objects supported for SNMP get, get-next, and walk management.

Table 1: SNMP MIB Objects for get, get-next, and walk management
SNMP MIB	Object	Description
PTP MIB	jnxPtpServoState	Denotes the following PTP Servo states: INITIALIZING ACQUIRING PHASE ALIGNED FREERUN HOLDOVER FREQUENCY LOCKED
	jnxPtpServoStateStr	Denotes the PTP Servo state string: INITIALIZING ACQUIRING (TimeTransmitter is elected and servo starts acquiring lock) PHASE ALIGNED (Locked to TimeTransmitter) FREERUN (no PTP source available) HOLDOVER (Member locked to PTP for more than 12 hours and then loses all the PTP sources)
	jnxPtpClass	Denotes the class of the PTP grandmaster clock.
	jnxPtpGmId	Denotes the PTP grandmaster clock identifier.
	jnxPtpPerformanceTable	PTP performance table to get the performance of the active PTP timeReceiver port.
	jnxPtpStatisticsTable	PTP statistics table to display the statistics of active PTP timeReceiver port.
	jnxPtpPassivePortMonitorTable	PTP performance table to get the performance of PTP passive ports.
	jnxPtpPassivePortMonitorDelayRequestInterval	Provides a through configuration.
	jnxPtpPassivePortMonitorEnabled	Indicates if the configurarion is enabled or disabled.
	jnxPtpPerformanceMonitorEnabled	Indicates if the configurarion is enabled or disabled.
	jnxPtpStatisticsAnnouncedFromAllForeignMasters	Counter indicating the total number of announce messages from the foreign masters that have been received for each 15 minutes and 24 hours interval.
	jnxPtpPhaseErrorRelativeThreshold	Indicates the currently configured phase-monitoring threshold.
	Following MIBs are specific for the Phase Adjustment Mitigation feature supported platforms:
	jnxPtpPhaseMonitoringPtpIntfName	Indicates the name of the PTP interface being monitored for the Phase Adjustment Mitigation feature. This is not present if the interface is not being monitored.
	jnxPtpPhaseMonitoringSynceIntfName	The name of the locked SyncE interface while the phase is being monitored. If SyncE is in holdover due to the Phase Adjustment Mitigation feature, this displays the locked SyncE interface prior to holdover start. This is not present if phase is not being monitored, `force-synce-holdover` knob is not configured, or SyncE is not locked.
	jnxPtpPhaseCorrection	Denotes the last attempted phase correction when threshold was exceeded and phase corrections were ignored. Not queryable outside of a trap.
	jnxPtpPhaseMonitoringReason	Indicates a reason for some phase monitoring event. Not queryable outside of a trap.
	jnxPtpPhaseMonitoringHoldoverLimit	Provides the configured holdover time limit if the Phase Adjustment Mitigation feature brings the servo into holdover. 0 if no time limit configured.
	jnxPtpPhaseMonitoringSynceHoldover	Indicates whether SyncE is configured to go into holdover when the servo goes into holdover due to the Phase Adjustment Mitigation feature. 0 if not configured, 1 if configured.
	(ACX7332, ACX7348)
	jnxPtpPhaseOffset	Denotes the PTP phase offset.
	jnxPtpUtcOffset	Denotes the PTP UTC offset.
	jnxPtpAdvClockClass	Denotes the PTP Advertised clock class.
	jnxTimingFrequencyTraceability	Denotes the frequency traceability indicator.
	jnxTimingTimeTraceability	Denotes the time traceability indicator.
	jnxClksyncPtpOperationalMasters	Denotes the PTP operational masters.
	jnxClksyncPtpOperationalSlaves	Denotes the PTP operational timeReceiver clocks.
SyncE MIB	jnxClksyncQualityCode	Denotes the SSM/ESMC quality level of the locked source in decimal format.
	jnxClksyncQualityCodeStr	Denotes the SSM/ESMC quality level of the locked source in string format
	jnxClksyncIfIndex	Denotes the interface index of the locked source in decimal format.
	jnxClksyncIntfName	Denotes the interface name of the locked source in string format.
	(ACX7332, ACX7348)
	jnxClksyncSynceQualityTable	Denotes the SyncE table to get quality metrics for all configured sources.
	jnxClksyncSynceQualityEntry	Denotes the SyncE table entry to get quality metrics for all configured sources.
	jnxClksyncSynceQualityIntfName	Denotes the interface name of the configured source.
	jnxClksyncSynceQualityValue	Denotes the quality level of the configured source.
	jnxClksyncSynceLockedIfIndex	Denotes the locked SNMP ifIndex of member interface.
	jnxClksyncSynceLockedIntfName	Denotes the SyncE interface name.
	jnxClksyncDpllState	Denotes the SyncE DPLL states.
	jnxClksyncDpllStateStr	Denotes the DPLL state in string format.
GPS MIB	jnxGpsRecvStatus	Displays the status of the GPS receiver.

Note:

The SNMP get and walk management are supported only for scalar objects.

Use the show snmp mib get> and show snmp mib walk <oid> commands to view the configured SNMP MIB objects.
For SyncE objects, the jnxClksyncQualityCode, jnxClksyncQualityCodeStr, jnxClksyncIfIndex, and jnxClksyncIntfName objects displays only for locked source.
For additional details, see Timing MIBs and Notifications.

You can use the show chassis synchronization extensive, show ptp lock-status detail, show snmp mib get <MIB-timing-objects>, and show snmp mib walk jnxTimingNotfObjects show commands for monitoring and troubleshooting purposes.

The following are the sample show command outputs for reference:

show chassis synchronization extensive

show ptp lock-status detail

show snmp mib get <MIB-timing-objects>

show snmp mib walk jnxTimingNotfObjects