排查 Amazon Managed Streaming for Apache Kafka 导入主题的问题

本文档提供了一些针对 Amazon Managed Streaming for Apache Kafka (Amazon MSK) 导入主题的常见问题排查提示。

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

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

    打开“主题”

  2. 点击您要排查的 Amazon MSK 导入主题。

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

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

  5. 如果没有提取任何数据，请在主题详情页面中检查主题状态 字段是否存在错误。

  6. 您还可以查看提取数据源状态 指标。 为此，请在主题详情页面中点击指标 标签页。

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

    错误代码 说明 修复
    MSK_PERMISSION_DENIED 由于 权限问题，无法使用 Amazon MSK 数据。 验证 AWS 角色 ARN 是否准确无误，并检查 AWS 角色是否具有所需的读取权限。如需了解详情，请参阅在 AWS 中创建政策。
    确保服务账号存在，并且已 按照使用自定义信任政策在 AWS 中创建角色过程中的说明正确配置该服务账号。如需详细了解如何创建服务帐号，请参阅在 中创建服务帐号 Google Cloud.
    验证 Pub/Sub 服务帐号是否具有 iam.serviceAccounts.getOpenIdToken 权限。 如需了解详情，请参阅向 Pub/Sub 服务账号添加 Service Account Token Creator 角色。
    验证您是否已向服务帐号添加服务帐号用户 角色。如需了解详情，请参阅向服务账号添加服务帐号用户角色。
    PUBLISH_PERMISSION_DENIED 由于权限 问题，无法发布到 Pub/Sub 主题。 向 Pub/Sub 服务帐号授予必要的发布 权限。如需了解详情，请参阅添加 Pub/Sub 发布者角色到 Pub/Sub 服务账号。
    CLUSTER_NOT_FOUND 找不到提供的集群。 验证集群 ARN 是否准确无误。确保集群存在且可访问。
    Cluster is not public 无法访问提供的集群 不支持 VPC 后面的非公开集群。您必须使用公开集群。
    TOPIC_NOT_FOUND 找不到提供的 Kafka 主题。 验证主题名称是否准确无误。确保主题存在于指定的集群中。

如果到目前为止没有错误，请查看 保持发布者运行状况中的最佳实践。

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

Apache Kafka® 是 Apache Software Foundation 或其关联公司在美国和/或其他国家/地区的注册商标。