Correlacionar entradas de registro

Neste documento, descrevemos como agrupar e visualizar 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 sem correlação. No entanto, é possível agrupar ou correlacionar as entradas de registro usando o campo trace no objeto LogEntry.

Ao correlacionar entradas de registro, é possível ver uma entrada de registro principal com várias entradas de registro secundárias 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 rastreamentos ao Cloud Trace usando as bibliotecas de cliente do Google. As configurações a seguir capturam automaticamente seus dados de rastreamento:

  • Ambiente padrão do App Engine

  • Funções do Cloud Run e Cloud Run

Para informações sobre como instrumentar seu aplicativo para coletar dados de rastreamento, consulte Visão geral da instrumentação para o 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 projeto e TRACE_ID é o identificador de rastreamento.

  • 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 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 Logging.

  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 de aplicativos correlacionadas à entrada de registro de solicitação são aninhadas nela:

    As entradas de registro de aplicativos são aninhadas na entrada de registro de solicitações.

    Na captura de tela anterior, a entrada de registro principal tem 10 entradas de registro secundárias. É possível expandir essas entradas de registro secundárias para ver os detalhes.

Pesquisar entradas de registro correlacionadas

Com a pesquisa correlacionada, é possível pesquisar entradas de registro pai e filho com uma consulta. O resultado da pesquisa é uma lista de entradas de registro principais que correspondem à consulta nas entradas de registro principais ou secundárias. Por exemplo, para pesquisar a string "mensagem de registro do app" nas entradas de registro filho e pai, faça o seguinte:

  1. No console 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 Logging.

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

  3. No painel Resultados da consulta, clique em Correlacionar por e selecione um registro principal. Para ver 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 principais que contêm a string "app log message" ou que têm um filho que contém a string são listadas.

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

    As entradas de registro de aplicativos são aninhadas na entrada de registro de solicitações.

    Na captura de tela anterior, a entrada de registro principal tem 10 entradas de registro secundárias que contêm a string "mensagem de registro do app". É possível expandir essas entradas de registro filho para ver os detalhes.

    Se você selecionou um registro principal e não vê entradas no painel Resultados da consulta, significa que não há entradas principais e secundárias correlacionadas que correspondam à sua consulta.

A seguir