跳到主要内容

日志字段与查询实践

信息

当需要让日志能够支撑持续排查时,可在配置采集前规划字段语义,并在查询中一致地使用这些字段,从而通过可观察的日志记录缩小问题范围。

先规划排查所需的字段​

先确定能够标识日志来源及其与其他记录关联关系的字段,使同类排查不只依赖日志原文,也能够重复执行。

  • 定义或使用字段前,先查阅日志模型参考,区分预置属性、解析属性、实体属性和标签。
  • 如果希望在日志查询的过滤区域使用某字段,查看模型中的是否作为快捷过滤标识;并非所有解析属性都会展示在该区域。
  • 准备分析时关注字段类型。解析属性在创建时会自动识别为文本或数值类型;定性和定量字段在查询统计中可使用的聚合方式不同。

在不改变源日志的前提下对齐同义字段​

当不同团队或历史日志源对同一业务概念使用不同字段名称时,可通过标准属性建立关联,同时保留应用日志的原始结构。

  1. 进入日志分析 → 日志配置 → 标准属性。
  2. 选择已有解析属性,或创建标准属性并填写属性路径、数据类型、描述和需要映射的源属性名称。
  3. 需要映射多个源属性名称时,使用英文逗号分隔。

这种映射方式尤其适用于无法采用统一命名规范的跨团队或历史日志源。可参阅标准属性了解默认属性和完整配置方法。

暴露能够支撑排查任务的字段​

为运维人员需要重复使用的字段配置快捷过滤,并通过展示名称、分组和描述帮助其识别字段。

  1. 在日志分析 → 日志查询中,从已注册的解析属性中选择字段加入快捷过滤。
  2. 按需配置展示名称、分组和描述。修改这些设置只影响过滤面板中的展示,不会修改日志解析字段。
  3. 在查询页面使用快捷过滤提供的列展示、删除列和关联标准属性等操作,调整字段在分析中的使用方式。

完整配置步骤请参阅日志查询。

先验证记录,再用证据收窄查询范围​

先用列表确认匹配的日志记录,再根据需要切换到图表、表格、排行或模式识别,对日志数量或字段取值进行比较。

  1. 选择精确的时间范围,并通过关键字、属性或标签添加查询条件。
  2. 在日志列表中确认匹配记录;需要查看上下文、源内容或关联实体时,打开具体记录。
  3. 需要进行多维统计时使用图表分析;统计对象必须是已配置为快捷过滤的字段。
  4. 需要对结构相似的日志分组并查看代表性记录时,使用模式识别。

精确的时间范围有助于让大数据量查询保持聚焦。日志查询中说明了可用的过滤操作符和分析模式。

字段或查询变化后回查模型​

新增字段或改变字段在查询中的使用方式时,在更新查询配置前回查模型参考,确认其字段类型、属性类别和快捷过滤可用性。

字段定义参阅日志模型参考,字段映射参阅标准属性,排查任务参阅日志查询。