監控及管理 Data Boost 配額用量

Spanner Data Boost 設有配額，限制每項專案和每個區域可同時執行的 ExecuteStreamingSQL 和 StreamingRead 呼叫數量。如果並行要求數量超過配額，要求會失敗並傳回 RESOURCE_EXHAUSTED 錯誤。

查看配額

如要查看專案的並行配額，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Quotas」(配額) 頁面。

    前往配額頁面

  2. 在「Filter」欄位中輸入 databoost。從清單中選取下列其中一項：

    • DataBoostQuotaPerProjectPerRegion：查看 Data Boost 並行要求配額。
    • DataBoostMilliQuotaPerProjectPerRegion：查看 Data Boost 並行要求配額 (以毫作業為單位)。

  3. 在產生的表格中，找出您的區域並查看該區域的限制。

監控配額用量

如要監控配額用量，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Monitoring」。
    前往「Monitoring」
  2. 如果導覽選單中顯示「Metrics Explorer」，請選取該選項。否則，請按一下「Resources」(資源)，然後選取「Metrics Explorer」。
  3. 在頁面頂端選取時間間隔。
  4. 在「Metric」(指標) 下拉式選單的「Filter by resource or metric name」(依資源或指標名稱篩選) 欄位中，輸入 consumer 並按下 Enter 鍵，縮小搜尋範圍。
  5. 如要查看 Data Boost 並行要求配額，請按照下列步驟操作：
    1. 在清單中，依序選取「Consumer Quota」>「Quota」>「Concurrent Quota usage」，然後按一下「Apply」。
    2. 按一下「+ 新增篩選器」，建立篩選器。
    3. 在「Label 1」下拉式選單中，選取「quota_metric」。
    4. 在「Value 1」(值 1) 文字欄位中，輸入或選取 spanner.googleapis.com/data_boost_quota。

  6. 如要查看 Data Boost 並行要求配額 (以毫作業為單位)，請按照下列步驟操作：

    1. 在清單中，依序選取「Consumer Quota」>「Quota」>「Rate Quota usage」，然後按一下「Apply」。
    2. 按一下「+ 新增篩選器」，建立篩選器。
    3. 在「Label 1」下拉式選單中，選取「quota_metric」。
    4. 在「Value 1」(值 1) 文字欄位中，輸入或選取 spanner.googleapis.com/data_boost_milli_quota。

    Metrics Explorer 會顯示各區域配額用量的折線圖。

  7. 選用：在「顯示」下方的「小工具類型」部分，選取「堆疊長條圖」。

監控配額錯誤和限制

如要監控因 Data Boost 並行要求配額而發生的配額錯誤，請按照下列步驟操作：

  1. 在 Metrics Explorer 中，依序選取「Consumer Quota」(消費者配額) >「Quota」(配額) >「Quota exceeded error」(超過配額錯誤) 指標。

  2. 新增篩選條件，將 quota_metric 設為等於 spanner.googleapis.com/data_boost_quota。

如要監控 Data Boost 並行要求毫作業配額的限制，請按照下列步驟操作：

  1. 在 Metrics Explorer 中，依序選取「Consumer Quota」(消費者配額) >「Quota」(配額) >「Quota limit」(配額限制)。

  2. 新增篩選條件，將 quota_metric 設為等於 spanner.googleapis.com/data_boost_milli_quota。

設定 Data Boost 用量快訊

您可以建立警告政策，在每個專案和區域中，要求 Data Boost 的並行分區查詢數量 (並行 ExecuteStreamingSQL 和 StreamingRead 呼叫) 超過特定門檻時，向您發出通知。步驟如下：

  1. 請按照「建立指標門檻警告政策」中的操作說明進行。
  2. 在「Select a metric」(選取指標) 下拉式選單的「Filter by resource or metric name」(依資源或指標名稱篩選) 欄位中，輸入 consumer 並按下 Enter，縮小搜尋範圍。

  3. 如要設定 Data Boost 並行要求配額用量快訊，請按照下列步驟操作：

    1. 在「Select a metric」(選取指標) 清單中，依序選取「Consumer Quota」(消費者配額) >「Quota」(配額) >「Concurrent Quota usage」(並行配額用量)，然後按一下「Apply」(套用)。
    2. 在「新增篩選器」部分，按一下「新增篩選器」建立篩選器。
    3. 在「Filter」(篩選器) 下拉式選單中，選取「quota_metric」。
    4. 在「Value」(值) 文字欄位中，輸入或選取 spanner.googleapis.com/data_boost_quota，然後按一下「Done」(完成)。
    5. 繼續建立警告政策，並將門檻設為配額的特定百分比。

    舉例來說，如果預設配額為 200，而您希望在並行要求數量達到上限的 80% 時收到通知，請在「Threshold value」(門檻值) 欄位中輸入 160。

  4. 如要設定 Data Boost 並行要求毫作業配額用量快訊，請按照下列步驟操作：

    1. 在「Select a metric」(選取指標) 清單中，依序選取「Consumer Quota」(消費者配額) >「Quota」(配額) >「Rate Quota usage」(頻率配額用量)，然後按一下「Apply」(套用)。
    2. 在「新增篩選器」部分，按一下「新增篩選器」建立篩選器。
    3. 在「Filter」(篩選器) 下拉式選單中，選取「quota_metric」。
    4. 在「Value」(值) 文字欄位中，輸入或選取 spanner.googleapis.com/data_boost_milli_quota，然後按一下「Done」(完成)。
    5. 繼續建立警告政策，並將門檻設為配額的特定百分比。

    舉例來說，如果預設配額為 1000000，而您希望在要求毫作業數達到上限的 80% 時收到通知，請在「Threshold value」(門檻值) 欄位中輸入 800000。

處理配額錯誤

如果搭配 Data Boost 使用 Dataflow 時，超出配額錯誤率偏高，建議您調整 Dataflow 工作中的 worker 數量上限，以免超出 Data Boost 配額。您也可以申請提高配額。工作負載可能會受到 Data Boost 並行要求配額或毫作業配額的限制。提高並行要求配額後，您可能需要提高毫作業配額。

禁止主體使用 Data Boost 資源

如果某個主體持續超出合理預期的 Data Boost 資源用量，您可以撤銷該主體的 spanner.databases.useDataBoost Identity and Access Management (IAM) 權限，禁止其使用 Data Boost 資源。您可以將快訊的通知管道設為叫用 Cloud 函式的 Webhook，自動撤銷權限。如需詳細資訊，請參閱下列主題：

後續步驟