2.17. 메트릭, 로그 및 추적

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. 왼쪽 탐색 창에서 분산 추적 을 클릭합니다.
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 네임스페이스입니다.

   $ 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 서비스 계정에 cluster-monitoring-view 역할을 부여합니다.

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: kiali-monitoring-rbac
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: cluster-monitoring-view
   subjects:
   - kind: ServiceAccount
     name: kiali-service-account
     namespace: istio-system

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

   apiVersion: kiali.io/v1alpha1
   kind: Kiali
   metadata:
     name: kiali-user-workload-monitoring
     namespace: istio-system
   spec:
     external_services:
       prometheus:
         auth:
           type: bearer
           use_kiali_token: true
         query_scope:
           mesh_id: "basic-istio-system"
         thanos_proxy:
           enabled: true
         url: https://thanos-querier.openshift-monitoring.svc.cluster.local:9091

   • Istio Operator 2.4를 사용하는 경우 이 구성을 사용하여 사용자 워크로드 모니터링을 위해 Kiali를 구성합니다.

     apiVersion: kiali.io/v1alpha1
     kind: Kiali
     metadata:
       name: kiali-user-workload-monitoring
       namespace: istio-system
     spec:
       external_services:
         istio:
           config_map_name: istio-<smcp-name>
           istio_sidecar_injector_config_map_name: istio-sidecar-injector-<smcp-name>
           istiod_deployment_name: istiod-<smcp-name>
           url_service_version: 'http://istiod-<smcp-name>.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: istio-system 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

   Istiod 서비스를 모니터링하므로 Istio 컨트롤 플레인 네임스페이스에서 이 ServiceMonitor 오브젝트를 생성합니다. 이 예에서 네임스페이스는 istio-system 입니다.

   2

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

   참고

   사용자 작업 부하 모니터링을 사용하는 메시가 하나만 있는 경우 Kiali 리소스의 mesh_id 레이블 재지정 및 spec.prometheus.query_scope 필드는 모두 선택 사항입니다(그러나 mesh_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 는 이 값과 일치해야 합니다.

   참고

   사용자 작업 부하 모니터링을 사용하는 메시가 하나만 있는 경우 Kiali 리소스의 mesh_id 레이블 재지정 및 spec.prometheus.query_scope 필드는 모두 선택 사항입니다(그러나 mesh_id 레이블이 제거된 경우 여기에 제공된 query_scope 필드를 제거해야 합니다).

   클러스터의 여러 메시 인스턴스가 user-workload 모니터링을 사용할 수 있는 경우 Kiali 리소스의 mesh_id 레이블 재지정과 spec.prometheus.query_scope 필드가 모두 필요합니다. 이렇게 하면 Kiali가 연결된 메시의 지표만 볼 수 있습니다.

   Kiali를 배포하지 않는 경우 mesh_id 레이블 재지정을 적용하여 다른 메시와 메트릭을 구분할 수 있습니다.

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