Troubleshooting an Azure Event Hubs import topic

This document provides some common troubleshooting tips for Azure Event Hubs import topics.

After you configure the import topic and start ingesting messages, you can check the relevant Cloud Monitoring metrics to see if data is ingested. Perform the following steps:

  1. In the console, go to the Topics page.

    Go to Topics

  2. Click the Azure Event Hubs import topic that you want to troubleshoot.

  3. In the topic details page, click the Metrics tab.

  4. Check the chart for the metric Ingestion byte count.

  5. If no data is being ingested, in the topic details page, check to see if there is an error for the Topic state field.

  6. You can also check the metric Ingestion data source state. To do so, in the topic details page, click the Metrics tab.

  7. Here is a list of errors that you might encounter:

    Error Code Description Fix
    EVENT_HUBS_PERMISSION_DENIED Error consuming data from Azure Event Hubs due to permission issues. Verify the roles assigned to the registered Azure app and ensure the necessary permissions are granted.
    Ensure that a service account exists and that it is correctly configured as described in the procedure Create an App registration with identity federation. For more information about how to create a service account, see Create a service account in Google Cloud.
    Verify that the Pub/Sub service account has the iam.serviceAccounts.getOpenIdToken permission. For more information, see Add the Service Account Token Creator role to the Pub/Sub service account.
    Verify that you have added the service account user role to the service account. For more information, see Add the service account user role to the service account.
    PUBLISH_PERMISSION_DENIED Error publishing to the topic due to permission issues. Grant the Pub/Sub service account the necessary publish permissions. For more information, see Add the Pub/Sub publisher role to the Pub/Sub service account.
    EVENT_HUB_NOT_FOUND The provided Azure event hub couldn't be found. Verify the Azure event hub for accuracy. Ensure that the Azure event hub exists and is accessible.
    SUBSCRIPTION_NOT_FOUND The provided Azure Event Hubs subscription couldn't be found. Verify the subscription for accuracy. Ensure that the subscription exists.
    RESOURCE_GROUP_NOT_FOUND The provided Azure Event Hubs resource group couldn't be found. Verify the resource group for accuracy. Ensure that the resource group exists within the specified subscription.

If there are no errors till this point, check the best practices in Maintain a healthy publisher.

You can also enable platform logs for a import topic. These logs help you troubleshoot issues when you have issues ingesting objects into Pub/Sub import topics.