“排查 Cloud Storage 导入问题”主题

本文档提供了一些关于 Cloud Storage 导入主题的常见问题排查提示。

配置导入主题并开始提取消息后，您可以查看相关的 Cloud Monitoring 指标，了解是否已提取数据。执行以下步骤：

  1. 在控制台中，前往主题页面。

    打开“主题”。

  2. 点击要排查的 Cloud Storage 导入主题。

  3. 在主题详情页面中，点击指标标签页。

  4. 查看指标“提取的字节数”的图表。

  5. 如果未提取任何数据，请在主题详情页面中检查主题状态字段是否显示错误和红色感叹号。

  6. 您还可以查看指标 Ingestion data source state。为此，请在主题详情页面中点击指标标签页。

    如需详细了解这些指标，请参阅要监控的指标 - 导入主题。

  7. 以下是您可能会遇到的一些错误：

    错误代码 说明 修复
    CLOUD_STORAGE_PERMISSION_DENIED 由于权限问题，无法使用 Cloud Storage 数据。 验证 Pub/Sub 服务账号是否具有访问 Cloud Storage 存储桶的必要权限。确保服务账号具有以下权限：
    • storage.objects.list：列出存储桶中的对象。
    • storage.objects.get：读取存储桶中的对象。
    • storage.buckets.get：用于获取存储桶位置并验证存储桶是否存在。

    如需了解详情，请参阅创建 Cloud Storage 主题的前提条件。
    PUBLISH_PERMISSION_DENIED 由于权限问题，发布到主题时出错。 向 Pub/Sub 服务账号授予必要的发布权限。如需了解详情，请参阅向 Pub/Sub 服务账号添加 Pub/Sub 发布商角色。
    BUCKET_NOT_FOUND 找不到指定的 Cloud Storage 存储桶。 验证存储桶名称是否正确无误。
    TOO_MANY_OBJECTS Cloud Storage 存储桶中的对象过多，提取已暂停。当存储桶中的对象数量少于 5,000 万时，系统会恢复提取。 对象的上限为 5,000 万。 减少存储桶中的对象数量，或与 Google Cloud 支持团队联系以寻求帮助。

如果到目前为止没有出现任何错误，请查看保持发布商账号的良好状态中的最佳实践。

您还可以为 Cloud Storage 导入主题启用平台日志。当您在将对象提取到 Pub/Sub 导入主题时遇到问题时，这些日志可帮助您排查问题。