跳转至

日志查看器


日志数据采集到系统后,您可以在日志 > 查看器查看当前工作空间内上报的全部日志数据。

注意

若当前登录账号角色在日志 > 数据访问设置了“仅显示跟我相关的规则”,查询的日志内容会同步受其影响。

AI 辅助查询

在搜索栏打开 AI 辅助查询,可以用自然语言描述检索目标:选择生成查询条件,将描述转换为查看器筛选条件;选择生成 DQL,则结合当前索引、来源和时间范围生成查询草稿,适合分组统计和趋势分析等需求。

DQL 草稿会填入编辑器,确认并执行后才刷新结果。生成过程不会自动查询数据,请核对字段和统计口径。使用前需开启空间 AI 功能,详细说明请参阅查看器自然语言搜索和 AI 辅助生成 DQL。

查看模式

为满足不同场景下的查看和分析需求,查看器支持多种展示模式:

列表

堆叠列表

图表

列表

日志的每个字段分别占据一列,完整展示所有字段内容,直观查看每条日志的详细信息。

在支持片段操作的文本或展开内容中,可点击中文或中英文混合片段进行筛选、反向筛选或复制。普通文本按空白和常见标点分隔;标识符、路径、IP、时间及 URL 等内容按各自规则识别,详见选择日志片段。

堆叠列表

除时间字段(time)外,其余所有字段将被合并到同一列中,并且在单元格内以多行形式展示:

在堆叠模式下,可针对具体字段进行图示操作:

堆叠列表中的 Original Log 及原有支持片段操作的文本值,也支持选择中文和中英文混合片段进行筛选或复制。列表悬停选词、JSON 展示与日志详情正文的选中范围可能不同,操作时请以当前选中范围为准。

若字段内容为 JSON 结构,堆叠列表支持按层级展开查看。您可在偏好设置中配置 JSON 字段的默认展开方式,包括不展开或全展开,以便在多层结构中快速定位字段。

图表

基于 count、last、first、count_distinct 运算模式,在 by 条件下筛选数据:

  • 排行榜

  • 时序图

  • 饼图

  • 矩形树图

  • 分组表格图

视图切换与配置保留

在排行榜中配置分析维度、聚合方式、Top/Bottom 和返回数量后,切换至列表或堆叠列表不会清空分析配置。再次返回排行榜时,系统恢复上一次配置。

  • 当前日志索引、时间范围、查询模式、搜索条件和快捷筛选条件未变化时,复用已有查询结果;
  • 查询上下文发生变化时,保留原分析配置,并按照新上下文重新查询;
  • 在高级查询与页面分析配置组合使用时,查询语句中的 BY 条件会被忽略,以页面分析维度为准。

数据展示

快捷筛选数量与占比

在日志查看器左侧展开快捷筛选字段,可查看各字段值的数量及占比,直观比较日志数据的分布。选择字段值后,可继续筛选相应日志。

日志状态快捷筛选中的字段值、数量和占比

调整时间范围或查询条件后,如需更新快捷筛选项,请收起对应字段后重新展开。刷新方式参见快捷筛选。

JSON 字段预览

在日志查看器的堆叠列表中,将鼠标悬停在字段旁的 JSON 预览入口,可在预览浮窗中以树形结构查看字段内容。点击节点前的展开图标,可以逐层查看嵌套字段和值。浮窗顶部展示字段名称,右上角的全部复制图标可复制完整字段值。

将鼠标移至需要筛选的 JSON 字段,点击该行显示的更多按钮,可以执行以下操作:

  • 筛选字段值:将当前字段及其值加入查看器搜索条件;
  • 反向筛选字段值:将当前字段及其值作为排除条件;
  • 复制 字段名:字段值:复制当前字段及其值。

筛选条件使用 JSON 所在的日志字段和对应的内部路径。例如,partition_compaction_counts 字段中 max 的值为 2,选择筛选字段值后,会添加 partition_compaction_counts@max:2。原有搜索条件会保留。

手动输入条件的格式与嵌套路径规则,参见 JSON 搜索。

