首页/云/可观测性速查/Mutate:字段改名、删减与类型转换
日志平台52 条

Mutate:字段改名、删减与类型转换

mutate 做字段级微调:rename/remove/add_field/convert/gsub;同一块内按书写顺序执行,出错时后续操作可能被跳过。

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

常用操作

常用操作
filter {
  mutate {
    rename => { "host" => "hostname" }
    add_field => { "env" => "prod" }
    convert => { "status" => "integer" }
    gsub => [ "path", "/[0-9]+", "/{id}" ]
    remove_field => ["agent", "ecs"]
  }
}
把动态路径替换成稳定模板(如 /order/{id})能显著降低聚合维度爆炸。

易错点

  • convert 对不可转的值会把字段置空或报错,脏数据先清洗再转
  • gsub 正则误伤正常内容,替换规则先在样本日志上验证

数据来源与参考

  • Elastic 官方文档 · Mutate filter
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