Nesta página, você encontra algumas dicas comuns de solução de problemas para assinaturas do Cloud Storage.
Verificar o estado de uma assinatura de Cloud Storage
Para verificar o estado de uma assinatura, siga estas etapas:
No console Google Cloud , acesse a página de assinatura do Pub/Sub.
Verifique o ícone de Estado da sua assinatura de Cloud Storage.
Se o ícone for uma marca de seleção verde, a assinatura está em dia.
Se o ícone for um ponto de exclamação vermelho, a assinatura está em estado de erro.
Clique na assinatura de Cloud Storage.
A página de detalhes da assinatura é aberta.
Verifique a mensagem de erro em Estado da assinatura.
Dependendo da mensagem de erro, acesse a seção relevante desta página para resolver o problema.
Depois que o problema for resolvido, a assinatura vai voltar a um estado normal.
Não foi possível criar ou atualizar a assinatura
Estes são alguns dos problemas comuns que você pode enfrentar se tiver dificuldades para criar ou atualizar uma assinatura de Cloud Storage.
Erro de bucket não encontrado
Se o bucket especificado no fluxo de trabalho de criação ou atualização de assinatura
não existir, o fluxo de trabalho vai retornar um erro bucket not found.
No console Google Cloud , a mensagem é semelhante a esta:
The Cloud Storage bucket specified cannot be found.
Para resolver o problema, crie o bucket ou atualize sua assinatura de armazenamento do Cloud Storage para usar um bucket que já existe.
Erro da conta de serviço
Se você não tiver configurado a conta de serviço do Pub/Sub com as permissões corretas, o fluxo de trabalho de criação ou atualização da assinatura vai retornar um erro. No console Google Cloud , a mensagem é semelhante a esta:
Cloud Pub/Sub did not have the necessary permissions configured to access
the provided bucket my-bucket (or the bucket may not exist).
Please verify that the service account
service-112233445566@gcp-sa-pubsub.iam.gserviceaccount.com
was granted the Storage Legacy Bucket Reader and Storage Object Creator
roles for the provided bucket.
Para resolver o problema, verifique se a conta de serviço tem as permissões corretas.
O estado da assinatura mostra um ponto de exclamação vermelho
Se você editar o bucket depois de criar uma assinatura, isso poderá afetar a forma como o Pub/Sub grava mensagens no bucket. Se uma mudança resultar em um problema, o campo de estado da assinatura será definido como um estado de erro.
Na página de detalhes da assinatura, verifique o estado do campo Subscription state.
O campo Subscription state fornece um erro mais específico, que pode ser um dos seguintes:
Bucket não encontrado: o bucket foi excluído. Crie o bucket novamente ou atualize a assinatura para usar um bucket existente.
Permissão negada para o bucket: a conta de serviço do Pub/Sub não tem mais permissão para gravar no bucket. Verifique se a conta de serviço tem as permissões corretas.
Enquanto uma assinatura do Pub/Sub estiver no estado de erro,
as mensagens não serão gravadas no bucket e permanecerão no
backlog da assinatura. As mensagens não são entregues a um tópico de mensagens inativas anexado, se configurado. As mensagens não confirmadas são retidas
pelo período definido em message_retention_duration (7 dias por padrão).
A assinatura processa mensagens muito lentamente
Algumas configurações de assinatura podem diminuir a velocidade do processamento de mensagens.
Por exemplo, ativar a ordenação de mensagens na assinatura do Cloud Storage pode fazer com que as mensagens sejam gravadas no Cloud Storage, mas não sejam finalizadas, atrasando as mensagens subsequentes com a mesma chave de ordenação. Para melhorar o desempenho, use um espectro mais amplo de chaves de ordenação ao publicar mensagens ou desative a ordenação de mensagens se o caso de uso não exigir isso.
Definir um tamanho máximo de arquivo muito baixo para sua assinatura de Cloud Storage também pode afetar negativamente o desempenho. Um tamanho máximo de arquivo muito pequeno pode fazer com que o Pub/Sub crie muitos objetos do Cloud Storage com apenas um pequeno número de mensagens em cada um. A sobrecarga adicional de criar e finalizar objetos diminui a velocidade do processamento de mensagens. Para melhor desempenho, considere aumentar a configuração de tamanho máximo do arquivo na sua assinatura de armazenamento do Cloud Storage ou remover a restrição de tamanho.
Limitações de cota
Outra possibilidade é que seu projeto tenha atingido a cota de capacidade de processamento de envio por push do Pub/Sub (pubsub.googleapis.com/regionalpushsubscriber).
Para verificar se você está enfrentando limitações de cota, examine a métrica de solicitações de envio por push (subscription/push_request_count)
para erros resource_exhausted.
Revise as cotas do projeto e verifique se você tem cota suficiente restante. Acesse IAM e administrador > Cotas no projeto que contém sua assinatura do Pub/Sub. Pesquise a cota de pubsub.googleapis.com/regionalpushsubscriber. Se você estiver atingindo o limite da cota, solicite um ajuste.
A assinatura cria mais arquivos do que o esperado
Para melhorar a escalonabilidade, sua assinatura de armazenamento do Cloud Storage pode ser processada por vários back-ends do Pub/Sub. Cada back-end grava em um arquivo separado do Cloud Storage. Por isso, talvez você observe que o Cloud Storage está criando mais arquivos do que o esperado, principalmente para cargas de trabalho de baixa taxa de transferência.
Isso é normal. Se quiser reduzir o número de arquivos criados pela assinatura, considere aumentar as configurações de agrupamento de arquivos para permitir arquivos maiores. Também é possível pós-processar os arquivos combinando eles em um número menor de arquivos maiores.
A seguir
- Se você ainda tiver problemas com sua assinatura do Cloud Storage, consulte Receber suporte.