Resolva problemas de erros do App Engine

Esta página descreve o processo de resolução de problemas de erros que pode encontrar enquanto usa o App Engine. Para informações sobre incidentes que afetam os Google Cloud serviços, consulte o Google Cloud painel de controlo Service Health e todos os incidentes comunicados para o App Engine.

Consulte as páginas seguintes para obter orientações sobre como resolver problemas relacionados com a sua app:

Estratégias de resolução de problemas do App Engine

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 nos guias 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 da sua app em execução no App Engine é mais fácil se tiver bons registos de aplicações para depuração. Certifique-se de que a sua aplicação escreve registos de forma a correlacionar os registos de pedidos com os registos da aplicação.

Com os registos correlacionados, pode identificar o pedido que precisa de análise adicional, 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 de aplicações.

Resolva a latência inesperada

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 serviço ou apenas uma pequena percentagem. O painel de controlo de latência do App Engine mostra a latência do 50.º, 95.º e 99.º percentil.

    Se tiver uma latência elevada nas três métricas, tem uma latência elevada para, pelo menos, 50% dos seus pedidos. Se apenas vir uma latência elevada no gráfico do percentil 99, tem uma latência elevada em 1% dos seus pedidos.

  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 compreender quanto tempo demorou um pedido específico. Para mais informações, consulte o artigo Compreender a latência da app.

    Para identificar pedidos com elevada latência 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.

  3. Experimente os seguintes passos para corrigir problemas de latência e melhorar o desempenho do serviço:

    • Considere usar o Profiler.

    • Modifique o código-fonte.

Para mais informações sobre como resolver problemas de latência elevada, consulte o artigo Resolva problemas de latência elevada na sua app.

Resolva problemas de conetividade

Por predefinição, o seu serviço do App Engine está acessível na Internet pública. No entanto, pode modificar o serviço para ter mais restrições na conetividade de rede de entrada e saída.

Pode restringir as ligações de entrada com as definições de entrada ou através das regras da firewall do App Engine. Se tiver problemas ao estabelecer ligação ao seu serviço do App Engine a partir de redes VPC ou recursos da Internet, verifique o seguinte:

Para resolver outros problemas de conetividade, faça o seguinte:

  • Defina uma instância no modo de depuração e use SSH para aceder à instância enquanto continua a receber tráfego em direto. Depois de se ligar à instância, pode depurar a instância através de ferramentas de linha de comandos comuns.

  • Verifique as regras de firewall na sua rede da VPC para se certificar de que o tráfego não está bloqueado.

  • Verifique se desativou o IP externo.

Para mais informações sobre como resolver problemas de conetividade, consulte o artigo Estratégias de conetividade do App Engine.

O que se segue?

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

Para mais informações, consulte a comunidade do App Engine.