跳转至

日志索引


系统根据设定的筛选条件自动将日志数据归档到相应的索引中。通过创建多个日志索引,您可以:

  • 按业务线、环境或项目隔离日志数据
  • 为不同索引配置差异化的存储策略
  • 优化查询性能,减少无关数据的扫描
注意

❗️ 默认情况下,日志索引无法新建,请联系客户经理申请开通此功能

开始新建

  1. 进入新建索引 > 日志索引页面;
  2. 自定义索引名称;
  3. 按需添加描述
  4. 添加匹配条件
  5. 配置数据存储策略:选择日志保留时长,到期后自动清理;

    • 部署版用户可自定义存储时长,范围:1d ~ 1,800d
  6. 按需配置高级选项

  7. 确定。

匹配条件

匹配条件用于定义日志进入当前索引的筛选规则。当前支持两种配置模式:普通匹配进阶匹配

普通匹配

普通匹配沿用原有配置方式,适用于筛选逻辑较简单的场景。

  1. 选择条件关系:

    • 满足所有条件:日志需同时满足全部筛选条件,才会进入当前索引;
    • 满足任一条件:日志满足任意一条筛选条件,即可进入当前索引。
  2. 添加筛选条件:

    • 字段名称:选择日志字段,如 sourceservicehost 等;
    • 运算符:选择匹配方式;
    • 匹配值:输入字段值,多个值用英文逗号分隔。

普通匹配适合按固定字段快速配置索引分流。

进阶匹配

进阶匹配适用于需要更灵活组合匹配规则的场景。启用进阶匹配后,日志数据将进入 Pipeline 进行匹配判断,并会产生相应费用。

在进阶匹配中,您可以配置多条筛选条件,每条条件包含:

  • 字段名称:输入需要判断的日志字段;
  • 匹配方式:支持 =!=innot inmatchnot matchwildcardnot wildcard
  • 匹配值:输入字段对应的匹配值。

点击添加筛选可继续增加条件;点击清空全部条件可移除当前已配置的所有条件。

页面下方会展示表达式预览,用于确认当前筛选条件最终生成的匹配表达式。若条件不完整或表达式无效,页面会提示“请完善或修正筛选条件”,此时需补充字段名称、匹配方式或匹配值后再保存。

注意

日志将按索引列表顺序匹配,仅会进入第一个匹配的索引,同一条日志不会重复进入多个索引。

高级选项(可选)

全文索引字段

  1. message 索引字段(默认):全文搜索仅在原始 message 字段内容中匹配。此模式下,系统保留原始日志内容;

  2. 全行索引:全文搜索在所有业务字段中匹配,不包含系统字段。选择此模式后,系统不再保存原始 message 字段,提取出的业务字段将写入 variant 用于检索(❗️切换为“全行索引”时,请确保字段解析规则完整。若解析规则缺失,可能导致日志内容无法被正常检索)。

什么是全行索引

当选中“全行索引”后,表示它将一条记录中所有由用户定义的、重要的业务字段,打包成一个半结构化的数据对象并存储在一个特殊的列中。这个打包过程排除了数据库自动生成的系统字段。

然后,系统为这个包含所有业务数据的列建立一个全局索引。后续在实际使用的场景中(例如查看器搜索),用户可以进行无需指定字段的全文搜索,输入一个关键词,就能在所有业务字段中匹配到包含该关键词的记录。

匹配服务

用于关联链路追踪数据与应用日志。

  1. 输入规则:支持通配符模糊匹配(如 service*),多个值用英文逗号分隔;
  2. 作用范围:在链路 > 详情页面查看相关日志时,系统优先匹配服务对应的索引日志。

配置示例:

  • payment*:匹配所有以 payment 开头的服务
  • order-service,user-service:精确匹配两个指定服务

索引限制

限制项 说明
总数上限 6 个(含 default 默认索引),即自定义索引最多创建 5 个
匹配机制 顺序匹配,首个匹配的索引生效,后续索引不再匹配
存储时长 部署版支持 1d ~ 1,800d,SaaS 版以页面可选范围为准

更多阅读

文档评价

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