Data Boost 割り当て使用量のモニタリングと管理

Spanner Data Boost には、プロジェクトごととリージョンごとに実行される ExecuteStreamingSQL と StreamingRead の同時呼び出し数を制限する割り当てが適用されます。同時実行リクエストの数が割り当てを超えると、リクエストは失敗し、RESOURCE EXHAUSTED エラーが返されます。

割り当て量を確認する

プロジェクトの同時実行割り当てを確認する手順は次のとおりです。

  1. Google Cloud コンソールで [割り当て] ページに移動します。

    [割り当て] に移動

  2. [フィルタ] フィールドに「databoost」と入力します。リストから、次のいずれかを選択します。

    • Data Boost の同時リクエストの割り当てを表示する DataBoostQuotaPerProjectPerRegion。
    • DataBoostMilliQuotaPerProjectPerRegion: Data Boost の同時リクエストの割り当てをミリオペレーションで表示します。

  3. 結果のテーブルでリージョンを見つけて、そのリージョンの上限を確認します。

割り当て使用量をモニタリングする

割り当て使用量をモニタリングする手順は次のとおりです。

  1. Google Cloud コンソールで [Monitoring] に移動します。
    [Monitoring] に移動
  2. ナビゲーション メニューに [Metrics Explorer] が表示されている場合は、これを選択します。それ以外の場合は、[リソース] を選択して [Metrics Explorer] を選択します。
  3. ページの上部で、期間を選択します。
  4. [指標] プルダウン リストで [リソース名または指標名でフィルタ] フィールドに「consumer」と入力し、Enter を押して検索を絞り込みます。
  5. Data Boost の同時リクエストの割り当てを表示するには:
    1. リストで、[Consumer Quota] > [Quota] > [Concurrent Quota usage] を選択して、[適用] をクリックします。
    2. [+ フィルタを追加] をクリックしてフィルタを作成します。
    3. [ラベル 1] プルダウン リストで、[quota_metric] を選択します。
    4. [値 1] テキスト フィールドで、spanner.googleapis.com/data_boost_quota を入力または選択します。

  6. Data Boost の同時リクエストの割り当てをミリオペレーションで表示するには:

    1. リストで、[Consumer Quota] > [Quota] > [Rate Quota usage] を選択して、[適用] をクリックします。
    2. [+ フィルタを追加] をクリックしてフィルタを作成します。
    3. [ラベル 1] プルダウン リストで、[quota_metric] を選択します。
    4. [値 1] テキスト フィールドで、spanner.googleapis.com/data_boost_milli_quota を入力または選択します。

    Metrics Explorer に、リージョン別の割り当て使用量が折れ線グラフで表示されます。

  7. 省略可: [表示] の [ウィジェット タイプ] で、[積み上げ棒グラフ] を選択します。

割り当てエラーと上限をモニタリングする

Data Boost の同時リクエストの割り当てによる割り当てエラーをモニタリングする手順は次のとおりです。

  1. Metrics Explorer で、指標 Consumer Quota > Quota exceeded error を選択します。

  2. quota_metric に spanner.googleapis.com/data_boost_quota と等しいフィルタを追加します。

Data Boost の同時リクエストのミリオペレーションの割り当ての上限をモニタリングする手順は次のとおりです。

  1. Metrics Explorer で、指標 [Consumer Quota] > [Quota limit] を選択します。

  2. quota_metric に spanner.googleapis.com/data_boost_milli_quota と等しいフィルタを追加します。

Data Boost の使用状況に関するアラートを設定する

プロジェクトごととリージョンごとに Data Boost（ExecuteStreamingSQL と StreamingRead の同時呼び出し）をリクエストする同時分割クエリの数が特定のしきい値を超えた場合に通知するアラート ポリシーを作成できます。方法は次のとおりです。

  1. 指標しきい値のアラート ポリシーを作成するの手順に沿って操作します。
  2. [指標の選択] プルダウン リストで、[リソース名または指標名でフィルタ] フィールドに「consumer」と入力し、Enter を押して検索を絞り込みます。

  3. Data Boost の同時リクエスト数の割り当て使用量に関するアラートを設定するには:

    1. [指標を選択] リストで、[Consumer Quota] > [Quota] > [Concurrent Quota usage] を選択し、[適用] をクリックします。
    2. [フィルタの追加] セクションで [フィルタを追加] をクリックしてフィルタを作成します。
    3. [フィルタ] プルダウン リストで、[quota_metric] を選択します。
    4. [値] テキスト フィールドで、spanner.googleapis.com/data_boost_quota を入力または選択し、[完了] をクリックします。
    5. アラート ポリシーの作成を続行し、しきい値を割り当ての割合で設定します。

    たとえば、デフォルトの割り当てが 200 で、同時実行リクエスト数が最大数の 80% に達したときに通知する場合は、[しきい値] フィールドに 160 を入力します。

  4. Data Boost の同時リクエストのミリオペレーションの割り当て使用量に関するアラートを設定するには:

    1. [指標を選択] リストで、[Consumer Quota] > [Quota] > [Rate Quota usage] を選択し、[適用] をクリックします。
    2. [フィルタの追加] セクションで [フィルタを追加] をクリックしてフィルタを作成します。
    3. [フィルタ] プルダウン リストで、[quota_metric] を選択します。
    4. [値] テキスト フィールドで、spanner.googleapis.com/data_boost_milli_quota を入力または選択し、[完了] をクリックします。
    5. アラート ポリシーの作成を続行し、しきい値を割り当ての割合で設定します。

    たとえば、デフォルトの割り当てが 1,000,000 で、リクエストのミリオペレーション数が上限の 80% に達したときに通知する場合は、[しきい値] フィールドに「800,000」と入力します。

割り当てエラーを処理する

割り当て超過エラーの割合が高い場合に、Data Boost で Dataflow を使用する場合は、Data Boost の割り当てを超えないように、Dataflow ジョブのワーカーの最大数を調整することをおすすめします。割り当ての増加を申し込むこともできます。ワークロードは、Data Boost の同時リクエストの割り当てまたはミリオペレーションの割り当てによって制限されることがあります。同時リクエストの割り当てを増やした後で、ミリオペレーションの割り当てを増やす必要がある場合があります。

プリンシパルが Data Boost リソースを使用できないようにする

あるプリンシパルが、想定される Data Boost リソースの量を常に超えている場合は、プリンシパルから spanner.databases.useDataBoost Identity and Access Management（IAM）権限を取り消すことで、プリンシパルによる Data Boost リソースの使用をブロックできます。権限の取り消しは、アラートの通知チャネルを Cloud Functions を呼び出す Webhook として構成することで自動化できます。詳細については次のトピックをご覧ください。

次のステップ