本文档介绍了如何对“父级-子级”中的日志条目进行分组和查看。
保存日志。通常是在您将日志条目写入
Cloud Logging,则每个日志条目都单独显示且互不相关。不过,
您可以使用trace
LogEntry 对象。
关联日志条目后,您可以在 Logs Explorer 中查看包含多个子日志条目的父日志条目。
设置关联的日志条目
如需设置关联的日志条目,您可以手动填充 trace
字段,
或者,您可以通过对应用进行插桩 (instrument),将跟踪记录提交到 Cloud Trace
使用 Google 客户端库以下配置会自动
捕获轨迹数据:
App Engine 标准环境
Cloud Run 函数和 Cloud Run
如需了解如何检测应用以收集轨迹数据,请参阅 Cloud Trace 插桩概览。
日志浏览器若要关联一组日志条目,这些日志条目必须满足以下要求:
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 Expand(展开)以展开父级日志条目。
在上一个屏幕截图中,父级日志条目包含 10 个子级日志条目 包含“app log message”字符串。您可以展开这些子日志条目以查看其详细信息。
如果您选择了父级日志,但在查询结果中看不到任何日志条目 系统就不会显示与您的关键字匹配相关的父级条目和子级条目, 查询。
后续步骤
如需了解如何针对 Cloud Trace 检测应用,请参阅 Cloud Trace 插桩概览。
如需了解 App Engine 请求日志和应用日志,请参阅 读取和写入应用日志。