8.4. 추적

절차

1. OpenTelemetryHeaderor CR(사용자 정의 리소스)을 만듭니다.

   OpenTelemetry#189or CR의 예

   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: cluster-collector
     namespace: <namespace>
   spec:
     mode: deployment
     config: |
       receivers:
         zipkin:
       processors:
       exporters:
         jaeger:
           endpoint: jaeger-all-in-one-inmemory-collector-headless.tracing-system.svc:14250
           tls:
             ca_file: "/var/run/secrets/kubernetes.io/serviceaccount/service-ca.crt"
         logging:
       service:
         pipelines:
           traces:
             receivers: [zipkin]
             processors: []
             exporters: [jaeger, logging]

2. Red Hat OpenShift distributed tracing이 설치된 네임스페이스에서 두 개의 포드가 실행되고 있는지 확인합니다.

   $ oc get pods -n <namespace>

   출력 예

   NAME                                          READY   STATUS    RESTARTS   AGE
   cluster-collector-collector-85c766b5c-b5g99   1/1     Running   0          5m56s
   jaeger-all-in-one-inmemory-ccbc9df4b-ndkl5    2/2     Running   0          15m

3. 다음과 같은 헤드리스 서비스가 생성되었는지 확인합니다.

   $ oc get svc -n <namespace> | grep headless

   출력 예

   cluster-collector-collector-headless            ClusterIP   None             <none>        9411/TCP                                 7m28s
   jaeger-all-in-one-inmemory-collector-headless   ClusterIP   None             <none>        9411/TCP,14250/TCP,14267/TCP,14268/TCP   16m

   이러한 서비스는 Jaeger, Knative Serving 및 Knative Eventing을 구성하는 데 사용됩니다. Jaeger 서비스의 이름은 다를 수 있습니다.

4. "OpenShift Serverless Operator 설치" 문서에 따라 OpenShift Serverless Operator를 설치합니다.

5. 다음 KnativeServing CR을 생성하여 Knative Serving 을 설치합니다.

   KnativeServing CR의 예

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
       name: knative-serving
       namespace: knative-serving
   spec:
     config:
       tracing:
         backend: "zipkin"
         zipkin-endpoint: "http://cluster-collector-collector-headless.tracing-system.svc:9411/api/v2/spans"
         debug: "false"
         sample-rate: "0.1" 1

   1

   sample-rate는 샘플링 가능성을 정의합니다. sample-rate: "0.1" 을 사용하면 10개의 추적 중 1개가 샘플링됩니다.

6. 다음 KnativeEventing CR을 생성하여 Knative Eventing을 설치합니다.

   KnativeEventing CR의 예

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeEventing
   metadata:
       name: knative-eventing
       namespace: knative-eventing
   spec:
     config:
       tracing:
         backend: "zipkin"
         zipkin-endpoint: "http://cluster-collector-collector-headless.tracing-system.svc:9411/api/v2/spans"
         debug: "false"
         sample-rate: "0.1" 1

   1

   sample-rate는 샘플링 가능성을 정의합니다. sample-rate: "0.1" 을 사용하면 10개의 추적 중 1개가 샘플링됩니다.

7. Knative 서비스를 생성합니다.

   서비스의 예

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: helloworld-go
   spec:
     template:
       metadata:
         labels:
           app: helloworld-go
         annotations:
           autoscaling.knative.dev/minScale: "1"
           autoscaling.knative.dev/target: "1"
       spec:
         containers:
         - image: quay.io/openshift-knative/helloworld:v1.2
           imagePullPolicy: Always
           resources:
             requests:
               cpu: "200m"
           env:
           - name: TARGET
             value: "Go Sample v1"

8. 서비스에 대한 일부 요청을 수행합니다.

   HTTPS 요청의 예

   $ curl https://helloworld-go.example.com

9. Jaeger 웹 콘솔의 URL을 가져옵니다.

   명령 예

   $ oc get route jaeger-all-in-one-inmemory  -o jsonpath='{.spec.host}' -n <namespace>

   이제 Jaeger 콘솔을 사용하여 추적을 검사할 수 있습니다.

절차

1. 다음을 포함하는 Jaeger 사용자 정의 리소스 (CR) 파일을 생성하고 적용합니다.

   Jaeger CR

   apiVersion: jaegertracing.io/v1
   kind: Jaeger
   metadata:
     name: jaeger
     namespace: default

2. KnativeServing CR을 편집하고 추적에 필요한 YAML 구성을 추가하여 Knative Serving에 대한 추적을 활성화합니다.

   Serving의 YAML 추적 예

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
     name: knative-serving
     namespace: knative-serving
   spec:
     config:
       tracing:
         sample-rate: "0.1" 1
         backend: zipkin 2
         zipkin-endpoint: "http://jaeger-collector.default.svc.cluster.local:9411/api/v2/spans" 3
         debug: "false" 4

   1

   sample-rate는 샘플링 가능성을 정의합니다. sample-rate: "0.1" 을 사용하면 10개의 추적 중 1개가 샘플링됩니다.

   2

   backend를 zipkin으로 설정해야 합니다.

   3

   zipkin-endpoint는 jaeger-collector 서비스 끝점을 가리켜야 합니다. 이 끝점을 가져오려면 Jaeger CR이 적용되는 네임스페이스를 대체합니다.

   4

   디버깅을 false로 설정해야 합니다. debug: "true"를 설정하여 디버그 모드를 활성화하면 모든 범위가 서버에 전송되어 샘플링 단계를 건너뜁니다.

3. KnativeEventing CR을 편집하여 Knative Eventing에 대한 추적을 활성화합니다.

   Eventing의 YAML 추적 예

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeEventing
   metadata:
     name: knative-eventing
     namespace: knative-eventing
   spec:
     config:
       tracing:
         sample-rate: "0.1" 1
         backend: zipkin 2
         zipkin-endpoint: "http://jaeger-collector.default.svc.cluster.local:9411/api/v2/spans" 3
         debug: "false" 4

   1

   sample-rate는 샘플링 가능성을 정의합니다. sample-rate: "0.1" 을 사용하면 10개의 추적 중 1개가 샘플링됩니다.

   2

   backend 를 zipkin 으로 설정합니다.

   3

   jaeger-collector 서비스 끝점을 zipkin-endpoint 를 가리킵니다. 이 끝점을 가져오려면 Jaeger CR이 적용되는 네임스페이스를 대체합니다.

   4

   디버깅을 false로 설정해야 합니다. debug: "true"를 설정하여 디버그 모드를 활성화하면 모든 범위가 서버에 전송되어 샘플링 단계를 건너뜁니다.

1. 다음 명령을 입력하여 jaeger 경로의 호스트 이름을 가져옵니다.

   $ oc get route jaeger -n default

   출력 예

   NAME     HOST/PORT                         PATH   SERVICES       PORT    TERMINATION   WILDCARD
   jaeger   jaeger-default.apps.example.com          jaeger-query   <all>   reencrypt     None

2. 콘솔을 보려면 브라우저에서 끝점 주소를 엽니다.