Uploaded image for project: 'OpenShift Bugs'
  1. OpenShift Bugs
  2. OCPBUGS-73795

4.21 PTP T-BC Clock Class prematurely reported 6 before other processes locked

    • None
    • False
    • Hide

      None

      Show
      None
    • None
    • Important
    • None
    • x86_64
    • QA
    • 2026-Feb-16: Waiting on merge
    • None
    • None
    • Done
    • Bug Fix
    • Hide
      Before this update, when the PTP operator monitored the digital phase-locked loop (DPLL) offset, and the DPLL reached a steady state, the offset value could be temporarily below the threshold to be considered locked because of the high variability of the offset. As a consequence, the PTP boundary clock (T-BC) would announce its clock class before the `ptp4l` program and the DPLL reached a locked state. With this release, clock class decisions are started only after a minimum number of samples. As a result, the clock class is announced after the DPLL is stabilized.


      Show
      Before this update, when the PTP operator monitored the digital phase-locked loop (DPLL) offset, and the DPLL reached a steady state, the offset value could be temporarily below the threshold to be considered locked because of the high variability of the offset. As a consequence, the PTP boundary clock (T-BC) would announce its clock class before the `ptp4l` program and the DPLL reached a locked state. With this release, clock class decisions are started only after a minimum number of samples. As a result, the clock class is announced after the DPLL is stabilized.
    • None
    • None
    • None
    • None

      Description of problem:

          Clock Class 6 is reported prematurely before other PTP component services have locked

      Version-Release number of selected component (if applicable):

      4.21.0-202601101619    

      How reproducible:

      100%

      Steps to Reproduce:

      1. Perform a reboot
      2. Wait & probe the logs & metrics     

      Actual results:

      Within Daemon logs         
      -------------          
       gm.ClockClass                         6
      
      Within Metrics
      -------------
      # HELP openshift_ptp_clock_class 6 = Locked, 7 = PRC unlocked in-spec, 52/187 = PRC unlocked out-of-spec, 135 = T-BC holdover in-spec, 165 = T-BC holdover out-of-spec, 248 = Default, 255 = Slave Only Clock
      # TYPE openshift_ptp_clock_class gauge
      openshift_ptp_clock_class{config="ptp4l.1.config",node="helix65.lab.eng.rdu2.redhat.com",process="ptp4l"} 6
      # HELP openshift_ptp_clock_state 0 = FREERUN, 1 = LOCKED, 2 = HOLDOVER
      # TYPE openshift_ptp_clock_state gauge
      openshift_ptp_clock_state{iface="CLOCK_REALTIME",node="helix65.lab.eng.rdu2.redhat.com",process="phc2sys"} 1
      openshift_ptp_clock_state{iface="ens1fx",node="helix65.lab.eng.rdu2.redhat.com",process="dpll"} 1
      openshift_ptp_clock_state{iface="ens1fx",node="helix65.lab.eng.rdu2.redhat.com",process="ts2phc"} 1
      openshift_ptp_clock_state{iface="ens2fx",node="helix65.lab.eng.rdu2.redhat.com",process="T-BC"} 0
      openshift_ptp_clock_state{iface="ens2fx",node="helix65.lab.eng.rdu2.redhat.com",process="dpll"} 0
      openshift_ptp_clock_state{iface="ens2fx",node="helix65.lab.eng.rdu2.redhat.com",process="ptp4l"} 1
      openshift_ptp_clock_state{iface="ens2fx",node="helix65.lab.eng.rdu2.redhat.com",process="ts2phc"} 0

      Expected results:

          

      Additional info:

          

              micosta@redhat.com Michele Tomaso Costa
              rh-ee-dpopsuev Daniel Popsuevich
              Daniel Popsuevich Daniel Popsuevich
              Tami Love Tami Love
              Daniel Popsuevich, Yang Liu
              Votes:
              0 Vote for this issue
              Watchers:
              7 Start watching this issue

                Created:
                Updated:
                Resolved: