PTP Commands

performance-monitoring

To enable the collection of performance-monitoring statistics, use the performance-monitoring command in PTP configuration mode.

performance-monitoring

Syntax Description

This command has no keywords or arguments.

Command Default

By default performance-monitoring is not enabled.

Command Modes

Global PTP configuration

Command History

Release Modification

Release 24.3.1

This command was introduced.

Usage Guidelines

None.

Task ID

Task ID Operation

performance-monitoring

read, write

Examples

The following example shows how to enable the collection of performance-monitoring statistics. 


Router(config)# ptp
Router(config-ptp)# performance-monitoring
Router(config-ptp)# commit

synchronous-ethernet prefer-interface ptp-receiver

To prefer selection of the SyncE source on the same interface where the PTP receiver is selected by the router, use the synchronous-ethernet prefer-interface ptp-receiver command in the global frequency synchronization mode.

The desired SyncE source on PTP receiver interface gets selected if it has the highest or equal QL and user configured priority among the other available SyncE sources.

If the selected PTP source goes down or if the PTP source's quality degrades, the system may switch to another PTP source. In such case, use this command so that the SyncE source selection would also switch to the new PTP receiver interface. Here, the preferred switching of SyncE source to the new PTP receiver interface shall happen only if the new interface uses the same SyncE QL and the user configured priority as the previously selected interface.

synchronous-ethernet prefer-interface ptp-receiver

Syntax Description

prefer-interface

Selects the frequency source among equal sources.
ptp-receiver

Selects the PTP receiver interface.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 24.4.1

This command was introduced.

Usage Guidelines

Task ID

Task ID Operation

ethernet-services

read, write

Examples

This example shows how to configure the synchronous-ethernet prefer-interface ptp-receiver command. 

RP/0/RP0/CPU0:router(config)# frequency synchronization synchronous-ethernet prefer-interface ptp-receiver
RP/0/RP0/CPU0:router(config)# commit

This example verifies the synchronous-ethernet prefer-interface ptp-receiver configuration. 

RP/0/RP0/CPU0:router(config)# show running-config frequency synchronization
Thu Aug 8 04:50:13.638 UTC
frequency-synchronization
 synchronous-ethernet prefer-interface ptp-receiver
!

show ptp dataset performance

To display the performance monitoring dataset for the local clock and any PTP port for the current 15-minute window, use the show ptp dataset performance{ clock| port{ all| interface name} } command in EXEC mode.

show ptp dataset performance { clock | port { all | interface name } } }

Syntax Description

clock

Displays the performance monitoring dataset of the local clock for the current 15-minute window.
port

Displays the performance monitoring dataset of the port for the current 15-minute window for all or specified interface name .

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 24.3.1

This command was introduced.

Usage Guidelines

None.

Task ID

Task ID Operation

performance

read

Examples

The following show command displays the performance monitoring dataset of the local clock for the current 15-minute window.


Router#show ptp dataset performance clock

performanceMonitoringDS for the current 15-minute window:
Clock ID ccccfffecccc00, steps removed 1, receiving-port 2:
    Start of time window: Thursday, April 11, 2024 14:18:59
    Measurement is valid
    Period is complete
    Measurement has been taken with reference to system clock
    Master slave delay:
        Average: 50ns
        Min: 50ns
        Max: 70ns
        Std: 1ns
    Slave master delay:
        Average: 51ns
        Min: 51ns
        Max: 71ns
        Std: 2ns
    Mean path delay:
        Average: 52ns
        Min: 52ns
        Max: 72ns
        Std: 3ns
    Offset from master:
        Average: 53ns
        Min: 53ns
        Max: 73ns
        Std: 4ns

Clock ID aaaabbbecccc00, steps removed 1, receiving-port 2:
    Start of time window: Thursday, April 11, 2024 14:18:59
    Measurement is not valid
    Period is not complete
    Measurement has been taken with reference to system clock
    Master slave delay:
        Average: 50ns
        Min: 50ns
        Max: 70ns
        Std: 1ns
    Slave master delay:
        Average: 51ns
        Min: 51ns
        Max: 71ns
        Std: 2ns
    Mean path delay:
        Average: 52ns
        Min: 52ns
        Max: 72ns
        Std: 3ns
    Offset from master:
        Average: 53ns
        Min: 53ns
        Max: 73ns
        Std: 4ns

