ラベルを使用してインスタンスを整理し、費用を表示する

このページでは、 Google Cloud ラベルを使用して Spanner インスタンスを整理し、費用の詳細な内訳を表示する方法について説明します。

Google Cloud ラベルは、Spanner インスタンスなどの個々の Google Cloud リソースに割り当てることができる Key-Value ペアです。

ラベルは、これらのリソースを整理し、必要な粒度で費用を表示する場合に役立ちます。ラベルに関する情報は課金システムに転送され、請求料金をラベル別に分類できます。ラベルの詳細については、ラベルの概要をご覧ください。

ラベルの一般的なユースケース

ラベルの一般的なユースケースは次のとおりです。

  • チームまたはコストセンターのラベル: 費用計算または予算作成のために、各チームが所有するリソース（team:research、team:analytics など）を区別します。
  • 環境ラベル: 開発環境、テスト環境、本番環境を指定します（env:dev、env:test、env:prod など）。
  • コンポーネント ラベル: アプリケーション コンポーネントまたはワークロード タイプ（component:frontend、component:backend など）でリソースを分類します。
  • きめ細かいインスタンス レベルのトラッキング: Spanner インスタンスに独自の ID または特定の識別子（instance_id:my-instance-1 など）でラベルを付け、請求レポートまたは BigQuery クエリでインスタンスごとの費用を直接分類します。

要件と制約

Spanner インスタンスに適用するラベルは、次の要件を満たす必要があります。

  • 各インスタンスには最大 64 個のラベルを設定できます。
  • キーと値は 63 文字以下にする必要があります。
  • キーと値には、小文字、数字、アンダースコア（_）、ダッシュ（-）のみを使用できます。
  • キーは、小文字または国際文字で始める必要があります。キーは空にできません。
  • ラベルのキー部分は、単一のインスタンス内で一意である必要があります。

Spanner インスタンスにラベルを追加して管理する

ラベルは、Spanner インスタンスの作成時に追加することも、既存のインスタンスのラベルを更新することもできます。

必要な権限

Spanner インスタンスのラベルを表示して管理するには、次の IAM 権限が必要です。

  • spanner.instances.get
  • spanner.instances.update

これらの権限は、roles/spanner.admin ロールに含まれています。

ラベルを追加、更新、削除する

コンソール

  1. Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。

    [Spanner インスタンス] に移動

  2. ラベルを付けるインスタンスの横にあるチェックボックスをオンにします。[情報パネル] が表示されます。

  3. [情報パネル] で [ラベル] を選択します。

  4. インスタンスのラベルを追加、更新、削除してから、[保存] をクリックします。

gcloud

ラベル付きの Spanner インスタンスを作成するには、--labels フラグを指定して gcloud spanner instances create コマンドを実行します。

gcloud spanner instances create INSTANCE_ID \
    --config=INSTANCE_CONFIG \
    --description=INSTANCE_NAME \
    --nodes=NODE_COUNT \
    --labels=KEY=VALUE,KEY=VALUE

既存のインスタンスにラベルを追加または更新するには、--update-labels フラグを指定して gcloud spanner instances update コマンドを実行します。

gcloud spanner instances update INSTANCE_ID \
    --update-labels=KEY=VALUE,KEY=VALUE

既存のインスタンスから特定のラベルを削除するには、--remove-labels フラグを使用します。

gcloud spanner instances update INSTANCE_ID \
    --remove-labels=KEY1,KEY2

既存のインスタンスからすべてのラベルをクリアするには、--clear-labels フラグを使用します。

gcloud spanner instances update INSTANCE_ID --clear-labels

Cloud Billing でラベル別に Spanner の費用を分析する

Spanner インスタンスにラベルを適用すると、そのラベルを使用して費用を分析できます。ラベルは費用データに転送されるため、料金をフィルタしてグループ化できます。

請求レポートでラベル別にグループ化された費用を表示する

ラベルキーでグループ化された Spanner の費用は、 Google Cloud コンソールで直接表示して分析できます。

  1. Google Cloud コンソールで、[お支払い] セクションに移動します。
  2. [請求先アカウント] を選択し、ナビゲーション ペインで [レポート] をクリックします。
  3. [フィルタ] パネルで次の操作を行います。
    1. [サービス] で [Spanner] を選択して、Spanner データベースの費用を分離します。
    2. [グループ化] で、[ラベルキー] を選択し、分析するラベルキー（environment や instance_id など）を選択します。
  4. グラフと費用表が更新され、各ラベル値（environment:prod と environment:dev、instance_id:my-instance-1 と instance_id:my-instance-2 など）でグループ化された費用の詳細な内訳が表示されます。