原始数据页面用于查看应用实际接入的日志,适合验证数据是否上报、检查字段内容,以及通过日志检索定位一次请求。直写和引用两种 SessionStore 均从自身的“原始数据”入口查询,无需手动切换到其他存储目标。
前提条件
已完成数据接入,并具有目标数据的查询权限。
查询时间范围内有数据。
使用字段检索或 SQL 分析时,相关索引已配置并可用。引用方式的索引由源 LogStore 管理。
操作步骤
打开目标 SessionStore,选择“原始数据”。
设置时间范围。首次进入默认最近 15 分钟;排查历史问题时选择对应的绝对时间范围。
在查询框中输入查询语句,单击“查询 / 分析”。
在结果中查看字段与日志内容,可按需要使用直方图、快速分析和列设置。
如果没有结果,先使用
*重试,再逐步增加筛选条件。
说明:Raw、轨迹和会话不一定使用相同字段名。例如某些 OpenTelemetry 原始日志使用traceId,加工后的轨迹使用trace_id。请先查看原始记录,不要机械照搬其他页面的字段名。
常用查询示例
示例值仅用于说明,请替换为实际数据。
查看时间范围内的全部日志
*按实际原始字段查询一次 Trace
以下示例仅适用于原始日志包含且已索引 traceId 的情况。
traceId:"0123456789abcdef0123456789abcdef"如果您的原始日志使用 trace_id 或其他名称,请改为实际字段。
组合多个字段条件
以下示例要求 serviceName 和 statusCode 可检索。
serviceName:"demo-toolservice" AND statusCode:"2"不同采集方案对状态码的定义可能不同,不要在未核实数据格式前将数字 2 统一解释为某种业务状态。
统计当前范围内的日志数
在支持 SQL 的查询模式中,可使用:
* | SELECT count(*) AS log_count这里统计的是匹配的原始日志记录数,不是会话数、独立请求数或轨迹数。其他字段参与分析时,需要相应分析索引;具体查询能力以当前资源和服务支持为准。
使用查询辅助能力
能力 | 用途 |
直方图 | 观察日志在时间范围内的分布,辅助定位有数据或数据异常集中的时段。 |
快速分析 | 查看可用字段的分布,辅助选择进一步的检索条件。 |
列设置 | 调整日志列表需要显示的字段,减少无关信息。 |
查询分析属性 | 查看当前索引;直写原始数据可按权限创建或修改,引用源索引为只读。 |
查询返回错误时,请区分“请求失败”和“没有匹配数据”。字段不存在、索引不支持或权限不足,不应解释为该业务行为没有发生。
使用限制
SessionStore 的原始数据页面不等同于普通 LogStore 的全部控制台功能。当前不提供日志下载、上下文查询、实时尾读、自动刷新、保存查询、告警创建、通用分享等入口,也不要按普通 LogStore 的菜单路径寻找这些操作。
需要最新数据时,请主动重新查询。正在查看历史问题时,建议使用绝对时间范围,避免相对时间推进后遗漏原先的数据。