このページでは、GKE バージョン 1.28 以降で、Google Kubernetes Engine(GKE)クラスタを GKE Dataplane V2 オブザーバビリティで構成する方法を示します。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 の指標を使用するには、指標をスクレイピングして Google Cloud Managed Service for Prometheus に送信するように ClusterPodMonitoring
リソースを構成します。
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
フラグは、Google Cloud Managed Service for Prometheus で指標を使用するように GKE に指示します。
既存のクラスタで 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
ポート転送を使用して Service を公開します。
kubectl -n gke-managed-dpv2-observability port-forward service/hubble-ui 16100:80 --address='0.0.0.0'
ウェブブラウザで Hubble UI にアクセスします。