上下文检索

最近更新时间: 2026-03-13 09:03:00

本文介绍如何在日志服务控制台查看指定日志在原始文件中的上下文信息。

操作场景

日志上下文检索是指把目标日志数据在原始文件中的前若干条日志(上文)或后若干条日志(下文)检索查询出来。通过查看指定日志的上下文信息,您可以在业务故障排查中快速查找故障信息,方便定位问题。

功能优势

  • 免除登录机器的繁琐步骤,在检索分析页面、快速查看任意机器,文件的指定日志的上下文信息。
  • 结合事件发生的时间线索,在检索分析页指定时间段快速定位可疑日志后再进行上下文查询,快速定位问题。
  • 不用担心服务器存储空间不足或日志文件轮转造成的数据丢失,在检索分析页上随时可以查看历史数据。

前提条件

  • 上下文检索分析仅支持2.3.5以上版本使用,建议 安装或升级至最新版本
  • 只有通过以下方式采集到的日志才支持上下文功能:
    • LogListener
    • GO SDK
    • JAVA SDK
    • fluent-bit-go-cls SDK
    • log4j SDK
    • log4j2 SDK
    • logback SDK
  • 已开启并配置索引,详情请参见 配置索引

场景示例

订单交易轨迹:用户登录 > 浏览商品 > 选择物品 > 加入购物车 > 下单 > 订单支付 > 支付扣款 > 生成订单
使用场景:若用户的某一单交易失败,可先通过订单号查询错误日志,再根据查到的错误日志还原上下文,找到失败原因。例如扣款失败。
在日志服务中,可以按照以下步骤排查:

  1. 在日志服务控制台的检索分析页面,结合事件发生的时间线索,输入关键字订单 ID 找到订单失败日志。
  2. 以查到的日志为基准,向上或向下滚动直到发现与之相关的上下文日志信息。

操作步骤

  1. 登录日志服务控制台。
  2. 在左侧导航栏中,单击检索分析,进入检索分析管理页面。
  3. 根据实际需求,选择地域日志集日志主题
  4. 输入检索分析语句,选择时间范围, 单击检索分析
  5. 原始日志页签下,找到目标日志的日志时间,单击,进入上下文检索分析页面。
  6. 在上下文检索分析页面,系统仅检索出目标日志的前10条日志数据(上文)和后10条日志数据(下文)。

    您可以在此页面进行如下操作:
    • 使用鼠标在当前页面上下滚动查看指定日志的上下文信息。
      • 单击展示更早,进行向上翻页浏览,每次多展示前20条日志数据。
      • 单击展示更多,进行向下翻页浏览,每次多展示后20条日志数据。
    • 高亮显示文本框中,输入关键字进行高亮显示,实现关键字黄色填充显示。
    • 过滤日志文本框中,输入需要过滤的字符串进行高亮显示。