이 페이지에서는 GKE 버전 1.28 이상부터 GKE Dataplane V2 관측 가능성으로 Google Kubernetes Engine(GKE) 클러스터를 구성하는 방법을 보여줍니다. GKE Dataplane V2 관측 가능성의 이점 및 요구사항에 대한 자세한 내용은 GKE Dataplane V2 관측 가능성 정보를 참조하세요.
시작하기 전에
시작하기 전에 다음 태스크를 수행했는지 확인합니다.
- Google Kubernetes Engine API를 사용 설정합니다. Google Kubernetes Engine API 사용 설정
- 이 태스크에 Google Cloud CLI를 사용하려면 gcloud CLI를 설치한 후 초기화합니다. 이전에 gcloud CLI를 설치한 경우
gcloud components update
를 실행하여 최신 버전을 가져옵니다.
GKE Dataplane V2 측정항목 구성
측정항목을 수집하려면 GKE Dataplane V2 측정항목을 구성해야 합니다. 클러스터를 만들거나 GKE Dataplane V2로 실행 중인 클러스터를 업데이트할 때 GKE Dataplane V2 측정항목을 구성할 수 있습니다. gcloud CLI를 사용하여 GKE Dataplane V2 측정항목을 사용 설정하거나 사용 중지할 수 있습니다.
GKE 클러스터에서 GKE Dataplane V2 측정항목 및 Google Cloud Managed Service for Prometheus를 사용 설정하는 것이 좋습니다. 둘 다 사용 설정되면 GKE Dataplane V2 측정항목이 Google Cloud Managed Service for Prometheus로 전송됩니다.
GKE Dataplane V2 측정항목이 사용 설정된 Autopilot 클러스터 만들기
새 GKE Autopilot 클러스터를 만들면 GKE는 특정 플래그가 필요하지 않고 클러스터에서 기본적으로 GKE Dataplane V2 측정항목을 사용 설정합니다.
Google Cloud Managed Service for Prometheus와 함께 GKE Autopilot 클러스터 GKE Dataplane V2 측정항목을 사용하려면 ClusterPodMonitoring
리소스를 구성하여 측정항목을 스크래핑하고 Google Cloud Managed Service for Prometheus로 전송합니다.
ClusterPodMonitoring
매니페스트를 만듭니다.ClusterPodMonitoring
매니페스트를 적용합니다.kubectl apply -f ClusterPodMonitoring.yaml
GKE Dataplane V2 측정항목이 사용 설정된 Standard 클러스터 만들기
GKE Dataplane V2 측정항목을 사용 설정하려면 --enable-dataplane-v2-metrics
플래그로 클러스터를 만듭니다.
gcloud container clusters create CLUSTER_NAME \
--enable-dataplane-v2 \
--enable-ip-alias \
--enable-managed-prometheus \
--enable-dataplane-v2-metrics
다음을 바꿉니다.
CLUSTER_NAME
: 클러스터의 이름
--enable-managed-prometheus
플래그는 GKE가 Google Cloud Managed Service for Prometheus로 측정항목을 사용하도록 지시합니다.
기존 클러스터에서 GKE Dataplane V2 측정항목 사용 설정
기존 클러스터에서 GKE Dataplane V2 측정항목을 사용 설정하려면 다음 명령어를 실행합니다.
gcloud container clusters update CLUSTER_NAME \
--enable-dataplane-v2-metrics
CLUSTER_NAME
을 클러스터 이름으로 바꿉니다.
GKE Dataplane V2 측정항목 사용 중지
GKE Dataplane V2 측정항목을 사용 중지하려면 다음 안내를 따르세요.
gcloud container clusters update CLUSTER_NAME \
--disable-dataplane-v2-metrics
CLUSTER_NAME
을 클러스터 이름으로 바꿉니다.
GKE Dataplane V2 관측 가능성 도구 구성
비공개 엔드포인트를 사용하여 GKE Dataplane V2 관측 가능성 문제 해결 도구에 액세스할 수 있습니다. GKE Dataplane V2 관측 가능성 도구를 사용 설정하려면 GKE Dataplane V2로 구성된 클러스터가 있어야 합니다. 새 클러스터 또는 기존 클러스터에서 GKE Dataplane V2 관측 가능성 도구를 사용 설정할 수 있습니다.
관측 가능성을 사용 설정한 Autopilot 클러스터 만들기
GKE Dataplane V2 관측 가능성을 사용 설정하여 GKE Autopilot 클러스터를 만들려면 다음 단계를 따르세요.
gcloud container clusters create-auto CLUSTER_NAME \
--enable-dataplane-v2-flow-observability
CLUSTER_NAME
을 클러스터 이름으로 바꿉니다.
관측 가능성을 사용 설정한 Standard 클러스터 만들기
GKE Dataplane V2 관측 가능성을 사용 설정하여 GKE Standard 클러스터를 만들려면 다음 안내를 따르세요.
gcloud container clusters create CLUSTER_NAME \
--enable-dataplane-v2 \
--enable-ip-alias \
--enable-dataplane-v2-flow-observability
CLUSTER_NAME
을 클러스터 이름으로 바꿉니다.
기존 클러스터에서 GKE Dataplane V2 관측 가능성 도구 사용 설정
기존 클러스터에서 GKE Dataplane V2 관측 가능성을 사용 설정하려면 다음 명령어를 실행합니다.
gcloud container clusters update CLUSTER_NAME \
--enable-dataplane-v2-flow-observability
CLUSTER_NAME
을 클러스터 이름으로 바꿉니다.
GKE Dataplane V2 관측 가능성 도구 사용 중지
기존 클러스터에서 GKE Dataplane V2 관측 가능성 도구를 사용 중지하려면 다음 명령어를 실행합니다.
gcloud container clusters update CLUSTER_NAME \
--disable-dataplane-v2-flow-observability
CLUSTER_NAME
을 클러스터 이름으로 바꿉니다.
Hubble CLI 사용 방법
GKE Dataplane V2 관측 가능성 기능을 사용 설정한 후 클러스터에서 Hubble CLI 도구를 사용합니다.
hubble-cli
바이너리의 별칭을 정의합니다.alias hubble="kubectl exec -it -n gke-managed-dpv2-observability deployment/hubble-relay -c hubble-cli -- hubble"
GKE Dataplane V2 관측 가능성 기능이 사용 설정된 Hubble 상태를 확인하려면 모든 Autopilot 클러스터에서 Hubble CLI를 사용합니다.
hubble status
현재 트래픽을 보려면 다음과 같이 Hubble CLI를 사용하세요.
hubble observe
Hubble UI 바이너리 배포를 배포하는 방법
GKE Dataplane V2 관측 가능성이 사용 설정되면 오픈소스 Hubble UI를 배포할 수 있습니다.
GKE 클러스터에서 관측 가능성을 사용 설정합니다.
관측 가능성을 사용 설정하여 GKE 클러스터를 만듭니다.
gcloud container clusters create-auto hubble-rc-auto \ --location COMPUTE_LOCATION \ --cluster-version VERSION \ --enable-dataplane-v2-flow-observability
다음을 바꿉니다.
VERSION
: 클러스터의 버전COMPUTE_LOCATION
: 클러스터의 Compute Engine 위치
또는 기존 클러스터에서 관측 가능성을 사용 설정할 수 있습니다.
gcloud container clusters update CLUSTER_NAME \ --location COMPUTE_LOCATION \ --enable-dataplane-v2-flow-observability
다음을 바꿉니다.
CLUSTER_NAME
: 클러스터의 이름COMPUTE_LOCATION
: 클러스터의 Compute Engine 위치
클러스터에 연결하도록
kubectl
을 구성합니다.gcloud container clusters get-credentials CLUSTER_NAME \ --location COMPUTE_LOCATION
바꾸기
CLUSTER_NAME
: 클러스터의 이름COMPUTE_LOCATION
: 클러스터의 Compute Engine 위치
Hubble UI를 배포합니다.
hubble-ui-128.yaml
매니페스트를 적용합니다.kubectl apply -f hubble-ui-128.yaml
포트 전달을 사용하여 서비스 노출:
kubectl -n gke-managed-dpv2-observability port-forward service/hubble-ui 16100:80 --address='0.0.0.0'
웹브라우저에서 Hubble UI에 액세스합니다.