Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este documento descreve como agrupar e visualizar entradas de registro em um formato "pai-filho"
usando o Explorador de registros. Normalmente, quando você grava entradas de registro no
Cloud Logging, cada entrada aparece separadamente e não está correlacionada. No entanto,
é possível agrupar ou correlacionar as entradas de registro usando o campo trace no
objeto LogEntry.
Ao correlacionar entradas de registro, você pode conferir uma entrada de registro pai com várias
entradas de registro filhas no Explorador de registros.
Configurar entradas de registro correlacionadas
Para configurar entradas de registro correlacionadas, preencha manualmente o campo trace ou
instrumente seu aplicativo para enviar rastros ao Cloud Trace usando as bibliotecas de cliente do Google. As configurações a seguir capturam automaticamente
seus dados de trace:
Para que o Explorador 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 Google Cloud e
TRACE_ID é o identificador de rastreamento.
Os campos trace nas entradas de registro são iguais.
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 conferir as entradas de registro filhas correlacionadas a uma entrada de registro pai que você está
visualizando no Explorador de Registros, abra 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:
No console Google Cloud , acesse a página Análise de registros.
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
No menu suspenso Recurso, selecione Aplicativo do GAE.
No menu suspenso Nome do registro, selecione request_log.
No painel Resultados da consulta, clique em chevron_rightExpandir para abrir uma entrada de registro.
As entradas de registro do aplicativo relacionadas à entrada de registro de solicitações são aninhadas na entrada de registro de solicitações:
Na captura de tela anterior, a entrada de registro mãe tem 10 entradas de registro filhas.
É possível expandir essas entradas de registro filhas para conferir 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
"mensagem de registro do app" nas entradas de registro filhas e principais, faça o seguinte:
No console Google Cloud , acesse a página Análise de registros.
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
Insira "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.
No painel Resultados da consulta, clique em Correlacionar por e selecione um registro
pai. Para conferir os registros de solicitações do App Engine, selecione request_log e clique em
Aplicar.
No painel Resultados da consulta, todas as entradas de registro pai que contêm a
string "app log message" ou que têm uma criança que contém a string são
listadas.
Para conferir as entradas de registro filhas aninhadas, abra a entrada de registro mãe
clicando em chevron_rightExpandir.
Na captura de tela anterior, a entrada de registro mãe tem 10 entradas de registro filhas
que contêm a string "mensagem de registro do app". É possível expandir essas entradas de registro
filhas para conferir os detalhes.
Se você selecionou um registro pai e não há entradas de registro no painel Resultados da consulta, não há entradas filhas e pai correlacionadas que correspondam à sua consulta.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-11 UTC."],[],[],null,["# Correlate log entries\n\nThis document describes how to group and view log entries in a \"parent-child\"\nformat using the Logs Explorer. Usually when you write log entries to\nCloud Logging, each log entry appears separately and uncorrelated. However,\nyou can group, or correlate your log entries by using the `trace` field in the\n[`LogEntry` object](/logging/docs/reference/v2/rest/v2/LogEntry).\n\nWhen you correlate log entries, you can view a parent log entry with multiple\nchild log entries in the Logs Explorer.\n\nSet up correlated log entries\n-----------------------------\n\nTo set up correlated log entries, you can manually populate the `trace` field,\nor you can instrument your application to submit traces to Cloud Trace by\nusing Google client libraries. The following configurations automatically\ncapture your trace data:\n\n- App Engine standard environment\n\n- Cloud Run functions and Cloud Run\n\nFor information on instrumenting your application to collect trace data, see\n[Overview to instrumenting for Cloud Trace](/trace/docs/setup).\n\nFor Logs Explorer to correlate a collection of log entries, the log entries\nmust meet the following requirements:\n\n- The `trace` field in the [`LogEntry` object](/logging/docs/reference/v2/rest/v2/LogEntry)\n is set to a string with the following format:\n\n projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e/traces/\u003cvar translate=\"no\"\u003eTRACE_ID\u003c/var\u003e\n\n where \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is your Google Cloud project project ID and\n \u003cvar translate=\"no\"\u003eTRACE_ID\u003c/var\u003e is the trace identifier.\n- The `trace` fields in the log entries are the same.\n\n- Each log entry belongs to a unique log. That is, the value of the `logName`\n fields must be different.\n\n| **Note:** Child log entries have a timestamp greater than or equal to the timestamp of the parent log entry. The parent log entry has the earliest timestamp.\n\nView correlated log entries in the Logs Explorer\n------------------------------------------------\n\nTo view the child log entries correlated with a parent log entry that you are\nviewing in the Logs Explorer, expand the log entry.\n\nFor example, to display your App Engine request log entry and application log\nentries, do the following:\n\n1. In the Google Cloud console, go to the **Logs Explorer** page:\n\n [Go to **Logs Explorer**](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. In the **Resource** drop-down menu, select **GAE Application**.\n\n3. In the **Log Name** drop-down menu, select `request_log`.\n\n4. In the **Query results** pane, to expand a log entry,\n click *chevron_right* **Expand**.\n\n Application log entries correlated to the request log entry are nested in the request log entry:\n\n In the previous screenshot, the parent log entry has 10 child log entries.\n You can expand these child log entries to view their details.\n\nSearch correlated log entries\n-----------------------------\n\nCorrelated search lets you search both parent and child log entries with a query.\nThe result of the search is a list of parent log entries that match the query in\neither the parent or child log entries. For example, to search for the string\n\"app log message\" in both the child and parent log entries, do the following:\n\n1. In the Google Cloud console, go to the **Logs Explorer** page:\n\n [Go to **Logs Explorer**](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. Enter `\"app log message`\" in the search field, and click **Run query** .\n Child log entries containing \"app log message\" are listed in the **Query\n results** pane.\n\n3. In the **Query results** pane, click **Correlate by** and select a parent\n log. To view App Engine request logs, select `request_log`, and click\n **Apply**.\n\n4. In the **Query results** pane, all parent log entries that contain the\n string `\"app log message\"` or that have a child that contain the string are\n listed.\n\n To view nested child log entries, tp expand the parent log entry,\n click *chevron_right* **Expand**.\n\n In the previous screenshot, the parent log entry has 10 child log entries\n that contain the string \"app log message\". You can expand these child log\n entries to view their details.\n\n If you selected a parent log and see no log entries in the **Query results**\n pane, then there are no correlated parent and child entries that match your\n query.\n\nWhat's next\n-----------\n\n- For information about instrumenting your application for Cloud Trace, see\n [Overview to instrumenting for Cloud Trace](/trace/docs/setup).\n\n- For information about App Engine request logs and application logs, see\n [Reading and writing application logs](/appengine/docs/legacy/standard/python)."]]
