Kibana垂直柱状图X轴如何将Terms聚合Key映射为自定义名称
Elasticsearch Terms 聚合场景下X轴key值自定义映射的实现方案
针对你当前使用key字段做Terms聚合、通过Count统计生成垂直柱状图时,需要把原始长串key(如UUID值)替换为预设自定义展示名的需求,有三类可落地的实现路径,可根据你的技术栈灵活选择:
方案1:ES聚合层面直接完成映射(优先推荐)
完全不需要改动后续的数据处理逻辑,直接在Terms聚合的配置中嵌入预设映射规则,让ES返回的聚合桶key直接就是自定义展示名称。
- 实现原理:替换原本直接取
key字段值的聚合逻辑,改用脚本读取文档的原始key值,匹配内置的映射字典后返回自定义名称作为聚合桶的分类依据 - 参考的聚合DSL片段:
{ "aggs": { "key_stats": { "terms": { "script": { "source": """ // 在此维护你全部10个key的映射关系 def displayKeyMap = [ "08e470d3-14bd-4a5f-9756-df67aff1a793": "kita1", // 剩余9个key的映射项按相同格式补充 "其他原始key值": "对应自定义展示名" ]; // 未匹配到映射的场景兜底返回原始key,避免漏配置导致数据丢失 return displayKeyMap.get(doc['key.keyword'].value, doc['key.keyword'].value); """ }, "size": 10 } } } }
注意:如果你的key字段是text类型,脚本里一定要取对应的.keyword子字段值,避免聚合报错
方案2:后端服务层做结果映射
如果不方便直接修改线上ES的聚合配置,可以在服务层拿到ES返回的Terms聚合结果后,遍历每个聚合桶的原始key值,匹配提前维护好的映射字典,将桶的key值替换为自定义名称后再返回给前端图表组件。
- 操作时同样需要加兜底逻辑:未匹配到映射规则的原始key直接保留原值,不要直接丢弃对应聚合桶的统计数据。
方案3:前端图表层做映射替换
如果你的数据链路是ES结果直连前端、没有中间后端处理环节,可以在前端维护好映射关系表,在渲染X轴刻度值时,查表把原始key替换为自定义展示名即可。
- 参考前端处理逻辑:
// 前端维护的key-展示名映射表 const keyMap = { "08e470d3-14bd-4a5f-9756-df67aff1a793": "kita1", // 剩余9个映射项补充 } // X轴刻度渲染取值函数 function renderXAxisLabel(originalKey) { return keyMap[originalKey] ?? originalKey }
关键优化提示
- 因为你目前总共只有10个固定的key值,上述三种方案的性能消耗、维护成本都极低,完全不需要为了映射给每条业务文档额外新增冗余的
display_name字段(后续调整映射关系时需要全量更新ES存量文档,维护成本极高) - 映射规则的修改尽量靠近数据源头(优先级:ES层 > 后端层 > 前端层),减少多端同步配置的遗漏风险
内容的提问来源于stack exchange,提问作者Vipin Gupta
相关产品推荐
相关产品推荐

