排解拉取提交問題

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

使用 gcpdiag 工具

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

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

  • 配額錯誤：評估記錄檔探索工具記錄，檢查區域和地帶是否有任何配額錯誤。
  • 輸送量資格：檢查訂閱項目的傳遞延遲時間健康狀態。

如需 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
  2. 開啟 Google Cloud 控制台並啟用 Cloud Shell。
    3. 開啟 Cloud 控制台
  3. 貼上複製的指令。
  4. 執行 gcpdiag 指令，下載 gcpdiag Docker 映像檔，然後執行診斷檢查。如果適用，請按照輸出內容中的操作說明修正失敗的檢查。

Docker

您可以使用在 Docker 容器中啟動 gcpdiag 的 wrapper 執行 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 使用說明。