排解拉取提交問題

使用 gcpdiag 工具,找出並修正提取訂閱項目的潛在傳送問題。

使用 gcpdiag 工具

gcpdiag 是開放原始碼工具。並非官方支援的 Google Cloud 產品。您可以使用 gcpdiag 工具,找出並修正 Google Cloud專案問題。詳情請參閱 GitHub 上的 gcpdiag 專案。

gcpdiag 工具會執行下列檢查,協助您找出 Pub/Sub 提取傳送問題:

  • 配額錯誤:評估 Logs Explorer 記錄,檢查區域和可用區是否有任何配額錯誤。
  • 處理量資格:檢查訂閱項目的傳遞延遲時間健康狀態。

如需 gcpdiag 提取推送評估步驟清單,請參閱「可能步驟」。

執行 gcpdiag 指令

您可以透過 Google Cloud CLI 或在 Docker 容器中執行 gcpdiag 指令。

Google Cloud 控制台

  1. 完成並複製下列指令。
  2. gcpdiag runbook pubsub/pull-subscription-delivery \
      --project=PROJECT_ID \
      --parameter subscription_name=SUBSCRIPTION_NAME
  3. 開啟 Google Cloud 控制台,然後啟用 Cloud Shell。
  4. 開啟 Cloud 控制台
  5. 貼上複製的指令。
  6. 執行 gcpdiag 指令,下載 gcpdiag Docker 映像檔,然後執行診斷檢查。視情況按照輸出內容中的指示修正失敗的檢查項目。

Docker

您可以使用包裝函式執行 gcpdiag,在 Docker 容器中啟動 gcpdiag。必須安裝 Docker 或 Podman。

  1. 請複製下列指令,並在本機工作站執行。
    curl https://gcpdiag.dev/gcpdiag.sh >gcpdiag && chmod +x gcpdiag
  2. 執行 gcpdiag 指令。
    ./gcpdiag runbook pubsub/pull-subscription-delivery \
      --project=PROJECT_ID \
      --parameter subscription_name=SUBSCRIPTION_NAME

查看這個 Runbook 的可用參數。

更改下列內容:

    • PROJECT_ID:要評估的專案 ID
    • SUBSCRIPTION_NAME::專案中要評估的訂閱項目名稱

實用旗標:

如需所有 gcpdiag 工具旗標的清單和說明,請參閱 gcpdiag 使用說明。