2.12. 메트릭에 클러스터 ID 라벨 추가

프로세스

1. openshift-monitoring 프로젝트에서 cluster-monitoring-config ConfigMap 오브젝트를 편집합니다.

   $ oc -n openshift-monitoring edit configmap cluster-monitoring-config

   참고

   사용자 정의 프로젝트를 모니터링하는 Prometheus 인스턴스에 대한 클러스터 ID 레이블을 구성하는 경우 openshift-user-workload-monitoring 네임스페이스에서 user-workload-monitoring-config 구성 맵을 편집합니다. Prometheus 구성 요소는 이 구성 맵에서 prometheus 라고 하며 prometheusK8s 가 아닌 cluster-monitoring-config 구성 맵에 사용되는 이름입니다.

2. data/config.yaml/prometheusK8s/remoteWrite 의 writeRelabelConfigs: 섹션에서 클러스터 ID 레이블을 다시 지정한 구성 값을 추가합니다.

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cluster-monitoring-config
     namespace: openshift-monitoring
   data:
     config.yaml: |
       prometheusK8s:
         remoteWrite:
         - url: "https://remote-write-endpoint.example.com"
           <endpoint_authentication_credentials>
           writeRelabelConfigs: 1
             - <relabel_config> 2

   1

   원격 끝점으로 보낼 지표에 대한 쓰기 레이블 구성 목록을 추가합니다.

   2

   원격 쓰기 엔드포인트로 전송된 지표의 레이블 구성을 사용합니다.

   다음 샘플은 기본 플랫폼 모니터링에서 클러스터 ID 레이블 cluster_id 로 메트릭을 전달하는 방법을 보여줍니다.

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: cluster-monitoring-config
     namespace: openshift-monitoring
   data:
     config.yaml: |
       prometheusK8s:
         remoteWrite:
         - url: "https://remote-write-endpoint.example.com"
           writeRelabelConfigs:
           - sourceLabels:
             - __tmp_openshift_cluster_id__ 1
             targetLabel: cluster_id 2
             action: replace 3

   1

   처음에는 시스템이 __tmp_openshift_cluster_id___라는 임시 클러스터 ID 소스 레이블을 적용합니다. 이 임시 레이블은 사용자가 지정하는 클러스터 ID 레이블 이름으로 대체됩니다.

   2

   원격 쓰기 스토리지로 전송된 메트릭의 클러스터 ID 레이블 이름을 지정합니다. 지표에 이미 존재하는 레이블 이름을 사용하는 경우 해당 값은 이 클러스터 ID 레이블의 이름으로 덮어씁니다. 레이블 이름의 경우 __tmp_openshift_cluster_id__ 를 사용하지 마십시오. 마지막 레이블 재지정 단계는 이 이름을 사용하는 라벨을 제거합니다.

   3

   교체 write 레이블은 임시 레이블을 발신 메트릭의 target 레이블로 교체합니다. 이 작업은 기본값이며 작업이 지정되지 않은 경우 적용됩니다.

3. 파일을 저장하여 ConfigMap 오브젝트에 대한 변경 사항을 적용합니다. 업데이트된 구성의 영향을 받는 Pod가 자동으로 다시 시작됩니다.

   주의

   모니터링 ConfigMap 오브젝트에 대한 변경 사항을 저장하면 관련 프로젝트에서 Pod 및 기타 리소스를 재배포할 수 있습니다. 변경 사항을 저장하면 해당 프로젝트에서 실행 중인 모니터링 를 다시 시작할 수도 있습니다.