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 não correlacionada. 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 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 ao Cloud Trace por meio de bibliotecas de cliente do Google. As configurações abaixo capturam automaticamente os dados de rastreamento:

  • Ambiente padrão do App Engine

  • Cloud Functions e Cloud Run

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

Para que a Análise de registros correlacione um conjunto de entradas de registro, as entradas 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

Expanda a entrada de registro para visualizar as entradas de registro filho correlacionadas a uma entrada pai que você está vendo na Análise de registros.

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 painel de navegação do console do Google Cloud, selecione Logging e clique em Análise de registros:

    Acessar a Análise de registros

  2. No menu suspenso Recurso, selecione Aplicação do GAE.

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

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

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

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

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

Pesquisar entradas de registro correlacionadas

A pesquisa correlacionada permite pesquisar 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 "app log message" nas entradas de registro pai e filho, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Logging e clique em Análise de registros:

    Acessar a Análise de registros

  2. Insira "app log message" no campo de pesquisa e clique em Executar consulta. As entradas de registro filho 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 pai. Para acessar 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 que contém a string são listadas.

    Para visualizar entradas de registro filhos aninhadas, clique em Expandir para expandir a entrada de registro pai.

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

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

    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 correspondem à consulta.

A seguir