查询追踪日志

目录

功能概述

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

主要优势

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

适用场景

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

核心功能

  • 基于 TraceID 查询:通过 TraceID 获取与特定追踪相关的所有日志。
  • 以 Pod 为中心的过滤:查看参与追踪的特定 Pod 的日志。
  • 排除 Sidecar 日志:过滤掉基础设施日志,聚焦业务相关数据。
  • 日志导出:以自定义格式导出过滤后的日志数据。
  • 上下文日志查看:查看目标日志条目前后相关日志,进行深入分析。

前提条件

TIP

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

默认行为

  • 显示整个追踪时间范围内的日志。
  • 对于持续时间少于 1 分钟的追踪,查询追踪开始时间后 1 分钟内的日志。

日志查询操作

访问追踪日志

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

过滤日志

按 Pod 名称

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

按时间范围

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

按查询条件

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

包含 Trace ID

勾选 包含 Trace ID 复选框。

隐藏 Sidecar 日志

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

高级操作

导出日志

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

自定义显示字段

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

查看日志上下文

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