1.15. 메트릭, 로그 및 추적

OpenShift 콘솔의 절차

1. OpenShift Container Platform 웹 콘솔에 cluster-admin 권한이 있는 사용자로 로그인합니다. Red Hat OpenShift Dedicated를 사용하는 경우 dedicated-admin 역할의 계정이 있어야 합니다.
2. 네트워킹 경로로 이동합니다.

3. 경로 페이지의 네임스페이스 메뉴에서 Service Mesh Control Plane 프로젝트(예: istio-system )를 선택합니다.

   위치 열은 각 경로에 대한 연결된 주소를 표시합니다.

4. 필요한 경우 필터를 사용하여 액세스하려는 경로가 있는 구성 요소 콘솔을 찾습니다. 경로 위치를 클릭하여 콘솔을 시작합니다.
5. OpenShift로 로그인 을 클릭합니다.

CLI의 프로세스

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다. Red Hat OpenShift Dedicated를 사용하는 경우 dedicated-admin 역할의 계정이 있어야 합니다.

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. Service Mesh Control Plane 프로젝트로 전환합니다. 이 예제에서 istio-system 은 Service Mesh Control Plane 프로젝트입니다. 다음 명령을 실행합니다.

   $ oc project istio-system

3. 다양한 Red Hat OpenShift Service Mesh 콘솔의 경로를 가져오려면 다음 명령을 실행합니다.

   $ oc get routes

   이 명령은 Kiali, Jaeger, Prometheus 및 Grafana 웹 콘솔의 URL과 서비스 메시의 기타 경로를 반환합니다. 출력은 다음과 유사합니다.

   NAME                    HOST/PORT                         SERVICES              PORT    TERMINATION
   info-gateway        bookinfo-gateway-yourcompany.com  istio-ingressgateway          http2
   grafana                 grafana-yourcompany.com           grafana               <all>   reencrypt/Redirect
   istio-ingressgateway    istio-ingress-yourcompany.com     istio-ingressgateway  8080
   jaeger                  jaeger-yourcompany.com            jaeger-query          <all>   reencrypt
   kiali                   kiali-yourcompany.com             kiali                 20001   reencrypt/Redirect
   prometheus              prometheus-yourcompany.com        prometheus            <all>   reencrypt/Redirect

4. HOST/PORT 열에서 액세스할 콘솔의 URL을 브라우저로 복사하여 콘솔을 엽니다.
5. OpenShift로 로그인 을 클릭합니다.

관리자의 절차

1. 관리자 역할을 사용하여 OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. 홈 프로젝트를 클릭합니다.
3. 필요한 경우 프로젝트 페이지에서 필터를 사용하여 프로젝트 이름을 찾습니다.
4. 프로젝트 이름을 클릭합니다(예: info ).
5. 프로젝트 세부 정보 페이지의 시작 관리자 섹션에서 Kiali 링크를 클릭합니다.

6. OpenShift Container Platform 콘솔에 액세스하는 데 사용하는 것과 동일한 사용자 이름 및 암호를 사용하여 Kiali 콘솔에 로그인합니다.

   Kiali 콘솔에 처음 로그인하면 볼 수 있는 권한이 있는 서비스 메시에 모든 네임스페이스가 표시되는 개요 페이지가 표시됩니다.

   콘솔 설치의 유효성을 검사하고 네임스페이스가 메시에 아직 추가되지 않은 경우 istio-system 이외의 데이터가 표시되지 않을 수 있습니다.

개발자용 절차

1. 개발자 역할을 사용하여 OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. 프로젝트를 클릭합니다.
3. 필요한 경우 프로젝트 세부 정보 페이지에서 필터를 사용하여 프로젝트 이름을 찾습니다.
4. 프로젝트 이름을 클릭합니다(예: info ).
5. 프로젝트 페이지의 시작 관리자 섹션에서 Kiali 링크를 클릭합니다.
6. OpenShift로 로그인 을 클릭합니다.

