原生直写索引¶

原生直写索引允许在数据采集阶段直接指定数据写入的目标索引。与日志索引通过筛选条件自动匹配不同，原生直写索引要求 DataKit 采集器在数据上报时显式指定索引名称。

工作原理¶

• DataKit 采集器在采集数据时，通过配置指定目标索引名称；
• 数据上报至工作空间后，系统根据索引名称直接路由到对应索引；
• 若索引名称匹配失败，数据将被丢弃。

使用场景¶

原生直写索引适用于以下场景：

• 确定性路由：需要确保特定来源的数据进入指定索引，不受筛选规则顺序影响
• 高性能写入：避免筛选条件匹配的开销，直接路由到目标索引
• 多租户隔离：不同业务线通过 DataKit 配置明确区分数据存储位置

开始新建¶

1. 进入新建索引 > 原生直写索引页面；
2. 自定义索引的名称（DataKit 采集器将使用此名称上报数据）；
3. 按需添加描述；
4. 配置数据存储策略：选择日志保留时长，到期后自动清理；

5. 配置匹配服务，用于链路追踪关联查询（可选）；

   • 支持通配符模糊匹配（如 service*），多个值用英文逗号分隔。配置后，在链路详情页查看相关日志时，系统优先匹配服务对应的索引日志

6. 确定。

注意事项¶

1. 名称一致性：DataKit 配置的索引名称必须与控制台创建的索引名称完全一致（区分大小写），否则数据将被丢弃；

2. 先创建后使用：若原生直写索引未在控制台创建，即使 DataKit 已配置，数据也会被丢弃；

3. 无筛选匹配：原生直写索引不配置筛选条件，完全依赖 DataKit 上报时指定的索引名称进行路由。

更多阅读¶