Resolver problemas de entrega de pull

Use a ferramenta gcpdiag para descobrir e corrigir possíveis problemas de entrega de assinaturas de pull.

Usar a ferramenta gcpdiag

gcpdiag é uma ferramenta de código aberto. Não é um produto Google Cloud com suporte oficial. Use a ferramenta gcpdiag para identificar e corrigir problemas do projeto Google Cloud. Para mais informações, consulte o projeto gcpdiag no GitHub.

A ferramenta gcpdiag ajuda a descobrir problemas de entrega de pull do Pub/Sub fazendo as seguintes verificações:

• Erros de cota:avalia os registros do Logs Explorer para verificar se há erros de cota em regiões e zonas.
• Qualificação de throughput:realiza verificações na integridade da latência de exibição de uma assinatura.

Para uma lista de etapas de avaliação de entrega de pull gcpdiag, consulte Etapas possíveis.

Execute o comando gcpdiag.

É possível executar o comando gcpdiag na CLI do Google Cloud ou em um contêiner do Docker.

Console doGoogle Cloud

1. Preencha e copie o comando a seguir.

gcpdiag runbook pubsub/pull-subscription-delivery \
  --project=PROJECT_ID \
  --parameter subscription_name=SUBSCRIPTION_NAME

2. Abra o Google Cloud console e ative o Cloud Shell.
Abrir Console do Cloud
3. Cole o comando copiado.
4. Execute o comando gcpdiag, que faz o download da imagem Docker gcpdiag. e realiza verificações de diagnóstico. Se aplicável, siga as instruções de saída para corrigir verificações com falha.

Docker

Você pode executar gcpdiag usando um wrapper que inicia gcpdiag em um contêiner do Docker. Docker ou Podman precisa ser instalado.

1. Copie e execute o seguinte comando na estação de trabalho local.

   curl https://gcpdiag.dev/gcpdiag.sh >gcpdiag && chmod +x gcpdiag

2. Execute o comando gcpdiag.

   ./gcpdiag runbook pubsub/pull-subscription-delivery \
     --project=PROJECT_ID \
     --parameter subscription_name=SUBSCRIPTION_NAME

Veja os parâmetros disponíveis para este runbook.

Substitua:

• PROJECT_ID: o ID do projeto a ser avaliado
• SUBSCRIPTION_NAME: o nome da assinatura a ser avaliada no projeto

Flags úteis

• --universe-domain: se aplicável, a Nuvem soberana de parceiro confiável que hospeda o recurso
• --parameter ou -p: parâmetros do runbook

Para conferir uma lista e descrição de todas as flags da ferramenta gcpdiag, consulte Instruções de uso do gcpdiag.

Ler informações relacionadas

• Problemas comuns com a assinatura de pull do Pub/Sub