クラスタの費用の詳細な内訳を表示する

このページでは、GKE の費用の割り当てを使用して、BigQuery への Cloud Billing データのエクスポートで Google Kubernetes Engine（GKE）クラスタの費用の内訳を表示する方法について説明します。

この情報を使用して、クラスタの費用をそのユーザーに分配できます。

潜在的なデータ容量の増加

GKE のコスト割り当てを有効にすると、BigQuery でストレージとクエリの費用が増える可能性があります。正確な増加量は、Pod とクラスタ間で使用する個別のラベルと名前空間の組み合わせの数によって異なります。

GKE の費用の割り当てを有効にしても、GKE 使用の合計費用は変わりません。エクスポートの費用項目の合計は同じで、課金データのエクスポートで作成した既存のクエリとレポートは同じ値を返します。

GKE のコスト割り当てとクラスタ使用状況の測定

GKE の費用割り当ては、次の点でクラスタ使用状況の測定とは異なります。

• GKE の費用の割り当ては、クラスタ情報を取得するためのクラスタ使用状況の測定に代わる手段です。
• GKE の費用の割り当てでは、Looker Studio テンプレートでデータを集計するのではなく、Cloud 請求先アカウントでクラスタの費用を計算します。
• GKE のコスト割り当てを使用すると、Cloud Billing の Google Cloud コンソールと Cloud Billing の詳細なエクスポートでクラスタのコストデータを表示できます。

始める前に

作業を始める前に、次のことを確認してください。

• Google Kubernetes Engine API を有効にする。
Google Kubernetes Engine API の有効化
• このタスクに Google Cloud CLI を使用する場合は、gcloud CLI をインストールして初期化する。すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して最新のバージョンを取得する。

• 詳細な使用料金データを BigQuery にエクスポートする手順を完了していることを確認してください。組織がすでにデータをエクスポートしている場合は、テーブルをクエリするためのアクセス権が必要です。

制限事項

• GKE の費用配賦データは、Cloud Billing BigQuery の詳細な使用料金のエクスポートでのみ表示できます。
• Google Cloud CLI のバージョン 392.0.0 以降が必要です。
• GKE のコスト割り当てを有効にすると、その日から GKE リソースの追加項目を含め課金エクスポートが開始しされます。課金エクスポートでデータのバックフィルは行われません。
• GKE のコスト割り当てを無効にすると、追加の項目を含む請求書のエクスポートは停止されますが、この機能を有効にしている間に生成された以前の項目は変更または削除されません。
• GKE の費用の割り当てデータは、利用したリソースではなくリソース リクエストに基づいています。リソース リクエスト、リソース上限、リソース使用量の違いについては、Kubernetes のベスト プラクティス: リソース リクエストとリソース上限についてのブログ投稿をご覧ください。
• GKE の費用配賦では、次のリソース SKU タイプがサポートされます。
  • Compute Engine VM インスタンスの vCPU に関する SKU
  • Compute Engine VM インスタンスの RAM SKU
  • Compute Engine VM Instance GPU SKU
  • Compute Engine PD Capacity SKU
  • Cloud TPU インスタンスの SKU
• ポッドに 50 を超える Kubernetes ラベルがある場合、Google Cloud コンソールの Cloud Billing セクションまたは Cloud Billing の詳細なエクスポートで、これらのラベルは使用できません。
• GKE の費用割り当てを有効にしてから、Cloud Billing にデータが表示されるまでに最大 3 日かかることがあります。
• GKE の費用の割り当てには Persistent Disk のデータが含まれますが、以下の例外があります。
  • PersistentVolumeClaims または 汎用エフェメラル ボリュームを介して動的にプロビジョニングされた PersistentVolume リソースのみをサポートします。
  • サポートされるのは、Compute Engine 永続ディスクの CSI ドライバ、あるいは ReadWriteOnce または ReadWriteOncePod アクセスモードの非推奨の kubernetes.io/gce-pd ストレージ プラグインでプロビジョニングされた PersistentVolume リソースのみです。
  • 稼働時間が 30 分未満の Persistent Disk は追跡されない可能性があります。稼働時間が 30 分以上の Persistent Disk は常に追跡されます。
• Cloud TPU のバージョンは Cloud TPU v4 以降である必要があります。

