本文档介绍如何使用 Logs Explorer 按“父级-子级”格式对日志条目进行分组和查看。通常情况下,将日志条目写入 Cloud Logging 时,每个日志条目都会单独显示且互不相关。但是,您可以使用 LogEntry 对象中的 trace
字段对日志条目进行分组或关联。
关联日志条目后,您可以在日志浏览器中查看包含多个子日志条目的父级日志条目。
设置相关日志条目
如需设置相关日志条目,您可以手动填充 trace
字段,也可以使用 Google 客户端库对应用进行插桩,以向 Cloud Trace 提交跟踪记录。以下配置会自动捕获您的轨迹数据:
App Engine 标准环境
Cloud Functions 和 Cloud Run
如需了解如何对应用进行插桩以收集跟踪记录数据,请参阅 Cloud Trace 插桩概览。
为了让 Logs Explorer 关联一组日志条目,这些日志条目必须满足以下要求:
LogEntry 对象中的
trace
字段设置为以下格式的字符串:projects/PROJECT_ID/traces/TRACE_ID
其中,PROJECT_ID 是您的 Google Cloud 项目 ID,TRACE_ID 是跟踪标识符。
日志条目中的
trace
字段相同。每个日志条目都属于唯一的日志。也就是说,
logName
字段的值必须不同。
在 Logs Explorer 中查看相关日志条目
如需查看与您在日志浏览器中查看的父级日志条目相关联的子级日志条目,请展开该日志条目。
例如,要显示 App Engine 请求日志条目和应用日志条目,请执行以下操作:
-
在 Google Cloud 控制台中,转到 Logs Explorer 页面。
如果您使用搜索栏查找此页面,请选择子标题为 Logging 的结果。
在资源下拉菜单中,选择 GAE 应用。
在日志名称下拉菜单中,选择
request_log
。在查询结果窗格中,如需展开日志条目,请点击 chevron_right 展开。
与请求日志条目关联的应用日志条目嵌套在请求日志条目中:
在前面的屏幕截图中,父级日志条目包含 10 个子级日志条目。您可以展开这些子日志条目,查看其详细信息。
搜索相关日志条目
借助相关搜索,您可以使用查询同时搜索父级日志条目和子级日志条目。搜索结果将列出与父日志条目或子日志条目中的查询匹配的父日志条目。例如,如需在子日志条目和父日志条目中搜索字符串“app log message”,请执行以下操作:
-
在 Google Cloud 控制台中,转到 Logs Explorer 页面。
如果您使用搜索栏查找此页面,请选择子标题为 Logging 的结果。
在搜索字段中输入
"app log message
,然后点击运行查询。 查询结果窗格中会列出包含“应用日志消息”的子日志条目。在查询结果窗格中,点击关联依据,然后选择一个父级日志。如需查看 App Engine 请求日志,请选择
request_log
,然后点击应用。查询结果窗格中会列出包含字符串
"app log message"
或具有包含该字符串的子项的所有父级日志条目。如需查看嵌套的子级日志条目,请展开父级日志条目,然后点击 chevron_right 展开。
在前面的屏幕截图中,父日志条目有 10 个子日志条目,这些子条目包含字符串“app log message”。您可以展开这些子日志条目查看其详细信息。
如果您选择了父级日志,但在查询结果窗格中没有看到任何日志条目,则表示没有与您的查询匹配的相关父级和子级条目。
后续步骤
如需了解如何针对 Cloud Trace 检测应用,请参阅 Cloud Trace 插桩概览。
如需了解 App Engine 请求日志和应用日志,请参阅读取和写入应用日志。