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 do Google Cloud oficialmente compatível. Use a ferramenta gcpdiag para identificar e corrigir problemas no projeto do 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 Google Cloud CLI ou em um contêiner do Docker.

Console do Google Cloud

  1. Preencha e copie o comando a seguir. 
    2. gcpdiag runbook pubsub/pull-subscription-delivery \
  --project=PROJECT_ID \
  --parameter subscription_name=SUBSCRIPTION_NAME
  2. Abra o console do Google Cloud e ative o Cloud Shell.
    3. 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

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