OpenShift 콘솔의 절차

1. OpenShift Container Platform 웹 콘솔에 cluster-admin 권한이 있는 사용자로 로그인합니다. Red Hat OpenShift Dedicated를 사용하는 경우 dedicated-admin 역할의 계정이 있어야 합니다.
2. 네트워킹 경로로 이동합니다.

3. 경로 페이지의 네임스페이스 메뉴에서 Service Mesh Control Plane 프로젝트(예: istio-system )를 선택합니다.

   위치 열은 각 경로에 대한 연결된 주소를 표시합니다.

4. 필요한 경우 필터를 사용하여 jaeger 경로를 찾습니다. 경로 위치를 클릭하여 콘솔을 시작합니다.
5. OpenShift로 로그인 을 클릭합니다.

Kiali 콘솔의 절차

1. Kiali 콘솔을 시작합니다.
2. 왼쪽 탐색 창에서 Distributed Tracing 을 클릭합니다.
3. OpenShift로 로그인 을 클릭합니다.

CLI의 프로세스

1. cluster-admin 역할의 사용자로 OpenShift Container Platform CLI에 로그인합니다. Red Hat OpenShift Dedicated를 사용하는 경우 dedicated-admin 역할의 계정이 있어야 합니다.

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. 명령줄을 사용하여 경로의 세부 정보를 쿼리하려면 다음 명령을 입력합니다. 이 예제에서 istio-system 은 Service Mesh Control Plane 네임스페이스입니다.

   $ export JAEGER_URL=$(oc get route -n istio-system jaeger -o jsonpath='{.spec.host}')

3. 브라우저를 시작하고 https://<JAEGER_URL >로 이동합니다. 여기서 < JAEGER_URL >은 이전 단계에서 검색한 경로입니다.
4. OpenShift Container Platform 콘솔에 액세스하는 데 사용하는 것과 동일한 사용자 이름 및 암호를 사용하여 로그인합니다.

5. 서비스 메시에 서비스를 추가하고 생성된 추적이 있는 경우 필터를 사용하고 추적 찾기 버튼을 사용하여 추적 데이터를 검색할 수 있습니다.

   콘솔 설치의 유효성을 확인하는 경우 표시할 추적 데이터가 없습니다.

절차

1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. 프로젝트 메뉴를 클릭하고 Service Mesh Control Plane을 설치한 프로젝트(예: istio-system )를 선택합니다.
3. 경로를 클릭합니다.
4. Grafana 행의 위치 열에서 링크를 클릭합니다.
5. OpenShift Container Platform 인증 정보를 사용하여 Grafana 콘솔에 로그인합니다.

절차

1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. 프로젝트 메뉴를 클릭하고 Service Mesh Control Plane을 설치한 프로젝트(예: istio-system )를 선택합니다.
3. 경로를 클릭합니다.
4. Prometheus 행의 위치 열에서 링크를 클릭합니다.
5. OpenShift Container Platform 인증 정보를 사용하여 Prometheus 콘솔에 로그인합니다.

절차

1. 다음 명령을 실행하여 Kiali의 Thanos에 대한 토큰을 생성합니다.

   1. 다음 명령을 실행하여 SECRET 환경 변수를 설정합니다.

      $ SECRET=`oc get secret -n openshift-user-workload-monitoring |
       grep  prometheus-user-workload-token | head -n 1 | awk '{print $1 }'`

   2. 다음 명령을 실행하여 TOKEN 환경 변수를 설정합니다.

      $ TOKEN=`oc get secret $SECRET -n openshift-user-workload-monitoring -o jsonpath='{.data.token}' | base64 -d`

   3. 다음 명령을 실행하여 Kiali의 Thanos에 대한 토큰을 생성합니다.

      $ oc create secret generic thanos-querier-web-token -n istio-system --from-literal=token=$TOKEN

