11.10. PTP 하드웨어 빠른 이벤트 알림 프레임워크

1. DU 애플리케이션에서 서브스크립션 요청: DU는 API 요청을 cloud-event-proxy 사이드카로 전송하여 PTP 이벤트 서브스크립션을 생성합니다. cloud-event-proxy 사이드카는 서브스크립션 리소스를 생성합니다.
2. cloud-event-proxy 사이드카는 서브스크립션을 생성: 이벤트 리소스는 cloud-event-proxy 사이드카에 의해 유지됩니다. cloud-event-proxy 사이드카 컨테이너는 ID 및 URL 위치가 있는 승인을 전송하여 저장된 서브스크립션 리소스에 액세스합니다. 사이드카는 서브스크립션에 지정된 리소스에 대한 AMQ 메시징 리스너 프로토콜을 생성합니다.
3. DU 애플리케이션에서 PTP 이벤트 알림 수신: cloud-event-proxy 사이드카 컨테이너가 리소스 한정자에 지정된 주소를 수신합니다. DU 이벤트 소비자는 메시지를 처리하고 서브스크립션에 지정된 반환 URL로 전달합니다.
4. cloud-event-proxy 사이드카는 PTP 이벤트를 검증하고 DU 애플리케이션에 게시: cloud-event-proxy 사이드카는 이벤트를 수신하고 클라우드 이벤트 오브젝트를 래핑하여 데이터를 검색하고 반환 URL을 가져와 이벤트를 DU 소비자 애플리케이션에 다시 게시합니다.
5. DU 애플리케이션은 PTP 이벤트 사용: DU 애플리케이션 이벤트 소비자가 PTP 이벤트를 수신하고 처리합니다.

검증

1. AMQ Interconnect Operator를 사용할 수 있고 필요한 Pod가 실행 중인지 확인합니다.

   $ oc get pods -n amq-interconnect

   출력 예

   NAME                                    READY   STATUS    RESTARTS   AGE
   amq-interconnect-645db76c76-k8ghs       1/1     Running   0          23h
   interconnect-operator-5cb5fc7cc-4v7qm   1/1     Running   0          23h

2. 필수 linuxptp-daemon PTP 이벤트 생산자 Pod가 openshift-ptp 네임스페이스에서 실행되고 있는지 확인합니다.

   $ oc get pods -n openshift-ptp

   출력 예

   NAME                     READY   STATUS    RESTARTS       AGE
   linuxptp-daemon-2t78p    3/3     Running   0              12h
   linuxptp-daemon-k8n88    3/3     Running   0              12h

절차

