排查 Azure Event Hubs 导入主题的问题

本文档提供了一些有关 Azure Event Hubs 导入主题的常见问题排查提示。

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

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

   打开“主题”。

2. 点击要排查问题的 Azure Event Hubs 导入主题。

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

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

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

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

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

   错误代码	说明	修复
   EVENT_HUBS_PERMISSION_DENIED	由于权限问题，无法从 Azure 事件中心使用数据。	验证分配给已注册 Azure 应用的角色 ，并确保已授予必要的权限。
   		确保服务账号存在，并且已按照创建具有身份联合的应用注册中的步骤正确配置。如需详细了解如何创建服务账号，请参阅在 Google Cloud中创建服务账号。
   		验证 Pub/Sub 服务账号是否具有 iam.serviceAccounts.getOpenIdToken 权限。 如需了解详情，请参阅为 Pub/Sub 服务账号添加 Service Account Token Creator 角色。
   		验证您是否已向服务账号添加服务账号用户角色。如需了解详情，请参阅向服务账号添加服务账号用户角色。
   PUBLISH_PERMISSION_DENIED	由于权限问题，发布到主题时出错。	向 Pub/Sub 服务账号授予必要的发布权限。如需了解详情，请参阅向 Pub/Sub 服务账号添加 Pub/Sub 发布商角色。
   EVENT_HUB_NOT_FOUND	找不到所提供的 Azure 事件中心。	验证 Azure 事件中心是否准确无误。确保 Azure 事件中心存在且可访问。
   SUBSCRIPTION_NOT_FOUND	找不到提供的 Azure 事件中心订阅。	验证订阅是否准确无误。确保订阅存在。
   RESOURCE_GROUP_NOT_FOUND	找不到提供的 Azure 事件中心资源组。	验证资源组是否正确。确保资源组存在于指定订阅中。

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

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