Como gravar e ver registros

Nesta página, descrevemos os registros disponíveis para aplicativos do App Engine e como gravar e visualizar entradas de registro.

O App Engine coleta dois tipos de registros:

  • Registro de solicitações: um registro das solicitações enviadas para seu aplicativo. O App Engine cria entradas automaticamente no registro de solicitações.

  • Registro de aplicativos: as entradas de registro gravadas em um framework ou arquivo compatível, conforme descrito nesta página.

O App Engine envia esses registros automaticamente para o agente do Cloud Logging. É possível visualizá-los no Visualizador de registros, na linha de comando ou programaticamente.

Como gravar registros de aplicativos

Para gravar entradas de registro, recomendamos integrar o módulo de geração de registros do Python ao Cloud Logging. Essa abordagem ativa todos os recursos do Cloud Logging e requer apenas algumas linhas de código específicas do Google Cloud.

Para instruções e amostras de código, consulte Como configurar o Cloud Logging para Python.

Alternativa: como gravar registros estruturados em stdout e stderr

Em vez da abordagem recomendada, é possível enviar strings de texto simples para stdout e stderr. As strings aparecerão como mensagens no Visualizador de registros, na linha de comando e na API Cloud Logging e serão associadas ao serviço do App Engine e à versão que as emitiu.

Se quiser filtrar essas strings no Visualizador de registros por nível de gravidade, será necessário formatá-las como dados estruturados. Para obter mais informações, consulte Como gerar registros estruturados.

Se quiser correlacionar entradas no registro do aplicativo com o registro de solicitação, as entradas de registro do aplicativo estruturado precisarão conter o identificador de rastreamento da solicitação. É possível extrair o identificador de rastreamento do cabeçalho de solicitação X-Cloud-Trace-Context. Na entrada de registro estruturado, grave o ID em um campo chamado logging.googleapis.com/trace. Para obter mais informações sobre o cabeçalho X-Cloud-Trace-Context, consulte Como forçar uma solicitação a ser rastreada.

Veja um exemplo de gravação de entradas de registro estruturadas com um ID de trace na documentação do Cloud Run. É possível usar a mesma técnica nos aplicativos do App Engine.

Como visualizar registros

É possível visualizar o aplicativo e solicitar registros usando o Visualizador de registros:

  1. Acesse o Visualizador de registros no Console do Cloud:

    Acessar o Visualizador de registros

  2. Selecione um projeto atual do Google Cloud na parte superior da página.

  3. Nos menus suspensos, selecione o Aplicativo do GAE como o tipo de recurso.

  4. Para ver quais entradas de registro do aplicativo estão relacionadas às entradas de registro de solicitação:

    1. Selecione o registro httpRequest.requestUrl no menu de seleção.

    2. Expanda uma entrada de registro de solicitação. Os registros do aplicativo relacionados a essa solicitação aparecem aninhados na entrada de registro da solicitação.

    Se você enviar entradas de texto simples para a saída padrão, não será possível usar o Visualizador de registros para filtrar entradas de aplicativos por gravidade, nem ver quais registros de aplicativos correspondem a solicitações específicas. É possível continuar usando outros tipos de filtragem no Visualizador de registros, como texto e carimbo de data/hora.

É possível filtrar o Visualizador de registros por serviço e versão do App Engine e outros critérios. Também é possível pesquisar nos registros por entradas específicas. Consulte os detalhes em Como visualizar os registros.

Como ver registros usando a linha de comando

Para ver os registros do App Engine na linha de comando, use o seguinte comando:

gcloud app logs tail

Para obter mais informações, consulte gcloud app logs tail.

Como ler registros de maneira programática

Se você quiser ler os registros de maneira programática, use um destes métodos:

Preços, cotas e política de retenção de registros

Para obter mais informações sobre os preços aplicáveis aos registros de solicitações e de aplicativos, consulte preços do Cloud Logging.

Para ver a política de retenção de registros e o tamanho máximo das entradas de registro, consulte Cotas e limites. É possível exportar os registros para o Cloud Storage se quiser armazená-los por mais tempo. Além disso, é possível exportá-los para o BigQuery e o Pub/Sub se quiser processamento adicional.

Como gerenciar o uso de recursos de registro

É possível controlar a quantidade de atividade de geração de registros no seu aplicativo gravando mais ou menos entradas do código do seu aplicativo. Os registros de solicitação são criados automaticamente. Portanto, para gerenciar o número de entradas de registro de solicitação associadas ao aplicativo, use o recurso de exclusão de registros do Cloud Logging.

Problemas conhecidos

Às vezes, as entradas de registro do aplicativo não são correlacionadas ao registro de solicitação. Isso acontece na primeira vez que seu aplicativo recebe uma solicitação e qualquer outra vez que o App Engine grava mensagens de status no registro do aplicativo. Para obter mais informações, consulte https://issuetracker.google.com/issues/138365527.