Resolver problemas em um tópico de importação dos Hubs de Eventos do Azure

Este documento oferece algumas dicas comuns de solução de problemas para tópicos de importação do Azure Event Hubs.

Depois de configurar o tópico de importação e começar a ingerir mensagens, você pode verificar as métricas relevantes do Cloud Monitoring para saber se os dados estão sendo ingeridos. Siga as etapas abaixo:

  1. No console, acesse a página Tópicos.

    Acesse Tópicos

  2. Clique no tópico de importação do Azure Event Hubs que você quer resolver.

  3. Na página de detalhes do tópico, clique na guia Métricas.

  4. Verifique o gráfico da métrica Contagem de bytes de ingestão.

  5. Se nenhum dado estiver sendo ingerido, na página de detalhes do tópico, verifique se há um erro no campo Estado do tópico.

  6. Também é possível verificar a métrica Estado da fonte de dados de ingestão. Para fazer isso, na página de detalhes do tópico, clique na guia Métricas.

  7. Confira uma lista de erros que você pode encontrar:

    Código do erro Descrição Corrigir
    EVENT_HUBS_PERMISSION_DENIED Erro ao consumir dados dos Hubs de Eventos do Azure devido a problemas de permissão. Verifique as funções atribuídas ao app registrado do Azure e confira se as permissões necessárias foram concedidas.
    Verifique se uma conta de serviço existe e se ela está configurada corretamente, conforme descrito no procedimento Criar um registro de app com federação de identidade. Para mais informações sobre como criar uma conta de serviço, consulte Criar uma conta de serviço no Google Cloud.
    Verifique se a conta de serviço do Pub/Sub tem a permissão iam.serviceAccounts.getOpenIdToken. Para mais informações, consulte Adicionar o papel de criador do token da conta de serviço à conta de serviço do Pub/Sub.
    Verifique se você adicionou o papel de usuário da conta de serviço à conta de serviço. Para mais informações, consulte Adicionar o função do usuário da conta de serviço à conta de serviço.
    PUBLISH_PERMISSION_DENIED Erro ao publicar no tópico devido a problemas de permissão. Conceda à conta de serviço do Pub/Sub as permissões de publicação necessárias. Para mais informações, consulte Adicionar o papel de editor do Pub/Sub à conta de serviço do Pub/Sub.
    EVENT_HUB_NOT_FOUND Não foi possível encontrar o hub de eventos do Azure informado. Verifique a precisão do hub de eventos do Azure. Verifique se o hub de eventos do Azure existe e está acessível.
    SUBSCRIPTION_NOT_FOUND Não foi possível encontrar a assinatura dos Hubs de Eventos do Azure fornecida. Verifique se a assinatura está correta. Verifique se a assinatura existe.
    RESOURCE_GROUP_NOT_FOUND Não foi possível encontrar o grupo de recursos dos Hubs de Eventos do Azure informado. Verifique se o grupo de recursos está correto. Verifique se o grupo de recursos existe na assinatura especificada.

Se não houver erros até este ponto, confira as práticas recomendadas em Manter um editor em situação regular.

Também é possível ativar os registros da plataforma para um tópico de importação. Esses registros ajudam a resolver problemas ao ingerir objetos em tópicos de importação do Pub/Sub.