CNCF 호환 연결 클러스터에 Cloud Monitoring 설치

이 페이지에서는 GKE 연결 클러스터에 대한 Google Cloud Managed Service for Prometheus를 사용하여 관리형 데이터 수집을 설정하는 방법을 설명합니다. 이 기능은 Kubernetes 버전 1.25 이상을 실행하는 Google Cloud 클러스터에서 사용할 수 있습니다. 이 기능은 이전에 해당 버전에서 이 기능의 미리보기를 등록한 고객 버전 1.24의 Kubernetes 클러스터에서도 지원됩니다.

이 기능을 사용하면 PodMonitoring 리소스를 사용하여 Cloud Monitoring에 수집할 측정항목을 선택할 수 있습니다. 그런 다음 Google Cloud 콘솔에서 이러한 측정항목을 볼 수 있습니다.

제한사항

  • 버전 1.24 이전의 Kubernetes 클러스터에서는 이 기능을 사용할 수 없습니다.
  • 이 기능에는 Linux 워크로드가 필요합니다.

관리형 데이터 수집 설정

Managed Service for Prometheus로 관리형 데이터 수집을 설정하려면 다음 단계를 완료하세요.

  1. 측정항목을 작성할 수 있도록 gmp-system/collector 및 gmp-system/rule-evaluator 서비스 계정을 승인합니다.

      gcloud projects add-iam-policy-binding GOOGLE_PROJECT_ID \
      --member="serviceAccount:GOOGLE_PROJECT_ID.svc.id.goog[gmp-system/collector]" \
      --role=roles/monitoring.metricWriter
  gcloud projects add-iam-policy-binding GOOGLE_PROJECT_ID \
      --member="serviceAccount:GOOGLE_PROJECT_ID.svc.id.goog[gmp-system/rule-evaluator]" \
      --role=roles/monitoring.viewer
  gcloud projects add-iam-policy-binding GOOGLE_PROJECT_ID \
      --member="serviceAccount:GOOGLE_PROJECT_ID.svc.id.goog[gmp-system/rule-evaluator]" \
      --role=roles/monitoring.metricWriter

    GOOGLE_PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

    Google Cloud 프로젝트에 클러스터가 하나 이상 생성되어 있지 않으면 이 IAM 바인딩이 추가되지 않습니다. 이는 참조하는 워크로드 아이덴티티 풀(GOOGLE_PROJECT_ID.svc.id.goog)이 클러스터를 만들 때까지 프로비저닝되지 않기 때문입니다.

  2. gcloud container attached clusters register 명령어를 사용하여 클러스터를 등록하고 --enable-managed-prometheus 플래그(선택사항)를 포함합니다.

  3. 수집할 워크로드 측정항목을 구성하려면 PodMonitoring 리소스를 설정합니다. 예시를 보려면 Managed Service for Prometheus로 관리형 데이터 수집 문서에서 PodMonitoring 리소스 구성을 참조하세요.

Managed Service for Prometheus로 관리형 데이터 수집을 사용 설정하면 GKE 연결 클러스터가 gmp-system 네임스페이스를 만듭니다. 이 네임스페이스에서는 수정하거나 배포하지 마세요. GKE 연결 클러스터도 gmp-public 네임스페이스를 만듭니다. Managed Service for Prometheus는 gmp-public 네임스페이스를 사용하여 OperatorConfig 리소스를 배포합니다.

Prometheus 구성 업데이트

Prometheus 데이터 수집을 사용 중지하거나 다시 사용 설정하려면 gcloud container attached clusters update 명령어를 사용합니다. 클러스터를 업데이트할 때 --disable-managed-prometheus 또는 --enable-managed-prometheus 선택적 플래그를 포함합니다.

다음 단계