6장. 모니터링 문제 조사

프로세스

1. 지표 이름을 쿼리하고 프로젝트가 올바른지 확인합니다.

   1. 웹 콘솔의 개발자 화면에서 모니터링 을 클릭하고 Metrics 탭으로 이동합니다.
   2. Project: 목록에서 메트릭을 보려는 프로젝트를 선택합니다.

   3. 쿼리 선택 목록에서 기존 쿼리를 선택하거나 표현식 필드에 PromQL 쿼리를 추가하여 사용자 지정 쿼리를 실행합니다.

      메트릭은 차트에 표시됩니다.

      쿼리는 프로젝트별로 수행해야 합니다. 표시된 지표는 선택한 프로젝트와 관련이 있습니다.

2. 메트릭을 원하는 Pod가 메트릭을 적극적으로 제공하고 있는지 확인합니다. Pod에 다음 oc exec 명령을 실행하여 pod ,포트 , /metrics 를 대상으로 합니다.

   $ oc exec <sample_pod> -n <sample_namespace> -- curl <target_pod_IP>:<port>/metrics

   Copy to Clipboard Toggle word wrap
   참고

   curl 이 설치된 포드에서 명령을 실행해야 합니다.

   다음 예제 출력은 유효한 버전 지표가 있는 결과를 보여줍니다.

   출력 예

     % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                    Dload  Upload   Total   Spent    Left  Speed
   # HELP version Version information about this binary-- --:--:-- --:--:--     0
   # TYPE version gauge
   version{version="v0.1.0"} 1
   100   102  100   102    0     0  51000      0 --:--:-- --:--:-- --:--:-- 51000

   Copy to Clipboard Toggle word wrap

   잘못된 출력은 해당 애플리케이션에 문제가 있음을 나타냅니다.

3. PodMonitor CRD를 사용하는 경우 일치하는 라벨을 사용하여 PodMonitor CRD가 올바른 Pod를 가리키도록 구성되었는지 확인합니다. 자세한 내용은 Prometheus Operator 설명서를 참조하십시오.

4. ServiceMonitor CRD를 사용하고 Pod의 /metrics 엔드포인트가 지표 데이터를 표시하는 경우 다음 단계를 수행하여 구성을 확인합니다.

   1. 서비스가 올바른 /metrics 엔드포인트를 가리키는지 확인합니다. 이 출력의 서비스 레이블 은 서비스 모니터 레이블 및 후속 단계에서 서비스에서 정의한 /metrics 엔드포인트와 일치해야 합니다.

      $ oc get service

      Copy to Clipboard Toggle word wrap

      출력 예

      apiVersion: v1
      kind: Service 

      1

      
      metadata:
        labels: 

      2

      
          app: prometheus-example-app
        name: prometheus-example-app
        namespace: ns1
      spec:
        ports:
        - port: 8080
          protocol: TCP
          targetPort: 8080
          name: web
        selector:
          app: prometheus-example-app
        type: ClusterIP

      Copy to Clipboard Toggle word wrap

      1

      이는 서비스 API임을 지정합니다.

      2

      이 서비스에 사용되는 레이블을 지정합니다.

   2. serviceIP,port, /metrics 엔드포인트를 쿼리하여 이전에 Pod에서 실행한 curl 명령에서 동일한 메트릭을 확인합니다.

      1. 다음 명령을 실행하여 서비스 IP를 찾습니다.

         $ oc get service -n <target_namespace>

         Copy to Clipboard Toggle word wrap

      2. /metrics 엔드포인트를 쿼리합니다.

         $ oc exec <sample_pod> -n <sample_namespace> -- curl <service_IP>:<port>/metrics

         Copy to Clipboard Toggle word wrap

         유효한 메트릭은 다음 예제에서 반환됩니다.

         출력 예

         % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                        Dload  Upload   Total   Spent    Left  Speed
         100   102  100   102    0     0  51000      0 --:--:-- --:--:-- --:--:--   99k
         # HELP version Version information about this binary
         # TYPE version gauge
         version{version="v0.1.0"} 1

         Copy to Clipboard Toggle word wrap

   3. 레이블 일치를 사용하여 ServiceMonitor 오브젝트가 원하는 서비스를 가리키도록 구성되었는지 확인합니다. 이렇게 하려면 oc get 서비스 출력의 Service 오브젝트를 oc get service monitor 출력에서 ServiceMonitor 오브젝트와 비교합니다. 메트릭을 표시하려면 라벨이 일치해야 합니다.

      예를 들어 이전 단계에서 Service 오브젝트에 app: prometheus-example-app 레이블이 있고 ServiceMonitor 오브젝트에 동일한 app: prometheus-example-app match 라벨이 있는 방법을 확인합니다.

5. 모든 항목이 유효한 것으로 표시되고 메트릭을 계속 사용할 수 없는 경우 추가 도움말을 위해 지원 팀에 문의하십시오.