Configuring PTP Monitoring

PTP monitoring records PTP information including offset from master, mean path delay, and skew values, which can then be viewed using a show command. When this feature is enabled, PTP Syslog messages will also be generated for those metrics for which threshold values have been configured on the switch. PTP monitoring is enabled by default.

Enabling and Disabling PTP Monitoring

Use the ptp monitor command to enable PTP monitoring on the device (it is enabled by default). The no form of the command disables PTP monitoring and clears all the recorded PTP data.

Example

This command disables PTP monitoring and clears all recorded PTP data from the switch.
switch(config)# no ptp monitor

Configuring the Offset-from-master Threshold

The offset is the difference in nanoseconds between master and slave time. Use the ptp monitor threshold offset-from-master command to specify the offset-from-master threshold in nanoseconds. A Syslog message is generated if the most recently calculated time offset from the PTP master is outside of the range (-<threshold>, <threshold>). The maximum offset threshold is one second. The no form of the command clears the threshold value and prevents further Syslog messages from being generated for this parameter.

Example

This command sets an offset-from-master threshold value of 500 nanoseconds.
switch(config)# ptp monitor threshold offset-from-master 500 

Configuring the Mean-path-delay Threshold

Mean path delay is the mean time in nanoseconds that PTP packets take to travel between master and slave. Use the ptp monitor threshold mean-path-delay command to specify the mean-path-delay threshold in nanoseconds. A Syslog message is generated if the value of the most recently calculated mean path delay is greater than or equal to this threshold. The maximum mean-path-delay threshold is one second. The no form of the command clears the threshold value and prevents further Syslog messages from being generated for this parameter.
Note: Mean path delay is always non-negative.

Example

This command sets a mean-path-delay threshold value of 2000 nanoseconds.
switch(config)# ptp monitor threshold mean-path-delay 2000

Configuring the Skew Threshold

PTP skew is the clock frequency difference between master and slave. Use the ptp monitor threshold skew command to configure the value of the skew-threshold percentage. A Syslog message is generated if the value of the most recently calculated skew is not in the range (1/(1+<threshold>), 1*(1+<threshold>)). Skew threshold percentage is represented a double precision (16 digit) real number ranging from 0 (0%) to 10 (1000%). The no form of the command clears the threshold value and prevents further Syslog messages from being generated for this parameter.

Example

This command sets a skew threshold value of 5 (500%).
switch(config)# ptp monitor threshold skew 5