关联日志条目

本文档介绍了如何对“父级-子级”中的日志条目进行分组和查看。 保存日志。通常是在您将日志条目写入 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 请求日志条目和应用日志条目,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Logs Explorer 页面。

    前往 Logs Explorer

    如果您使用搜索栏查找此页面,请选择子标题为 Logging 的结果。

  2. 资源下拉菜单中,选择 GAE 应用

  3. 日志名称下拉菜单中,选择 request_log

  4. 查询结果窗格中,如需展开日志条目,请点击 展开

    与请求日志条目相关联的应用日志条目嵌套在请求日志条目中:

    应用日志条目嵌套在请求日志条目中。

    在前面的屏幕截图中,父级日志条目包含 10 个子级日志条目。 您可以展开这些子日志条目以查看其详细信息。

搜索相关日志条目

借助相关搜索,您可以使用查询同时搜索父级日志条目和子级日志条目。 搜索结果是与以下项目中的查询匹配的父级日志条目的列表: 父日志条目或子日志条目。例如,如需在子日志条目和父日志条目中搜索字符串“app log message”,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Logs Explorer 页面。

    前往 Logs Explorer

    如果您使用搜索栏查找此页面,请选择子标题为 Logging 的结果。

  2. 输入“"app log message”,然后点击运行查询。 包含“应用日志消息”的子日志条目列于查询 结果窗格中的结果。

  3. 查询结果窗格中,点击关联依据,然后选择父级 日志。如需查看 App Engine 请求日志,请选择 request_log,然后点击应用

  4. 查询结果窗格中,系统会列出包含字符串 "app log message" 或具有包含该字符串的子日志条目的所有父日志条目。

    如需查看嵌套的子日志条目,请点击 Expand(展开)以展开父级日志条目。

    应用日志条目嵌套在请求日志条目中。

    在上一个屏幕截图中,父级日志条目包含 10 个子级日志条目 包含“app log message”字符串。您可以展开这些子日志条目以查看其详细信息。

    如果您选择了父级日志,但在查询结果中看不到任何日志条目 系统就不会显示与您的关键字匹配相关的父级条目和子级条目, 查询。

后续步骤