JSON 预览浮窗中的字段筛选、反向筛选和复制操作

需要阅读较大的 JSON 时,点击查看完整 JSON,打开完整内容弹窗。弹窗支持:

  • 完整展开 JSON 结构,查看各层级内容;
  • 在弹窗内部滚动,浏览较长的 JSON;
  • 复制完整 JSON 内容,便于进一步分析。

完整 JSON 弹窗中的格式化内容、内部滚动区域及全文复制入口

全部日志

默认查询当前工作空间内的普通日志索引,不自动包含克隆索引。若需要查询克隆数据,需在左侧索引列表中明确选择对应的克隆索引。

浏览方式

日志数据列表支持分页浏览和滚动加载两种方式。可在偏好设置中选择对应方式。

日志查看器顶部和数据列表底部均提供分页入口。您可以直接在顶部切换页码或跳转到指定页,无需滚动至列表底部。

使用分页浏览时,可以执行以下操作:

  • 切换上一页或下一页;
  • 在顶部分页输入框中输入目标页码,按 Enter 跳转;也可通过底部分页入口切换页码;
  • 在底部分页入口调整每页显示数量。

顶部与底部分页状态保持同步,在任一入口切换页码后,另一处同步更新。

保持原有的连续浏览方式。滚动至当前数据列表底部时,系统会继续加载后续日志。

切换浏览方式不会改变当前工作空间、日志索引、时间范围、搜索条件和快捷筛选条件。

查询受限与手动刷新

当工作空间或索引的查询并发达到上限,或查询入队被拒绝时,查看器会在受影响的区域显示原因及重试提示,并保留当前查询条件和已加载的数据。此时看到的是上一次成功加载的结果。

  • 日志列表受限:列表暂停自动刷新和继续加载。稍后点击提示中的手动刷新,按当前条件重新查询。
  • 图表受限:受影响的图表暂停自动刷新和后续查询,可在该图表中点击手动刷新重试。
  • 仅总数查询受限:总数暂停自动刷新,日志列表仍可继续加载。稍后可手动刷新总数。

日志延迟可见提示

开启日志延迟可见后,日志查看器会展示当前查询实际生效的延迟时长。提示中的延迟时长表示最近一段时间的日志暂不可查询,不表示日志写入失败。

  • 查询单个索引时,按该索引配置的延迟时间生效;
  • 查询多个索引且延迟时间不一致时,本次查询整体按最长延迟时间生效,查看器会展示相应提示;
  • 查询时间范围完全落在延迟窗口内时,查看器会提示调整时间范围或稍后重试。您可以将查询时间范围调整至延迟窗口之前,或等待目标时段的日志可见后重新查询。

例如,当前时间为 10:30,本次查询生效的延迟时间为 10 分钟。如果查询 10:25 至 10:30 的日志,该时间范围完全位于延迟窗口内,需要调整查询时间范围或稍后重试。

配置方法及影响范围参见 日志延迟可见。

换行

在堆叠列表下,若单条日志包含较多数据信息要素,点击“换行”按钮,可使日志的 message 部分独立显示。

聚类分析

日志查看器提供高效聚类功能,可基于 message 字段对日志进行相似性分析,并自动展示最近 50 条日志。您还可以自定义聚类字段。在时间控件中选择时间范围后,系统会分析该时段内的 10,000 条日志,聚合相似条目。

在聚类分析列表,您可以通过以下操作对数据进行管理:

  • 点击 & 对文档数量排序(默认倒序);

  • 点击 ,选择显示 1 行、3 行、10 行或全部内容;

  • 点击 ,导出所有聚类日志数据。

聚类详情显示列

点击一条聚类,打开其详情后,可在关联日志列表中点击显示列,搜索并添加字段、移除可选列或调整列顺序。例如,添加 service、host 字段,可对比同类日志来自哪些服务和主机。点击一条日志记录,可进入日志详情继续分析。

聚类列表的显示行数用于控制内容展开高度,关联日志的显示列用于选择需要展示的字段。完整操作参见聚类详情显示列。

文档评价

文档内容是否对您有帮助?