查询 Trace 日志

功能概述

Trace 日志使用户能够通过唯一的 TraceID 查询和分析与特定分布式追踪相关的日志。该功能帮助开发人员和运维人员快速定位问题,理解请求流程,并将业务日志与追踪上下文关联起来。

主要优势:

  • 根因分析:识别分布式系统中跨微服务的错误和延迟问题。
  • 上下文关联:将业务日志与 trace span 关联,实现端到端可视化。
  • 高效过滤:通过 Pod 或 TraceID 过滤日志,聚焦相关数据。

核心功能

  • 基于 TraceID 查询:使用 TraceID 检索与特定追踪相关的所有日志。
  • 以 Pod 为中心的过滤:查看参与该追踪的特定 Pod 的日志。
  • 排除 Sidecar 日志:过滤掉基础设施日志,专注于业务相关数据。
  • 日志导出:以可定制格式导出过滤后的日志数据。
  • 上下文日志查看:查看目标日志条目前后相关日志,进行深入分析。

前提条件

TIP

在通过 TraceID 查询 Trace 日志之前,必须先对服务进行埋点,使业务日志中包含 TraceID。请参考业务日志与 TraceID 关联指南进行配置。

默认行为:

  • 显示整个追踪时长内的日志。
  • 对于时长不足 1 分钟的追踪,查询追踪开始时间后 1 分钟内的日志。

日志查询操作

访问 Trace 日志

  1. 查询 Trace 后,点击具体 Trace 查看详情。
  2. 点击 Trace 可视化面板中的 查看日志 标签。

过滤日志

按 Pod 名称

在 Pod 名称 选择器中,从参与服务列表中选择目标 Pod。

按时间范围

在 时间范围 选择器中,选择目标时间段。

按查询条件

在 查询条件 文本框中输入关键词,基于特定内容过滤日志。

包含 Trace ID

勾选 包含 Trace ID 复选框。

隐藏 Sidecar 日志

勾选 隐藏 Sidecar 日志,排除基础设施相关日志条目。

高级操作

导出日志

  1. 点击 导出。
  2. 通过列复选框选择要包含的字段。
  3. 选择导出格式(JSON/CSV)。

自定义显示字段

点击 设置。 切换日志字段在显示面板中的可见性。

查看日志上下文

  1. 点击任意日志条目旁的 洞察。
  2. 查看目标时间戳前后各 5 条日志。
  3. 使用鼠标上下滚动加载更多日志。