Esta página oferece algumas dicas comuns de solução de problemas para assinaturas do Cloud Storage.
Verificar o estado de uma assinatura do Cloud Storage
Para verificar o estado de uma assinatura, siga estas etapas:
No console do Google Cloud, acesse o Pub/Sub página de assinatura.
Verifique o ícone Estado da sua assinatura do Cloud Storage.
Se o ícone for uma marca de seleção verde, a assinatura está íntegra.
Se o ícone for um ponto de exclamação vermelho, significa que a assinatura está em estado de erro.
Clique na assinatura do Cloud Storage.
A página de detalhes da assinatura é aberta.
Verifique a mensagem de erro no Estado da assinatura.
Dependendo da mensagem de erro, vá para a seção relevante nesta para solucionar o problema.
Depois que o problema for resolvido, a assinatura vai retornar a um estado saudável.
Não foi possível criar ou atualizar a assinatura
Estes são alguns dos problemas comuns que você pode enfrentar criar ou atualizar uma assinatura do Cloud Storage.
Erro de bucket não encontrado
Se o bucket que você especificar no fluxo de trabalho de criação ou atualização de assinaturas
não existir, o fluxo de trabalho retornará um erro bucket not found
.
No console do 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 do Cloud Storage para usar um bucket atual.
Erro na conta de serviço
Se você não tiver configurado a conta de serviço do Pub/Sub com o as permissões corretas, o fluxo de trabalho de criação ou atualização de assinaturas retornará um erro. No console do 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 as permissões corretas.
O estado da assinatura mostra uma exclamação vermelha
Se você editar o bucket depois de criar uma assinatura, isso poderá afetar 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 do bucket negada: a conta de serviço do Pub/Sub não tem 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 em estado de erro,
as mensagens não são gravadas no bucket e permanecem
do backlog de assinaturas. 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
para o período definido em message_retention_duration
(sete dias por padrão).
A assinatura processa as mensagens muito lentamente
Algumas configurações de assinatura podem desacelerar o processamento de mensagens.
Por exemplo, ativar a ordenação de mensagens no Cloud Storage pode fazer com que as mensagens sejam gravadas no Cloud Storage, finalizada para atrasar mensagens subsequentes com a mesma chave de ordem. Para melhorar o desempenho, use um espectro mais amplo de chaves de ordem ao publicar mensagens ou ao desativar a ordem das mensagens se caso de uso não exija isso.
Definir um tamanho de arquivo máximo muito baixo para sua assinatura do Cloud Storage também podem afetar negativamente o desempenho. O tamanho de arquivo máximo é muito baixo pode fazer com que o Pub/Sub crie muitos objetos do Cloud Storage com apenas um um pequeno número de mensagens em cada objeto. A sobrecarga adicional de criação e finalização de objetos diminui a velocidade do processamento de mensagens. Para melhorar o desempenho, aumente a configuração de tamanho máximo de arquivo para sua assinatura do Cloud Storage ou remover a restrição de tamanho de arquivo.
Limitações de cota
Outra possibilidade é que seu projeto tenha atingido o push do Pub/Sub.
cota de capacidade de processamento (pubsub.googleapis.com/regionalpushsubscriber
).
Para verificar se você está encontrando limitações de cota, examine as solicitações de push
métrica (subscription/push_request_count
)
para quaisquer erros resource_exhausted
.
Revise as cotas do projeto e verifique se você tem cota suficiente. Acesse IAM e Administrador > Cotas dentro do projeto que contém
sua assinatura do Pub/Sub. Procure o
pubsub.googleapis.com/regionalpushsubscriber
. Se você estiver alcançando o
limite de cota, solicite uma cota maior.
A assinatura cria mais arquivos do que o esperado
Para melhorar a escalonabilidade, sua assinatura do Cloud Storage pode ser processado por vários back-ends do Pub/Sub. Cada back-end grava em um arquivo separado do Cloud Storage. Portanto, é possível observar que o Cloud Storage cria mais arquivos do que o esperado, principalmente para cargas de trabalho de baixa taxa de transferência.
Esse é um comportamento normal. Se você quiser reduzir o número de arquivos criados a assinatura, considere aumentar as configurações de agrupamento de arquivos no para permitir arquivos maiores. Também é possível processar os arquivos depois de compor em um número menor de arquivos maiores.
A seguir
- Se você ainda tiver problemas com o Cloud Storage assinatura, consulte Como receber suporte.