If you are using the current version of Cumulus NetQ, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.


PTP monitoring is only supported on Spectrum switches running Cumulus Linux version 5.0.0 and later.

Use the UI or CLI to monitor Precision Time Protocol (PTP), including clock hierarchies and priorities, synchronization thresholds, and accuracy rates.

PTP Commands

Monitor PTP with the following commands. See the command line reference for additional options, definitions, and examples.

   netq show ptp clock-details
   netq show ptp counters (tx | rx) 
   netq show ptp global-config
   netq show ptp port-status 
   netq show events message_type ptp

Access the PTP Dashboard

  1. Select Menu.

  2. Under the Network section, select PTP.

The PTP summary dashboard displays:

  • clock count, type, and distribution
  • an overview of PTP-related events
  • a summary of PTP violations (mean path delay and offset from master)
PTP summary screen displaying grandmaster clock details, events total, and violations summary

Navigate to the Events tab to view, filter, and sort PTP-related events:

detailed display of 133 PTP events, including list of devices with PTP-related events

View PTP on a Switch

  1. Select Devices in the workbench header, then click Open a device card.

  2. Select a switch from the dropdown and specify the large card.

  3. Hover over the top of the card and select the PTP icon :

large switch card with PTP display selected
  1. For more granular data, expand the card to full-size and navigate to PTP:
full screen graph of a switch's average offsest-from-master and average mean-path-delay statistics

Hover over the chart at any point to display timestamped mean-path-delay and offset-from-master data. You can drag the bottom bar to expand and compress the period of time displayed in the graph.

Select the tabs above the chart to display information about domains, clocks, ports, and configurations:

clock domain, identiy, port, and quality information for the grandmaster clock