2. user-workload 모니터링을 위해 Kiali를 구성합니다.

   apiVersion: kiali.io/v1alpha1
   kind: Kiali
   metadata:
     name: kiali-user-workload-monitoring
     namespace: istio-system
   spec:
     external_services:
       istio:
         url_service_version: 'http://istiod-basic.istio-system:15014/version'
       prometheus:
         auth:
           token: secret:thanos-querier-web-token:token
           type: bearer
           use_kiali_token: false
         query_scope:
           mesh_id: "basic-istio-system"
         thanos_proxy:
           enabled: true
         url: https://thanos-querier.openshift-monitoring.svc.cluster.local:9091
     version: v1.65

3. 외부 Prometheus에 대한 SMCP를 구성합니다.

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
     namespace: istio-system
   spec:
     addons:
       prometheus:
         enabled: false 1
       grafana:
         enabled: false 2
       kiali:
         name: kiali-user-workload-monitoring
     meshConfig:
       extensionProviders:
       - name: prometheus
         prometheus: {}

   1

   OSSM에서 제공하는 기본 Prometheus 인스턴스를 비활성화합니다.

   2

   Grafana를 비활성화합니다. 외부 Prometheus 인스턴스에서는 지원되지 않습니다.

4. 모니터링 네임스페이스에서 수신 트래픽을 허용하도록 사용자 정의 네트워크 정책을 적용합니다.

   apiVersion: networking.k8s.io/v1
   kind: NetworkPolicy
   metadata:
     name: user-workload-access
     namespace: info 1
   spec:
     ingress:
     - from:
       - namespaceSelector:
           matchLabels:
             network.openshift.io/policy-group: monitoring
     podSelector: {}
     policyTypes:
     - Ingress

   1

   사용자 정의 네트워크 정책은 모든 네임스페이스에 적용해야 합니다.

5. Istio 프록시에서 트래픽 지표를 활성화하려면 Telemetry 오브젝트를 적용합니다.

   apiVersion: telemetry.istio.io/v1alpha1
   kind: Telemetry
   metadata:
     name: enable-prometheus-metrics
     namespace: istio-system 1
   spec:
     selector: 2
       matchLabels:
         app: info
     metrics:
     - providers:
       - name: prometheus

   1

   컨트롤 플레인 네임스페이스에서 생성된 Telemetry 오브젝트는 메시의 모든 워크로드에 적용됩니다. Telemetry를 하나의 네임스페이스에 적용하려면 대상 네임스페이스에 오브젝트를 생성합니다.

   2

   선택 사항: selector.matchLabels 사양을 설정하면 Telemetry 오브젝트가 대상 네임스페이스의 특정 워크로드에 적용됩니다.

6. ServiceMonitor 오브젝트를 적용하여 Istio 컨트롤 플레인을 모니터링합니다.

   apiVersion: monitoring.coreos.com/v1
   kind: ServiceMonitor
   metadata:
     name: istiod-monitor
     namespace: istio-system 1
   spec:
     targetLabels:
     - app
     selector:
       matchLabels:
         istio: pilot
     endpoints:
     - port: http-monitoring
       interval: 30s
       relabelings:
       - action: replace
         replacement: "basic-istio-system" 2
         targetLabel: mesh_id

   1

   OpenShift Container Platform 모니터링은 ServiceMonitor 및 PodMonitor 오브젝트의 namespaceSelector 사양을 무시하므로 컨트롤 플레인 네임스페이스를 포함하여 모든 메시 네임스페이스에 PodMonitor 오브젝트를 적용해야 합니다.

   2

   "basic-istio-system" 문자열은 SMCP 이름과 해당 네임스페이스의 조합이지만 클러스터의 사용자 워크로드 모니터링을 사용하는 모든 메시에 고유한 레이블을 사용할 수 있습니다. 2단계에서 구성된 Kiali 리소스의 spec.prometheus.query_scope 는 이 값과 일치해야 합니다.

   참고

   user-workload 모니터링을 사용하는 메시가 하나뿐인 경우 Kiali 리소스의 mesh_id 재지정 및 spec.prometheus.query_scope 필드 모두 선택 사항입니다(메쉬_id 레이블이 제거된 경우 여기에 제공된 query_scope 필드를 제거해야 함).

   user-workload 모니터링을 사용하여 여러 메시가 있을 수 있는 경우 Kiali 리소스의 mesh_id 레이블 재지정과 spec.prometheus.query_scope 필드 모두 Kiali 리소스의 메트릭만 표시해야 합니다. Kiali가 배포되지 않는 경우 mesh_id 재레이블링을 계속 적용하는 것이 좋습니다. 따라서 다른 메시와 메트릭을 구분할 수 있습니다.

