Como gravar registros de aplicativos

Quando seu aplicativo em execução no App Engine recebe uma solicitação, os detalhes dela e da resposta são registrados automaticamente. É possível vê-los no Visualizador de registros do Stackdriver no console do Google Cloud Platform.

Os registros de solicitação e de aplicativo são coletados por um agente do Stackdriver Logging. Consulte a Política de cotas para ver as diretrizes de retenção de registros e o tamanho máximo das entradas. É possível exportar os registros para o Cloud Storage se quiser armazená-los por mais tempo. Você também pode exportá-los para o BigQuery e o Pub/Sub se quiser processamento adicional.

Para uma lista dos registros disponíveis para uso, consulte Registros flexíveis do App Engine.

Como gravar registros de aplicativos

Quando uma solicitação é processada no aplicativo, ele grava as próprias mensagens de geração de registros para stdout e stderr. Grave os registros do aplicativo usando stdout para saída e stderr para os erros. Esses arquivos são coletados automaticamente e são vistos no Visualizador de registros. Observe que isso não fornece níveis de registro que podem ser usados para filtragem no Visualizador de registros. No entanto, esse visualizador não fornece outra filtragem, como texto, carimbo de data/hora etc. Para limitar o tamanho, apenas as entradas mais recentes no Visualizador de registros são mantidas.

Como exibir registros do aplicativo

Veja os registros do seu aplicativo usando o Visualizador de registros.

  1. Acesse a página Stackdriver > Registros no Console do GCP:

    Acessar a página "Visualizador de registros"

  2. Selecione um projeto do GCP na parte superior da página.

  3. Nos menus suspensos, selecione Aplicativo do GAE como tipo de recurso para ver os registros do App Engine.

Use os menus suspensos e outros componentes do Visualizador de registros para filtrar ou pesquisar os registros em busca de entradas relevantes. Consulte Interfaces de filtros do Visualizador de registros para ver mais detalhes.

Como filtrar registros do aplicativo

Para filtrar as entradas de registro por pesquisa de rótulo ou de texto no Visualizador de registros, consulte Filtros básicos de registro.

Para criar filtros avançados de registro que especifiquem ainda mais um conjunto de entradas de registros, consulte Filtros avançados de registro.

Para ver os registros de determinadas instâncias, serviços ou versões, filtre pelo código desse recurso no Visualizador de registros. Para encontrar os códigos de serviço e versão, consulte o painel do App Engine.

No Visualizador de registros, as entradas correlacionadas pelo mesmo trace podem ser exibidas em um formato “pai-filho”.

Veja a seguir instruções para correlacionar entradas de registro:

  1. Decida quais registros de aplicativos você quer correlacionar com seus registros de request. Para essa correlação funcionar, você precisa escolher registros de apps com um tipo que não seja igual àquele do registro de request.

  2. No código do aplicativo, procure o cabeçalho HTTP X-Cloud-Trace-Context de solicitações recebidas. Extraia o identificador de rastreio do cabeçalho. Para ver detalhes, consulte o suporte do Stackdriver Trace.

  3. Configure o identificador de trace no campo trace de LogEntry das entradas de registro do seu app. O formato esperado é projects/[PROJECT_ID]/traces/[TRACE_ID].

Depois de correlacionar as entradas de registro, siga as instruções para visualizar entradas correlacionadas:

  1. Abra seus registros do App Engine no Visualizador de registros. Para ver detalhes, consulte Como visualizar registros de aplicativos.

  2. Para expandir um registro de request, clique no pequeno triângulo preto à esquerda da entrada. Os registros de request e de aplicativos serão exibidos em um formato aninhado.

Além disso:

  • A severity mais alta das entradas de registro “filho” não se aplica automaticamente à entrada de nível superior. Se esse comportamento for desejado, defina manualmente a severity mais alta na entrada de nível superior.
  • Defina o campo httpRequest.requestUrl para o registro de nível superior.

Como ler registros via API

Não há uma API para ler registros do App Engine criados no ambiente flexível.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente flexível do App Engine para Go