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

절차

1. ConfigMap 오브젝트를 편집합니다.

   • 핵심 OpenShift Container Platform 메트릭에 대한 클러스터 ID 레이블을 생성하려면 다음을 수행합니다.

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

        $ oc -n openshift-monitoring edit configmap 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

        replace write relabel 작업은 임시 레이블을 발신 지표의 대상 레이블로 교체합니다. 이 작업은 기본값이며 작업이 지정되지 않은 경우 적용됩니다.

   • 사용자 정의 프로젝트 메트릭에 대한 클러스터 ID 레이블을 생성하려면 다음을 수행합니다.

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

        $ oc -n openshift-user-workload-monitoring edit configmap user-workload-monitoring-config

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

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

        1

        원격 끝점에 보낼 지표의 쓰기 재라벨 구성 목록을 추가합니다.

        2

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

        다음 샘플은 user-workload 모니터링에서 클러스터 ID 레이블 cluster_id 를 사용하여 메트릭을 전달하는 방법을 보여줍니다.

        apiVersion: v1
        kind: ConfigMap
        metadata:
          name: user-workload-monitoring-config
          namespace: openshift-user-workload-monitoring
        data:
          config.yaml: |
            prometheus:
              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

        replace write relabel 작업은 임시 레이블을 발신 지표의 대상 레이블로 교체합니다. 이 작업은 기본값이며 작업이 지정되지 않은 경우 적용됩니다.

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

   주의

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