7. PodMonitor 오브젝트를 적용하여 Istio 프록시에서 지표를 수집합니다.

   apiVersion: monitoring.coreos.com/v1
   kind: PodMonitor
   metadata:
     name: istio-proxies-monitor
     namespace: istio-system 1
   spec:
     selector:
       matchExpressions:
       - key: istio-prometheus-ignore
         operator: DoesNotExist
     podMetricsEndpoints:
     - path: /stats/prometheus
       interval: 30s
       relabelings:
       - action: keep
         sourceLabels: [__meta_kubernetes_pod_container_name]
         regex: "istio-proxy"
       - action: keep
         sourceLabels: [__meta_kubernetes_pod_annotationpresent_prometheus_io_scrape]
       - action: replace
         regex: (\d+);(([A-Fa-f0-9]{1,4}::?){1,7}[A-Fa-f0-9]{1,4})
         replacement: '[$2]:$1'
         sourceLabels: [__meta_kubernetes_pod_annotation_prometheus_io_port,
         __meta_kubernetes_pod_ip]
         targetLabel: __address__
       - action: replace
         regex: (\d+);((([0-9]+?)(\.|$)){4})
         replacement: $2:$1
         sourceLabels: [__meta_kubernetes_pod_annotation_prometheus_io_port,
         __meta_kubernetes_pod_ip]
         targetLabel: __address__
       - action: labeldrop
         regex: "__meta_kubernetes_pod_label_(.+)"
       - sourceLabels: [__meta_kubernetes_namespace]
         action: replace
         targetLabel: namespace
       - sourceLabels: [__meta_kubernetes_pod_name]
         action: replace
         targetLabel: pod_name
       - action: replace
         replacement: "basic-istio-system" 2
         targetLabel: mesh_id

   1

   OpenShift Container Platform 모니터링은 ServiceMonitor 및 PodMonitor 오브젝트의 namespaceSelector 사양을 무시하므로 컨트롤 플레인 네임스페이스를 포함하여 모든 메시 네임스페이스에 PodMonitor 오브젝트를 적용해야 합니다.

   2

   "basic-istio-system" 문자열은 SMCP 이름과 해당 네임스페이스의 조합이지만 클러스터의 사용자 워크로드 모니터링을 사용하는 모든 메시에 고유한 레이블을 사용할 수 있습니다. 2단계에서 구성된 Kiali 리소스의 spec.prometheus.query_scope 는 이 값과 일치해야 합니다.

   참고

   user-workload 모니터링을 사용하는 메시가 하나뿐인 경우 Kiali 리소스의 mesh_id 재지정 및 spec.prometheus.query_scope 필드 모두 선택 사항입니다(메쉬_id 레이블이 제거된 경우 여기에 제공된 query_scope 필드를 제거해야 함).

   user-workload 모니터링을 사용하여 여러 메시가 있을 수 있는 경우 Kiali 리소스의 mesh_id 레이블 재지정과 spec.prometheus.query_scope 필드 모두 Kiali 리소스의 메트릭만 표시해야 합니다. Kiali가 배포되지 않는 경우 mesh_id 재레이블링을 계속 적용하는 것이 좋습니다. 따라서 다른 메시와 메트릭을 구분할 수 있습니다.

8. OpenShift Container Platform 웹 콘솔을 열고 메트릭이 표시되는지 확인합니다.