Resolução de problemas de um tópico de importação do Amazon Managed Streaming para Apache Kafka

Este documento fornece algumas dicas de resolução de problemas comuns para tópicos de importação do Amazon Managed Streaming for Apache Kafka (Amazon MSK).

Depois de configurar o tópico de importação e começar a carregar mensagens, pode verificar as métricas relevantes do Cloud Monitoring para ver se os dados estão a ser carregados. Siga estes passos:

  1. Na consola, aceda à página Tópicos.

    Aceda a Tópicos

  2. Clique no tópico de importação do Amazon MSK para o qual quer resolver problemas.

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

  4. Verifique o gráfico da métrica Ingestion byte count.

  5. Se não estiverem a ser carregados dados, na página de detalhes do tópico, verifique se existe um erro no campo Estado do tópico.

  6. Também pode verificar a métrica Estado da origem de dados de carregamento. Para tal, na página de detalhes do tópico, clique no separador Métricas.

  7. Segue-se uma lista de erros que pode encontrar:

    Código de erro Descrição Corrigir
    MSK_PERMISSION_DENIED Erro ao consumir dados do Amazon MSK devido a problemas de autorização. Verifique a precisão do ARN da função da AWS e certifique-se de que a função da AWS tem as autorizações de leitura necessárias. Para mais informações, consulte Crie uma política na AWS.
    Certifique-se de que existe uma conta de serviço e que está corretamente configurada, conforme descrito no procedimento Crie uma função na AWS com uma política de fidedignidade personalizada. Para mais informações sobre como criar uma conta de serviço, consulte o artigo Crie uma conta de serviço no Google Cloud.
    Verifique se a conta de serviço do Pub/Sub tem a autorização iam.serviceAccounts.getOpenIdToken. Para mais informações, consulte o artigo Adicione a função de criador de tokens de conta de serviço à conta de serviço do Pub/Sub.
    Confirme que adicionou a função de utilizador da conta de serviço à conta de serviço. Para mais informações, consulte o artigo Adicione a função de utilizador da conta de serviço à conta de serviço.
    PUBLISH_PERMISSION_DENIED Erro ao publicar no tópico Pub/Sub devido a problemas de autorização. Conceda à conta de serviço do Pub/Sub as autorizações de publicação necessárias. Para mais informações, consulte o artigo Adicione a função de publicador do Pub/Sub à conta de serviço do Pub/Sub.
    CLUSTER_NOT_FOUND Não foi possível encontrar o cluster fornecido. Verifique a precisão do ARN do cluster. Certifique-se de que o cluster existe e está acessível.
    Cluster is not public Não é possível aceder ao cluster fornecido Os clusters não públicos atrás de VPCs não são suportados. Tem de usar um cluster público.
    TOPIC_NOT_FOUND Não foi possível encontrar o tópico do Kafka fornecido. Verifique a precisão do nome do tópico. Certifique-se de que o tópico existe no cluster especificado.

Se não existirem erros até este ponto, consulte as práticas recomendadas em Mantenha um publicador saudável.

Também pode ativar os registos da plataforma para um tópico de importação. Estes registos ajudam a resolver problemas quando tem problemas ao carregar objetos para tópicos de importação do Pub/Sub.

Apache Kafka® é uma marca comercial registada da The Apache Software Foundation ou das respetivas afiliadas nos Estados Unidos e/ou noutros países.