Solução de problemas de um tópico de importação do Amazon Kinesis Data Streams

Este documento fornece algumas dicas comuns de solução de problemas para tópicos de importação do Amazon Kinesis Data Streams.

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 foram 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 Amazon Kinesis Data Streams que você quer resolver.

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

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

  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
    KINESIS_PERMISSION_DENIED Erro ao consumir dados do Kinesis devido a problemas de permissão. Verifique a precisão do ARN do papel da AWS e verifique se o papel da AWS tem as permissões de leitura do Kinesis necessárias. Para mais informações, consulte Criar uma política na AWS.
    Verifique se uma conta de serviço existe e se ela está configurada corretamente, conforme descrito no procedimento Criar uma função na AWS usando uma política de confiança personalizada. 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 de 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.
    STREAM_NOT_FOUND Não foi possível encontrar o stream Kinesis especificado. Verifique se o ARN do stream está correto.
    CONSUMER_NOT_FOUND Não é possível encontrar o consumidor do Kinesis. Verifique a precisão do ARN do consumidor. Se necessário, recree o consumidor.
  8. Se não houver erros até esse ponto, confira as práticas recomendadas em Manter um editor saudável.

É possível ativar ou desativar os Registros da plataforma para tópicos de importação do Amazon Kinesis Data Streams. No entanto, os dados do fluxo do Kinesis são sempre compatíveis com os requisitos de mensagem do Pub/Sub e podem ser publicados. Portanto, nenhum registro é gravado.