首页/云/可观测性速查/Mapping 与字段类型选择
本包目录(282 条)
监控体系与方法40 条Prometheus 与采集64 条Grafana 与看板53 条
日志平台52 条
链路追踪23 条告警与响应50 条

Mapping 与字段类型选择

映射定义字段如何索引:keyword 用于精确匹配与聚合,text 会分词用于全文检索;字段类型选错会让查询与聚合都出问题。

可观测性速查云更新于 2026-10-12

字段类型与查询方式

字段类型与查询方式
# 查看映射
GET /logs-app/_mapping

# 追加字段(已有字段类型不能直接改,需重建索引)
PUT /logs-app/_mapping
{
  "properties": {
    "trace_id":  { "type": "keyword" },
    "duration_ms": { "type": "long" },
    "message":   { "type": "text" }
  }
}
经验规则:枚举/ID/设备名用 keyword;自由文本用 text;数值与时间用对应类型以支持范围查询。

易错点

  • 对 text 字段做 term 精确查询常查不到结果(已被分词),应查 .keyword 子字段
  • 已有字段类型不能原地改成不兼容类型,升级映射要重建索引再切换别名

数据来源与参考

  • Elastic 官方文档 · Mapping
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