1. 다음 명령을 실행하여PtpOperatorConfig 리소스의 spec.ptpEventConfig 필드를 수정하고 적절한 값을 설정합니다.

   $ oc edit PtpOperatorConfig default -n openshift-ptp

   ...
   spec:
     daemonNodeSelector:
       node-role.kubernetes.io/worker: ""
     ptpEventConfig:
       enableEventPublisher: true 1
       transportHost: amqp://<instance_name>.<namespace>.svc.cluster.local 2

   1

   enableEventPublisher를 true로 설정하여 PTP 빠른 이벤트 알림을 활성화합니다.

   2

   구성한 AMQ 라우터로 transportHost를 설정합니다. 여기서 <instance_name> 및 <namespace>는 AMQ 상호 연결 라우터 인스턴스 이름과 네임스페이스에 해당합니다 (예: amqp://amq-interconnect.amq-interconnect.svc.cluster.local)

2. PTP가 활성화된 인터페이스에 대한 PtpConfig 사용자 지정 리소스를 생성하고 ptpClockThreshold에 필요한 값을 설정합니다. 예를 들면 다음과 같습니다.

   apiVersion: ptp.openshift.io/v1
   kind: PtpConfig
   metadata:
     name: example-ptpconfig
     namespace: openshift-ptp
   spec:
     profile:
     - name: "profile1"
       interface: "enp5s0f0"
       ptp4lOpts: "-2 -s --summary_interval -4" 1
       phc2sysOpts: "-a -r -m -n 24 -N 8 -R 16" 2
       ptp4lConf: ""                            3
     ptpClockThreshold:                         4
       holdOverTimeout: 5
       maxOffsetThreshold: 100
       minOffsetThreshold: -100

   1

   PTP 빠른 이벤트를 사용하려면 --summary_interval -4 를 추가합니다.

   2

   필수 phc2sysOpts 값. -m 은 stdout 에 메시지를 출력합니다. linuxptp-daemon DaemonSet 은 로그를 구문 분석하고 Prometheus 지표를 생성합니다.

   3

   기본 /etc/ptp4l.conf 파일을 대체할 구성이 포함된 문자열을 지정합니다. 기본 구성을 사용하려면 필드를 비워 둡니다.

   4

   선택 사항: ptpClockThreshold 가 없으면 기본값이 ptpClockThreshold 필드에 사용됩니다. 스탠자는 기본 ptpClockThreshold 값을 표시합니다. ptpClockThreshold 값은 PTP 이벤트가 트리거되기 전에 PTP 마스터 클럭이 연결 해제된 후의 기간을 구성합니다. holdOverTimeout 은 PTP 마스터 클럭의 연결이 끊어지면 PTP 클럭 이벤트 상태가 FREERUN 로 변경되기 전 시간(초)입니다. maxOffsetThreshold 및 minOffsetThreshold 설정은 CLOCK_REALTIME (phc2sys) 또는 마스터 오프셋(ptp4l)의 값과 비교되는 나노초에 오프셋 값을 구성합니다. ptp4l 또는 phc2sys 오프셋 값이 이 범위를 벗어나는 경우 PTP 클럭 상태가 FREERUN 로 설정됩니다. 오프셋 값이 이 범위 내에 있으면 PTP 클럭 상태가 LOCKED 로 설정됩니다.

절차

1. 활성 linuxptp-daemon Pod 목록을 가져옵니다.

   $ oc get pods -n openshift-ptp

   출력 예

   NAME                    READY   STATUS    RESTARTS   AGE
   linuxptp-daemon-2t78p   3/3     Running   0          8h
   linuxptp-daemon-k8n88   3/3     Running   0          8h

2. 다음 명령을 실행하여 필요한 cloud-event-proxy 컨테이너의 메트릭에 액세스합니다.

   $ oc exec -it <linuxptp-daemon> -n openshift-ptp -c cloud-event-proxy -- curl 127.0.0.1:9091/metrics

   다음과 같습니다.

   <linuxptp-daemon>

   쿼리할 Pod를 지정합니다(예: linuxptp-daemon-2t78p ).

   출력 예

   # HELP cne_amqp_events_published Metric to get number of events published by the transport
   # TYPE cne_amqp_events_published gauge
   cne_amqp_events_published{address="/cluster/node/compute-1.example.com/ptp/status",status="success"} 1041
   # HELP cne_amqp_events_received Metric to get number of events received  by the transport
   # TYPE cne_amqp_events_received gauge
   cne_amqp_events_received{address="/cluster/node/compute-1.example.com/ptp",status="success"} 1019
   # HELP cne_amqp_receiver Metric to get number of receiver created
   # TYPE cne_amqp_receiver gauge
   cne_amqp_receiver{address="/cluster/node/mock",status="active"} 1
   cne_amqp_receiver{address="/cluster/node/compute-1.example.com/ptp",status="active"} 1
   cne_amqp_receiver{address="/cluster/node/compute-1.example.com/redfish/event",status="active"}
   ...

절차

1. 다음 명령을 입력하여 cloud-event-proxy 사이드카 컨테이너에서 사용 가능한 PTP 메트릭 목록을 반환합니다.

   $ oc exec -it <linuxptp_daemon_pod> -n openshift-ptp -c cloud-event-proxy -- curl 127.0.0.1:9091/metrics

   다음과 같습니다.

   <linuxptp_daemon_pod>

   쿼리할 Pod를 지정합니다(예: linuxptp-daemon-2t78p ).

2. 반환된 메트릭 목록에서 쿼리할 PTP 메트릭의 이름을 복사합니다(예: cne_amqp_events_received ).
3. OpenShift Container Platform 웹 콘솔에서 모니터링 메트릭을 클릭합니다.
4. PTP 메트릭을 표현식 필드에 붙여넣고 쿼리 실행을 클릭합니다.