排查 Cloud Storage 订阅问题

本页提供了一些常见的问题排查提示 Cloud Storage 订阅。

检查 Cloud Storage 订阅的状态

如需查看订阅的状态，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Pub/Sub 订阅页面。

    前往订阅页面。

  2. 检查 Cloud Storage 订阅的状态图标。

    • 如果该图标是绿色对勾标记，则表示订阅状况良好。

    • 如果该图标是红色感叹号，则表示订阅处于错误状态。

  3. 点击 Cloud Storage 订阅。

    系统会打开订阅详情页面。

  4. 检查订阅状态是否存在错误消息。

  5. 根据错误消息，转到此 以排查问题。

问题解决后，订阅最终会恢复为 运行状况良好。

无法创建或更新订阅

这里是你在遇到问题时可能会遇到的一些常见问题 创建或更新 Cloud Storage 订阅。

“未找到存储分区”错误

您在创建或更新订阅工作流中指定的存储桶 不存在，则工作流会返回 bucket not found 错误。 在 Google Cloud 控制台中，消息类似于以下内容：

The Cloud Storage bucket specified cannot be found.

如需解决此问题，请创建存储桶 或者更新您的 Cloud Storage 订阅以使用现有存储桶。

服务账号错误

如果您尚未使用 合适的权限 创建或更新订阅工作流会返回错误。 在 Google Cloud 控制台中，消息类似于以下内容：

Cloud Pub/Sub did not have the necessary permissions configured to access
the provided bucket my-bucket (or the bucket may not exist).
Please verify that the service account
service-112233445566@gcp-sa-pubsub.iam.gserviceaccount.com
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.

要解决此问题，请检查服务账号是否 正确的权限。

订阅状态显示红色感叹号

如果您在创建订阅后修改存储桶，则可能会影响 Pub/Sub 如何将消息写入存储桶。如果更改导致 那么订阅的状态字段就是 设置为错误状态。

在订阅详情页面中，检查 Subscription state 字段的状态。 Subscription state 字段提供更具体的错误， 可以是以下某一项：

  • 找不到存储桶：存储桶已被删除。 再次创建存储桶或更新 来使用现有存储桶。

  • 存储分区权限遭拒：Pub/Sub 服务账号编号 不再具有向存储桶写入数据的权限。检查服务账号是否 正确的权限。

当 Pub/Sub 订阅处于错误状态时， 这些消息不会被写入存储桶 订阅积压消息。请注意，邮件不会递送至 随附的死信主题， （如果已配置）。保留未确认的消息 在message_retention_duration所设时间段（默认为 7 天）内按时续订。

订阅处理消息的速度非常缓慢

某些订阅设置可能会降低消息处理速度。

例如，在 Cloud Storage 上启用消息排序 订阅可能会导致将消息写入 Cloud Storage， 最终使用相同排序键延迟后续消息。 为了提高性能，请考虑使用更广泛的排序键 还是要停用消息排序 则不需要使用它。

您的 Cloud Storage 订阅的文件大小上限设置过低 也会对性能产生负面影响文件大小上限过低 可能导致 Pub/Sub 创建多个 Cloud Storage 对象，而对象中只有一个 减少每个对象中的少量消息。与架构相关的额外开销 创建和完成对象会减慢消息处理速度。 为了获得更好的性能，请考虑提高文件大小上限设置 或移除文件大小限制。

配额限制

另一种可能是您的项目已达到 Pub/Sub 推送 吞吐量配额 (pubsub.googleapis.com/regionalpushsubscriber)。 如需检查是否遇到配额限制，请检查推送请求 指标 (subscription/push_request_count) 针对任何 resource_exhausted 错误。

查看项目的配额，确保您有足够的配额 剩余时间。前往 IAM 和管理 >配额，其中包含 Pub/Sub 订阅。搜索 pubsub.googleapis.com/regionalpushsubscriber 配额。如果您正在访问 配额限制，您可以申请更高的配额。

订阅创建的文件数量超出预期

为了提高可伸缩性，您的 Cloud Storage 订阅 可能由多个 Pub/Sub 后端处理。每个后端 一个单独的 Cloud Storage 文件 您的 Cloud Storage 创建的文件数量超出预期 尤其是低吞吐量的工作负载。

这是正常现象。如果您希望减少 则可以考虑提高您计算机上的文件批量设置 以便存储更大的文件还可以通过以下方式对文件进行后处理： 组合为 因此可以减少大型文件的数量

后续步骤

  • 如果 Cloud Storage 仍有问题 请参阅获取支持。