日志查看器¶
日志数据采集到系统后,您可以在日志 > 查看器查看当前工作空间内上报的全部日志数据。
注意
若当前登录账号角色在日志 > 数据访问设置了“仅显示跟我相关的规则”,查询的日志内容会同步受其影响。
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 内容,便于进一步分析。
全部日志¶
默认查询当前工作空间内的普通日志索引,不自动包含克隆索引。若需要查询克隆数据,需在左侧索引列表中明确选择对应的克隆索引。
浏览方式¶
日志数据列表支持分页浏览和滚动加载两种方式。可在偏好设置中选择对应方式。
日志查看器顶部和数据列表底部均提供分页入口。您可以直接在顶部切换页码或跳转到指定页,无需滚动至列表底部。
使用分页浏览时,可以执行以下操作:
- 切换上一页或下一页;
- 在顶部分页输入框中输入目标页码,按 Enter 跳转;也可通过底部分页入口切换页码;
- 在底部分页入口调整每页显示数量。
顶部与底部分页状态保持同步,在任一入口切换页码后,另一处同步更新。
保持原有的连续浏览方式。滚动至当前数据列表底部时,系统会继续加载后续日志。
切换浏览方式不会改变当前工作空间、日志索引、时间范围、搜索条件和快捷筛选条件。
查询受限与手动刷新¶
当工作空间或索引的查询并发达到上限,或查询入队被拒绝时,查看器会在受影响的区域显示原因及重试提示,并保留当前查询条件和已加载的数据。此时看到的是上一次成功加载的结果。
- 日志列表受限:列表暂停自动刷新和继续加载。稍后点击提示中的手动刷新,按当前条件重新查询。
- 图表受限:受影响的图表暂停自动刷新和后续查询,可在该图表中点击手动刷新重试。
- 仅总数查询受限:总数暂停自动刷新,日志列表仍可继续加载。稍后可手动刷新总数。
日志延迟可见提示¶
开启日志延迟可见后,日志查看器会展示当前查询实际生效的延迟时长。提示中的延迟时长表示最近一段时间的日志暂不可查询,不表示日志写入失败。
- 查询单个索引时,按该索引配置的延迟时间生效;
- 查询多个索引且延迟时间不一致时,本次查询整体按最长延迟时间生效,查看器会展示相应提示;
- 查询时间范围完全落在延迟窗口内时,查看器会提示调整时间范围或稍后重试。您可以将查询时间范围调整至延迟窗口之前,或等待目标时段的日志可见后重新查询。
例如,当前时间为 10:30,本次查询生效的延迟时间为 10 分钟。如果查询 10:25 至 10:30 的日志,该时间范围完全位于延迟窗口内,需要调整查询时间范围或稍后重试。
配置方法及影响范围参见 日志延迟可见。
换行¶
在堆叠列表下,若单条日志包含较多数据信息要素,点击“换行”按钮,可使日志的 message 部分独立显示。
聚类分析¶
日志查看器提供高效聚类功能,可基于 message 字段对日志进行相似性分析,并自动展示最近 50 条日志。您还可以自定义聚类字段。在时间控件中选择时间范围后,系统会分析该时段内的 10,000 条日志,聚合相似条目。
在聚类分析列表,您可以通过以下操作对数据进行管理:
-
点击 & 对文档数量排序(默认倒序);
-
点击 ,选择显示 1 行、3 行、10 行或全部内容;
-
点击 ,导出所有聚类日志数据。
聚类详情显示列¶
点击一条聚类,打开其详情后,可在关联日志列表中点击显示列,搜索并添加字段、移除可选列或调整列顺序。例如,添加 service、host 字段,可对比同类日志来自哪些服务和主机。点击一条日志记录,可进入日志详情继续分析。
聚类列表的显示行数用于控制内容展开高度,关联日志的显示列用于选择需要展示的字段。完整操作参见聚类详情显示列。








