Como fazer o download de registros

O App Engine mantém um registro de mensagens que seu aplicativo emite usando o módulo logging da biblioteca padrão do Python, bem como outras mensagens impressas para o fluxo de erro padrão. Ele também grava cada solicitação no registro. Cada nível de gravidade do registro tem um tamanho de buffer fixo que controla a quantidade de informações que é possível acessar. Normalmente, são usados recursos de geração de registros em níveis de registro mais baixos, assim, a janela de tempo é menor para eventos de registro nesses níveis.

Para procurar os registros do app dos últimos 90 dias, também é possível usar a página "Registros" no Console do Cloud.

Como solicitar os registros

Para uma análise mais detalhada dos registros do seu aplicativo, use o conjunto de ferramentas AppCfg fornecido com o SDK autônomo do App Engine para fazer o download dos dados do registro.

Para fazer o download de registros em um arquivo chamado mylogs.txt, use o seguinte comando:

appcfg.sh request_logs [DIRECTORY_PATH] mylogs.txt

Para visualizar todas as opções desse comando, execute:

appcfg.sh help request_logs

Por padrão, o comando faz o download das mensagens de registro do dia, que começa à meia-noite do horário do Pacífico. O nível de gravidade padrão do registro é INFO, que também inclui registros dos níveis mais altos, mas omite as mensagens de nível DEBUG. O comando substitui o arquivo de registros local. Você pode ajustar o número de dias, o nível mínimo de registro e se o arquivo de registro local deve ser substituído ou acrescentado usando as opções da linha de comando.

É possível limitar o download apenas para as mensagens de registro que foram emitidas durante a solicitação em um determinado nome de domínio. Basta usar a opção --vhost=.... Use-o para fazer o download dos registros do aplicativo ativo usando um domínio do Google Workspace ou http://your_app_id.appspot.com, excluindo mensagens de registro emitidas por versões que você estiver testando em URLs, como http://2.latest.your_app_id.appspot.com. Ou use-o para fazer o download apenas das mensagens de registro referentes a um determinado domínio de teste.