Examples

The following show command displays the performance monitoring dataset of the port for the current 15-minute window.

Examples



Router#show ptp dataset performance port GigabitEthernet 0/0/0/1
performanceMonitoringPortDS for the current 15-minute window:
Interface GigabitEthernet 0/0/0/1
    Start of time window: Thursday, April 11, 2024 14:18:59
    Measurement is valid
    Period is not complete
    Measurement has been taken with reference to system clock
    Packets                     Sent        Received         Dropped
    ----------------------------------------------------------------
    Announce                       3              83              11
    Sync                           0              32               5
    Follow-Up                      0              31               0
    Delay-Req                     22               0               0
    Delay-Resp                     0              21               7
    Pdelay-Req                     0               7               0
    Pdelay-Resp                    0               0               0
    Pdelay-Resp-Follow-Up          0               0               0
    Signaling                      2               1               0
    Management                     0               0               0
    Other                          0               3              12
                               -----           -----           -----
    TOTAL                         27             178              35

show ptp platform performance-counters

To display counters details for platform performance sent by Precision Time Protocol (PTP), use the show ptp platform performance-counters in command in EXEC mode.

show ptp platform performance-counters { detail | brief }

Syntax Description

detail

Displays all 123 counter record details for platform performance sent by PTP.
brief

Displays only the current counter record in 15 minutes, 24 hours, 3minutes, and 1hour windows.

Command Default

None

Command Modes

EXEC

Command History

Release

Modification

Release 24.3.1

This command was introduced.

Usage Guidelines

None.

Task ID

Task ID Operation

platform performance-counters

read

Examples

In this example, the detail mode of the command displays all 123 records. 


Router#sh ptp platform performance-counters detail 

PTP Current record index 15 min: 96
PTP Current record index 3 min: 119

PTP performance monitoring statistics: 
==============================================================================================================
15 min stats
[0]     12 August 2024 07:08:59 UTC 15 min statistics
--------------------------------------------------------------------------------------------------------------
                Stat    Min(sec.nsec)        Max(sec.nsec)       Mean(sec.nsec)     Std deviation           Samples
--------------------------------------------------------------------------------------------------------------
  Master-slave-delay -000000000.15937      000000000.333       -000000000.1780       000000000.71191      154       
  Slave-master-delay  000000000.319        000000000.16593      000000000.2437       000000000.74103      154       
     mean-path-delay  000000000.322        000000000.334        000000000.327        000000000.4057       154       
  offset-from-master -000000000.16263      000000000.6         -000000000.2108       000000000.72546      154       

--------------------------------------------------------------------------------------------------------------
            Complete      Valid      PmRef      ServoAtStart     ServoAtEnd          LastServoFlapTime
--------------------------------------------------------------------------------------------------------------
               FALSE      FALSE       TRUE        PHASE_LOCKED   HOLDOVER               12 Apr 2024 07:09:09 UTC 

==============

….

Examples

In this example, the brief mode displays only the current counter record in 15 minutes, 24 hours, 3minutes, and 1hour windows. 


Router#sh ptp platform performance-counters brief  

==============
PTP Current record index 15 min: 96
PTP Current record index 3 min: 116

PTP performance monitoring statistics: 
==============================================================================================================
15 min stats
[0]     30 Apr 2024 11:46:07 UTC 15 min statistics
--------------------------------------------------------------------------------------------------------------
                Stat    Min(sec.nsec)        Max(sec.nsec)       Mean(sec.nsec)     Std deviation           Samples
--------------------------------------------------------------------------------------------------------------
  Master-slave-delay  000000000.271        000000000.336        000000000.325       000000000.38386      13922     
  Slave-master-delay  000000000.314        000000000.377        000000000.326       000000000.38526      13922     
     mean-path-delay  000000000.318        000000000.334        000000000.325       000000000.38425      13922     
  offset-from-master -000000000.53         000000000.9         -000000000.0         000000000.369        13922     

--------------------------------------------------------------------------------------------------------------
            Complete      Valid      PmRef      ServoAtStart     ServoAtEnd          LastServoFlapTime
--------------------------------------------------------------------------------------------------------------
               FALSE      FALSE       TRUE         FREQ_LOCKED   HOLDOVER               30 Apr 2024 12:00:33 UTC 

==============