Introdução à resolução de problemas do Cloud Run

Esta página descreve as estratégias de resolução de problemas comuns para erros do Cloud Run. O Personalized Service Health publica todos os incidentes do Cloud Run que resultam da infraestrutura Google Cloud subjacente para identificar Google Cloud interrupções do serviço que afetam os seus projetos. Também deve considerar configurar alertas sobre eventos do Personalized Service Health. Para ver informações sobre incidentes que afetam todos os Google Cloud serviços, consulte o painel de controlo Google Cloud Estado do serviço.

Consulte as secções seguintes no guia de resolução de problemas do Cloud Run para resolver problemas relacionados com o seu recurso do Cloud Run:

Estratégias de resolução de problemas do Cloud Run

As secções seguintes explicam como pode aplicar estratégias gerais de resolução de problemas para resolver o erro. Se continuar a encontrar erros mesmo depois de seguir os passos no guia de resolução de problemas, consulte a secção O que fazer a seguir.

Produza bons registos através do Cloud Logging

A resolução de problemas do recurso do Cloud Run é mais fácil se tiver bons registos para depuração. Deve escrever os registos de forma a correlacionar os registos do contentor com um registo de pedidos.

Com os registos correlacionados, pode identificar o pedido que precisa de uma análise mais detalhada, encontrar o rastreio do pedido e analisar a causa principal do problema. Para mais informações sobre como escrever registos, consulte o artigo Escreva registos do contentor.

Investigue instâncias com o Explorador de registos

Cada registo de pedidos no Cloud Run contém um campo instanceId que identifica uma instância que processa o seu pedido. Consoante o valor de simultaneidade que especificar, uma única instância pode processar vários pedidos em simultâneo.

Quando tem várias instâncias a emitir registos em simultâneo, deve filtrar as instâncias para identificar os pedidos sequenciais que levam a uma falha de sistema de uma instância.

A filtragem de uma instância permite-lhe depurar problemas de desempenho específicos relacionados com inícios a frio ou latências aumentadas. Estes problemas também podem estar associados a variáveis declaradas num âmbito global, quando o valor é reutilizado em pedidos concorrentes subsequentes. Um exemplo disto é quando cria um objeto global de conjunto de ligações único para a instância e, em seguida, o usa em vários pedidos.

Para filtrar uma instância específica no Explorador de registos, siga estes passos:

  1. Na Google Cloud consola, aceda à página Explorador de registos:

    Aceda ao Explorador de registos

  2. Selecione um Google Cloud projeto existente na parte superior da página ou crie um novo projeto.

  3. Selecione o recurso Revisão do Cloud Run para um serviço ou Tarefa do Cloud Run para uma tarefa.

  4. Expanda uma entrada do registo para filtrar por uma instância específica.

  5. Clique no valor do ID da instância e selecione Mostrar entradas correspondentes.

Enquanto investiga instâncias, pode usar as investigações do Gemini Cloud Assist para obter estatísticas adicionais sobre os seus registos. Para mais informações sobre as diferentes formas de iniciar uma investigação através do Logs Explorer, consulte o artigo Resolva problemas com as investigações do Gemini Cloud Assist na documentação do Gemini.

Resolva latências de pedidos inesperadas

Se encontrar problemas com a latência, faça o seguinte:

  1. Verifique se a latência está a afetar todos os pedidos ao seu recurso do Cloud Run ou apenas uma pequena percentagem. O Cloud Run está integrado automaticamente com o Cloud Monitoring sem necessidade de configuração.

    Para ver as métricas de latência de pedidos individuais, siga estes passos:

    1. Na Google Cloud consola, aceda à página do Cloud Run:

      Aceda ao Cloud Run

    2. Selecione o serviço ou os trabalhos na lista.

    3. Clique no separador MÉTRICAS para mostrar o painel de controlo Latências de pedidos.

    Para ver métricas de latência no Cloud Monitoring, selecione na lista Métricas: Revisão do Cloud Run > Request_latencies > Latência do pedido.

    Para ver uma lista de todas as métricas do Cloud Run disponíveis e detalhes mais detalhados, consulte as Google Cloud métricas no Cloud Monitoring.

  2. Identifique o pedido com latência elevada para compreender a origem da latência. Pode usar o Cloud Trace ou o Cloud Logging para saber quanto tempo demorou um pedido específico.

    Para identificar pedidos com latência elevada através do Cloud Logging, aplique o filtro traceSampled=true para correlacionar registos no Cloud Logging com rastreios no Cloud Trace. Para mais informações, consulte o artigo Integre com o Cloud Logging.

    Por vezes, as dependências, como os pedidos a outros serviços, podem causar problemas de latência. Para identificar esses pedidos, deve ter registos explícitos de segmentação dos pedidos. Se não gerar esses registos, pode parecer um problema de latência originário de um serviço do Cloud Run.

    Além disso, deve considerar avaliar os picos de latência no contexto do período escolhido. A importância de um pico é relativa. Um pico grande numa janela pequena pode ser insignificante numa janela maior e vice-versa. Por conseguinte, o período afeta significativamente a interpretação dos dados de latência.

  3. Experimente aumentar o número de instâncias mínimas para reduzir a latência dos pedidos recebidos e evitar inícios a frio. Também deve considerar modificar o código fonte e ajustar as definições de dimensionamento para limitar o número de ligações a um serviço de apoio.

    Para mais informações, consulte o artigo Otimizar o desempenho.

