Resolver problemas do App Engine

Esta página descreve o processo de solução de problemas para erros que você pode encontrar ao usar o App Engine. Para informações sobre incidentes que afetam os serviços do Google Cloud, consulte o Google Cloud Painel de integridade do serviço e Todos os incidentes informados para o App Engine.

Consulte as páginas a seguir para saber como resolver problemas relacionados ao seu app:

Estratégias para solução de problemas do App Engine

As seções a seguir explicam como aplicar estratégias gerais de solução de problemas para resolver seu erro. Se os erros persistirem mesmo depois de seguir as etapas nos guias de solução de problemas, consulte Próximas etapas.

Gerar bons registros usando o Cloud Logging

É mais fácil resolver problemas do app em execução no App Engine se você tiver bons registros de aplicativo para depuração. Verifique se o aplicativo grava registros de forma que correlacione registros de solicitação com os registros do aplicativo.

Com os registros correlacionados, é possível identificar a solicitação que precisa de mais análise, encontrar o trace da solicitação e analisar a causa raiz do problema. Para mais informações sobre como gravar registros, consulte Gravar registros de aplicativos.

Resolver latência inesperada

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

  1. Verifique se a latência está afetando todas as solicitações ao seu serviço ou apenas uma pequena porcentagem. O painel de latência do App Engine mostra a latência dos percentis 50º, 95º e 99º.

    Se você tiver alta latência em todas as três métricas, isso significa que pelo menos 50% das suas solicitações têm alta latência. Se você só notar alta latência no gráfico do 99º percentil, isso significa que 1% das suas solicitações têm alta latência.

  2. Identifique a solicitação com alta latência para entender a origem dela. Use o Cloud Trace ou o Cloud Logging para entender quanto tempo uma solicitação específica levou. Para mais informações, consulte Noções básicas sobre a latência do app.

    Para identificar solicitações com alta latência usando o Cloud Logging, aplique o filtro traceSampled=true para correlacionar registros no Cloud Logging com rastreamentos no Cloud Trace. Para mais informações, consulte Integrar com o Cloud Logging.

  3. Siga estas etapas 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 Resolver problemas de latência elevada no app.

Resolver problemas de conectividade

Por padrão, seu serviço do App Engine fica acessível na Internet pública. No entanto, é possível modificar o serviço para ter mais restrições na conectividade de rede de entrada e saída.

É possível restringir conexões de entrada com as configurações de entrada ou com regras de firewall do App Engine. Se você tiver problemas para se conectar ao serviço do App Engine em redes VPC ou recursos da Internet, verifique o seguinte:

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

Para mais informações sobre como solucionar problemas de conectividade, consulte Estratégias de conectividade do App Engine.

A seguir

Se você não encontrar uma solução para seu problema na documentação do App Engine, siga estas etapas:

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