日志索引¶
系统根据设定的筛选条件自动将日志数据归档到相应的索引中。通过创建多个日志索引,您可以:
- 按业务线、环境或项目隔离日志数据
- 为不同索引配置差异化的存储策略
- 优化查询性能,减少无关数据的扫描
注意
❗️ 默认情况下,日志索引无法新建,请联系客户经理申请开通此功能。
开始新建¶
- 进入新建索引 > 日志索引页面;
- 自定义索引名称;
- 按需添加描述
- 添加匹配条件;
-
配置数据存储策略:选择日志保留时长,到期后自动清理;
- 部署版用户可自定义存储时长,范围:1d ~ 1,800d
-
按需配置高级选项;
- 确定。
匹配条件¶
设置日志进入该索引的筛选规则。
1. 条件关系:
- 满足所有条件:日志需同时满足所有筛选规则才进入该索引
- 满足任一条件:日志满足任一筛选规则即可进入该索引
2. 筛选规则:
- 字段名称:选择日志字段(如
source、service、host等) - 运算符:固定为
in - 匹配值:输入字段值,多个值用英文逗号分隔
支持添加多个筛选条件,点击添加筛选增加规则。
注意
日志将按索引列表顺序匹配,仅会进入第一个匹配的索引,同一条日志不会重复进入多个索引。
高级选项(可选)¶
全文索引字段¶
-
仅
message索引字段(默认):全文搜索仅在原始message字段内容中匹配。此模式下,系统保留原始日志内容; -
全行索引:全文搜索在所有业务字段中匹配,不包含系统字段。选择此模式后,系统不再保存原始
message字段,提取出的业务字段将写入 variant 用于检索(❗️切换为“全行索引”时,请确保字段解析规则完整。若解析规则缺失,可能导致日志内容无法被正常检索)。
什么是全行索引
当选中“全行索引”后,表示它将一条记录中所有由用户定义的、重要的业务字段,打包成一个半结构化的数据对象并存储在一个特殊的列中。这个打包过程排除了数据库自动生成的系统字段。
然后,系统为这个包含所有业务数据的列建立一个全局索引。后续在实际使用的场景中(例如查看器搜索),用户可以进行无需指定字段的全文搜索,输入一个关键词,就能在所有业务字段中匹配到包含该关键词的记录。
匹配服务¶
用于关联链路追踪数据与应用日志。
- 输入规则:支持通配符模糊匹配(如
service*),多个值用英文逗号分隔; - 作用范围:在链路 > 详情页面查看相关日志时,系统优先匹配服务对应的索引日志。
配置示例:
payment*:匹配所有以payment开头的服务order-service,user-service:精确匹配两个指定服务
索引限制¶
| 限制项 | 说明 |
|---|---|
| 总数上限 | 6 个(含 default 默认索引),即自定义索引最多创建 5 个 |
| 匹配机制 | 顺序匹配,首个匹配的索引生效,后续索引不再匹配 |
| 存储时长 | 部署版支持 1d ~ 1,800d,SaaS 版以页面可选范围为准 |
