排查拉取提交问题

使用 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
  2. 打开 Google Cloud 控制台并激活 Cloud Shell。
    3. 打开 Cloud 控制台
  3. 粘贴复制的命令。
  4. 运行 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 使用说明。