GKE クラスタの費用を表示する

GKE の費用の割り当てを有効にすると、GKE ワークロードのクラスタ名と Namespace が、BigQuery への課金データのエクスポートの labels フィールドに表示されます。

詳しくは、詳細な使用料金データのスキーマに関する記事をご覧ください。

また、オーバーヘッドと未割り当てリソースを追跡するために、次の Namespace が使用されます。

• kube:system-overhead: Pod で使用できないノードリソース。これらのリソースは、Kubernetes フレームワーク（kubelet、kube-proxy、containerd など）を実行するためにシステムによって確保されます。これは、ノードの容量と割り当て可能なリソースの違いです。
• kube:unallocated: リソースはワークロードによってリクエストされず、またシステム オーバーヘッドのためにもリクエストされません。

GKE がリソースの費用の割り当てを判断できない場合、エクスポート データには次のいずれかの値が含まれます。

• goog-k8s-unknown: Cloud Billing で SKU を処理できませんでした。これは、新しい Compute Engine インスタンスがプロビジョニングされている場合に発生する可能性があります。たとえば、GKE がクラスタを自動スケーリングする場合など、ノードが起動またはシャットダウンするときに goog-k8s-unknown 値が変化することがあります。
• goog-k8s-unsupported-sku: GKE の費用の割り当てでは、この SKU がサポートされていません。これは <blank>/NULL と同様に扱います。SKU にこの値が常にラベル付けされる保証はありません。
• <blank>/NULL: GKE の費用割り当てでは、このリソースは追跡されません。これは、GKE の費用割り当てが有効になっていないか、リソースが GKE マネージド クラスタに属していない場合に発生します。

Persistent Disk の費用は、Persistent Disk のバッキング PersistentVolumeClaims が Pod によって要求されたときに追跡されます。Persistent Disk の費用は、PersistentVolumeClaims が削除されるまで、要求元の Pod のメタデータ（Pod のラベルや Namespace など）をすべて継承します。削除されても、ポリシーの再要求に従って PersistentVolumes が保持されている PersistentVolumeClaims については、Persistent Disk の費用は未割り当てとして追跡されます。

PersistentVolumeClaims に直接適用されたラベルは、Google Cloud コンソールの [Cloud Billing] セクションや Cloud Billing の詳細なエクスポートに表示されません。

GKE の費用配賦を有効にする

gcloud CLI または Google Cloud コンソールを使用して、新規または既存のクラスタで GKE の費用割り当てを有効にできます。

新しいクラスタを作成する

gcloud container clusters create CLUSTER_NAME \
    --enable-cost-allocation \
    --region=COMPUTE_REGION

クラスタの更新

gcloud container clusters update CLUSTER_NAME \
    --enable-cost-allocation

GKE の費用配賦が有効になっていることを確認する

gcloud container clusters describe CLUSTER_NAME

...
costManagementConfig:
  enabled: true
...

GKE の費用データをフィルタする

次のサンプルクエリは、サポートされているリソースタイプの GKE の費用を、クラスタ名、名前空間、ラベルでフィルタしてグループ化する方法を示しています。

SELECT
  labels.value as namespace,
  SUM(cost) + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0)) AS cost_after_credits,
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "k8s-namespace"
GROUP BY namespace
;

SELECT
  SUM(cost) AS cost_before_credits,
  labels.value AS cluster_name
FROM  `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "goog-k8s-cluster-name"
GROUP BY labels.value
;

SELECT
  project.id AS project_id,
  labels.value AS cluster_name,
  sku.id AS sku_id,
  sku.description AS sku_description,
  SUM(cost) AS cost
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
JOIN UNNEST(labels) AS labels
  ON labels.key = "goog-k8s-cluster-name"
GROUP BY
  cluster_name, project_id, sku_description, sku_id
;

BILLING_DATASET_TABLE は、BigQuery で作成したデータセットの名前に置き換えます。

テーブル名は gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID> のようになります。

クリーンアップ

このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、クラスタの GKE の費用配賦を無効にします。

gcloud container clusters update CLUSTER_NAME \
    --no-enable-cost-allocation

作成したクラスタを削除することもできます。

次のステップ

• Cloud Billing データのエクスポート クエリの例を確認する。
• Looker Studio で費用を可視化する方法を確認する。