查询 Trace 日志

功能概述

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

主要优势

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

适用场景

  • 调试跨服务事务失败。
  • 分析复杂工作流中的性能瓶颈。
  • 审计请求处理流程以满足合规要求。

核心功能

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

前提条件

TIP

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

默认行为

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

日志查询操作

访问 Trace 日志

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

过滤日志

按 Pod 名称

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

按时间范围

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

按查询条件

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

包含 Trace ID

选中 包含 Trace ID 复选框。

高级操作

导出日志

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

自定义显示字段

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

查看日志上下文

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