Solução de problemas de um tópico de importação do Cloud Storage

Este documento traz algumas dicas comuns de solução de problemas para tópicos de importação do Cloud Storage.

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 Cloud Storage 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 transferência no gráfico.

  5. Se nenhum dado estiver sendo ingerido, na página de detalhes do tópico, verifique se há um erro e um ponto de exclamação vermelho 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.

    Para mais informações sobre essas métricas, consulte Métricas para monitorar tópicos de importação.

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

    Código do erro Descrição Corrigir
    CLOUD_STORAGE_PERMISSION_DENIED Erro ao consumir dados do Cloud Storage devido a problemas de permissão. Verifique se a conta de serviço do Pub/Sub tem as permissões necessárias para acessar o bucket do Cloud Storage. Verifique se a conta de serviço tem as seguintes permissões:
    • storage.objects.list: para listar os objetos em um bucket.
    • storage.objects.get: para ler os objetos em um bucket.
    • storage.buckets.get: para conferir o local do bucket e verificar se ele existe.

    Para mais informações, consulte os pré-requisitos para criar um tópico do Cloud Storage.

    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.
    BUCKET_NOT_FOUND Não foi possível encontrar o bucket do Cloud Storage especificado. Verifique se o nome do bucket está correto.
    TOO_MANY_OBJECTS O bucket do Cloud Storage tem muitos objetos, e a transferência foi pausada. A ingestão é retomada depois que o número de objetos no bucket é menor que 50 milhões. O limite para os objetos é de 50 milhões. Reduza o número de objetos no bucket ou entre em contato com o suporte do Google Cloud para receber ajuda.

Se não houver erros até esse ponto, confira as práticas recomendadas em Manter um editor saudável.

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