5.4. 분산 추적 데이터 수집 문제 해결

OpenTelemetry 수집기는 상태를 측정하고 데이터 수집 문제를 조사하는 여러 방법을 제공합니다.

5.4.1. OpenTelemetry 수집기 로그 가져오기

다음과 같이 OpenTelemetry 수집기의 로그를 가져올 수 있습니다.

프로세스

  1. OpenTelemetry 수집기 CR(사용자 정의 리소스)에서 관련 로그 수준을 설정합니다.

      config: |
        service:
          telemetry:
            logs:
              level: debug 1
    1
    수집기의 로그 수준입니다. info,warn,error, debug 중 하나를 선택합니다. 기본값은 info 입니다.
  2. oc logs 명령 또는 OpenShift 콘솔을 사용하여 로그를 검색합니다.

5.4.2. 메트릭 노출

OpenTelemetry 수집기는 처리된 데이터 볼륨에 대한 지표를 표시합니다. 다음 메트릭은 기간용이지만 메트릭 및 로그 신호에 대해 유사한 메트릭이 노출됩니다.

otelcol_receiver_accepted_spans
파이프라인에 성공적으로 푸시된 기간 수입니다.
otelcol_receiver_refused_spans
파이프라인에 푸시할 수 없는 기간 수입니다.
otelcol_exporter_sent_spans
대상에 성공적으로 전송된 기간 수입니다.
otelcol_exporter_enqueue_failed_spans
전송 대기열에 범위를 추가하지 못했습니다.

Operator는 메트릭 끝점을 스크랩하는 데 사용할 수 있는 < cr-name>-collector-monitoring 원격 분석 서비스를 생성합니다.

프로세스

  1. OpenTelemetry 수집기 사용자 정의 리소스에 다음 행을 추가하여 Telemetry 서비스를 활성화합니다.

      config: |
        service:
          telemetry:
            metrics:
              address: ":8888" 1
    1
    내부 수집기 지표가 노출되는 주소입니다. 기본값은 :8888 입니다.
  2. 포트 전달 수집기 Pod를 사용하는 다음 명령을 실행하여 지표를 검색합니다.

    $ oc port-forward <collector-pod>
  3. http://localhost:8888/metrics 의 메트릭 끝점에 액세스합니다.

5.4.3. 로깅 내보내기

수집된 데이터를 표준 출력으로 내보내도록 로깅 내보내기를 구성할 수 있습니다.

프로세스

  1. 다음과 같이 OpenTelemetry 수집기 사용자 정의 리소스를 구성합니다.

      config: |
        exporters:
          logging:
            verbosity: detailed
        service:
          pipelines:
            traces:
              exporters: [logging]
            metrics:
              exporters: [logging]
            logs:
              exporters: [logging]
  2. oc logs 명령 또는 OpenShift 콘솔을 사용하여 로그를 표준 출력으로 내보냅니다.