本页提供了一些常见的问题排查提示 Cloud Storage 订阅。
检查 Cloud Storage 订阅的状态
如需查看订阅的状态,请执行以下步骤:
在 Google Cloud 控制台中,前往 Pub/Sub 订阅页面。
检查 Cloud Storage 订阅的状态图标。
如果该图标是绿色对勾标记,则表示订阅状况良好。
如果该图标是红色感叹号,则表示订阅处于错误状态。
点击 Cloud Storage 订阅。
系统会打开订阅详情页面。
检查订阅状态是否存在错误消息。
问题解决后,订阅最终会恢复为 运行状况良好。
无法创建或更新订阅
这里是你在遇到问题时可能会遇到的一些常见问题 创建或更新 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
[email protected]
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.
要解决此问题,请检查服务账号是否 正确的权限。
订阅状态显示红色感叹号
如果您在创建订阅后修改存储桶,则可能会影响 Pub/Sub 如何将消息写入存储桶。如果更改导致 那么订阅的状态字段就是 设置为错误状态。
在订阅详情页面中,检查 Subscription state
字段的状态。
Subscription state
字段提供更具体的错误,
可以是以下某一项:
当 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 仍有问题 请参阅获取支持。