排查 Amazon Kinesis Data Streams 导入问题

本文档提供了一些常见的 Amazon Kinesis Data Streams 导入主题问题排查提示。

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

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

   打开“主题”。

2. 点击您要进行问题排查的 Amazon Kinesis Data Streams 导入主题。

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

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

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

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

7. 下面列出了您可能会遇到的错误：

   错误代码	说明	修复
   KINESIS_PERMISSION_DENIED	由于权限问题，使用 Kinesis 数据时出错。	验证 AWS 角色 ARN 是否准确，并检查 AWS 角色是否具有所需的 Kinesis 读取权限。如需了解详情，请参阅在 AWS 中创建政策。
   		确保服务账号存在且已正确配置，如使用自定义信任政策在 AWS 中创建角色中所述的步骤所示。如需详细了解如何创建服务账号，请参阅在 Google Cloud中创建服务账号。
   		验证 Pub/Sub 服务账号是否具有 iam.serviceAccounts.getOpenIdToken 权限。 如需了解详情，请参阅向 Pub/Sub 服务账号添加 Service Account Token Creator 角色。
   		请验证您是否已向服务账号添加了服务账号用户角色。如需了解详情，请参阅向服务账号添加服务账号用户角色。
   PUBLISH_PERMISSION_DENIED	由于权限问题，发布到主题时出错。	向 Pub/Sub 服务账号授予必要的发布权限。如需了解详情，请参阅向 Pub/Sub 服务账号添加 Pub/Sub 发布商角色。
   STREAM_NOT_FOUND	找不到指定的 Kinesis 数据流。	请验证数据流 ARN 是否准确无误。
   CONSUMER_NOT_FOUND	找不到 Kinesis 使用方。	验证使用方 ARN 是否准确。如有必要，请重新创建使用方。

如果到目前为止没有出现错误，请参阅维护健康的发布商中的最佳实践。

您可以为 Amazon Kinesis Data Streams 导入主题启用或停用平台日志。不过，Kinesis 流数据始终与 Pub/Sub 的消息要求兼容，并且可以发布。因此，系统不会写入任何日志。