Resolva problemas com a assistência do Gemini

Pode usar o chat do Gemini Cloud Assist para analisar registos e resolver problemas. Com a assistência do Gemini, pode identificar e resolver rapidamente erros tirando partido das capacidades de análise de registos da ferramenta, o que lhe permite poupar tempo e esforço valiosos.

Para usar o Gemini Cloud Assist a partir da Google Cloud consola, faça o seguinte:

  1. Certifique-se de que o Gemini Cloud Assist está configurado para a sua Google Cloud conta de utilizador e projeto.

  2. Configure o ambiente de desenvolvimento do Cloud Run no seu Google Cloud projeto e certifique-se de que tem as autorizações de implementação adequadas.

  3. Aceda à página do Cloud Run na Google Cloud consola.

    Aceda ao Cloud Run

  4. Na barra de ferramentas da consola, selecione um Google Cloud projeto. Use um projeto associado a um ID do projeto que enviou depois de lhe ter sido concedido acesso ao Gemini Cloud Assist.

  5. Clique em spark Abrir ou fechar o chat de IA do Gemini.

    O painel do Gemini é aberto.

  6. Se necessário, clique em Aceitar se concordar com os termos.

  7. Se tiver uma pergunta sobre uma aplicação específica, forneça contexto acedendo à página que mostra o seu recurso antes de fazer a pergunta. Quando gera uma resposta, o Gemini inclui informações sobre a página da consola e o projeto atuais.

  8. Introduza um comando no painel do Gemini.

    A tabela seguinte apresenta alguns exemplos de comandos para usar o Gemini Cloud Assist com o Cloud Run.

    Comando Tipo de resposta
    "Podes explicar esta mensagem de erro que estou a ver nos registos de contentores do Cloud Run?" Sem uma mensagem de erro específica no comando, o resultado fornece orientações de resolução de problemas para mensagens de erro comuns do registo de contentores do Cloud Run.
    "Podes explicar esta mensagem de erro que estou a ver nos registos do meu serviço do Cloud Run?

    HTTP 429 The request was aborted because there was no available instance. The Cloud Run service might have reached its maximum container instance limit or the service was otherwise not able to scale to incoming requests. This might be caused by a sudden increase in traffic, a long container startup time or a long request processing time."    		 Explicação da mensagem de erro do Cloud Run e como resolver o erro.
    "Como posso corrigir a seguinte mensagem de erro quando implemento o meu serviço do Cloud Run?

    HTTP 404: Not found     		Causas comuns do erro e como resolver o erro.
    "O meu serviço do Cloud Run continua a falhar. O que poderá estar a causar isto?" Abordagem para investigar a causa e como resolver o problema.
    "Como posso saber se um erro 5XX apresentado nos registos se deveu a uma indisponibilidade do serviço de infraestrutura da Google?" Passos para determinar a causa do erro 5XX.
    "Como posso identificar a causa deste erro: com.google.apps.framework.request.BadRequestException Project PROJECT has serving status SYSTEM_DISABLED and cannot be modified?" Sugere que o Google Cloud projeto foi desativado administrativamente ao nível do sistema. Indica os passos para investigar mais aprofundadamente a causa.
    "Por que motivo consigo aceder ao meu serviço do Cloud Run a partir de um navegador se tiver definido ingress=internal?" Uma explicação do comportamento esperado quando configura a definição ingress para internal. Inclui outros cenários em que o acesso pode parecer funcionar a partir do seu navegador.

Para mais detalhes, consulte os seguintes recursos:

Use as investigações do Gemini Cloud Assist

Além do chat interativo, o Gemini Cloud Assist pode realizar análises mais automatizadas e detalhadas através das investigações do Gemini Cloud Assist. Esta funcionalidade está integrada diretamente em fluxos de trabalho, como o Explorador de registos, e é uma ferramenta de análise da causa principal dos problemas eficaz.

Quando inicia uma investigação a partir de um erro ou de um recurso específico, o Gemini Cloud Assist analisa registos, configurações e métricas. Usa estes dados para produzir observações e hipóteses classificadas sobre as prováveis causas principais e, em seguida, fornece-lhe os passos seguintes recomendados. Também pode transferir estes resultados para um Google Cloud registo de apoio técnico para fornecer um contexto valioso que pode ajudar a resolver o seu problema mais rapidamente.

Para mais informações sobre as diferentes formas de iniciar uma investigação, consulte o artigo Resolva problemas com as investigações do Gemini Cloud Assist na documentação do Gemini.

O que se segue?

Se não conseguir encontrar uma solução para o seu problema na documentação do Cloud Run, siga estes passos: