Correlacionar entradas de registro

Neste documento, descrevemos como agrupar e exibir entradas de registro em um formato "pai-filho" usando a Análise de registros. Normalmente, quando você grava entradas de registro no Cloud Logging, cada entrada de registro aparece separadamente e não correlacionada. No entanto, é possível agrupar ou correlacionar suas entradas de registro usando o campo trace no objeto LogEntry.

Quando você correlaciona entradas de registro, é possível visualizar uma entrada de registro pai com várias entradas de registro filhas na Análise de registros.

Configurar entradas de registro correlacionadas

Para configurar entradas de registro correlacionadas, preencha manualmente o campo trace ou instrumente seu aplicativo para enviar traces para o Cloud Trace usando bibliotecas de cliente do Google. As configurações a seguir capturam automaticamente os dados de trace:

  • Ambiente padrão do App Engine

  • Cloud Functions e Cloud Run

Para informações sobre como instrumentar seu aplicativo para coletar dados de trace, consulte Visão geral da instrumentação do Cloud Trace.

Para que a Análise de registros correlacione uma coleção de entradas de registro, elas precisam atender aos seguintes requisitos:

  • O campo trace no objeto LogEntry é definido como uma string com o seguinte formato:

       projects/PROJECT_ID/traces/TRACE_ID

    em que PROJECT_ID é o ID do projeto do Google Cloud e TRACE_ID é o identificador de trace.

  • Os campos trace nas entradas de registro são os mesmos.

  • Cada entrada de registro pertence a um registro exclusivo. Ou seja, o valor dos campos logName precisa ser diferente.

Conferir entradas de registro correlacionadas na Análise de registros

Para visualizar as entradas de registro filhas correlacionadas a uma entrada de registro pai que você está visualizando na Análise de registros, expanda a entrada de registro.

Por exemplo, para exibir a entrada de registro de solicitação do App Engine e as entradas de registro do aplicativo, faça o seguinte:

  1. No console do Google Cloud, acesse a página Análise de registros:

    Acessar a Análise de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Geração de registros.

  2. No menu suspenso Recurso, selecione Aplicativo do GAE.

  3. No menu suspenso Nome do registro, selecione request_log.

  4. No painel Resultados da consulta, clique em Expandir para expandir uma entrada de registro.

    As entradas de registro do aplicativo correlacionadas à entrada de registro da solicitação estão aninhadas na entrada de registro da solicitação:

    As entradas de registro do aplicativo ficam aninhadas na entrada de registro da solicitação.

    Na captura de tela anterior, a entrada de registro pai tem 10 entradas de registro filhas. É possível expandir essas entradas de registro filhas para ver os detalhes.

Pesquisar entradas de registro correlacionadas

A pesquisa correlacionada permite que você pesquise entradas de registro pai e filho com uma consulta. O resultado da pesquisa é uma lista de entradas de registro pai que correspondem à consulta nas entradas de registro pai ou filho. Por exemplo, para pesquisar a string "mensagem de registro do app" nas entradas de registro filha e mãe, faça o seguinte:

  1. No console do Google Cloud, acesse a página Análise de registros:

    Acessar a Análise de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Geração de registros.

  2. Digite "app log message" no campo de pesquisa e clique em Executar consulta. As entradas de registro filhas contendo "mensagem de registro do app" estão listadas no painel Resultados da consulta.

  3. No painel Resultados da consulta, clique em Correlacionar por e selecione um registro pai. Para visualizar os registros de solicitações do App Engine, selecione request_log e clique em Aplicar.

  4. No painel Resultados da consulta, todas as entradas de registro pai que contêm a string "app log message" ou que têm um filho contendo a string são listadas.

    Para visualizar entradas de registro filhas aninhadas, expanda a entrada de registro pai e clique em Expandir.

    As entradas de registro do aplicativo ficam aninhadas na entrada de registro da solicitação.

    Na captura de tela anterior, a entrada de registro pai tem 10 entradas de registro filhas que contêm a string "mensagem de registro do app". Expanda essas entradas de registro filhas para visualizar os detalhes delas.

    Se você selecionou um registro pai e não vê entradas de registro no painel Resultados da consulta, não há entradas pai e filho correlacionadas que correspondam à consulta.

A seguir