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

Este documento fornece algumas dicas comuns de resoluçã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 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 Cloud Storage 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 e um ponto de exclamação vermelho 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.

    Para mais informações acerca destas métricas, consulte o artigo Métricas para monitorizar tópicos de importação.

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

    Código de erro Descrição Corrigir
    CLOUD_STORAGE_PERMISSION_DENIED Erro ao consumir dados do Cloud Storage devido a problemas de autorização. Verifique se a conta de serviço do Pub/Sub tem as autorizações necessárias para aceder ao contentor do Cloud Storage. Certifique-se de que a conta de serviço tem as seguintes autorizações:
    • storage.objects.list: para listar os objetos num contentor.
    • storage.objects.get: para ler os objetos num contentor.
    • storage.buckets.get: para obter a localização do contentor e que o contentor 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 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.
    BUCKET_NOT_FOUND Não é possível encontrar o contentor do Cloud Storage especificado. Verifique a exatidão do nome do contentor.
    TOO_MANY_OBJECTS O contentor do Cloud Storage tem demasiados objetos. O carregamento está em pausa. A carregamento é retomado quando o número de objetos no contentor for inferior a 50 milhões. O limite para os objetos é de 50 milhões. Reduza o número de objetos no contentor ou contacte o Google Cloud apoio técnico para receber assistência.

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 do Cloud Storage. Estes registos ajudam a resolver problemas quando tem problemas ao carregar objetos para tópicos de importação do Pub/Sub.