如何避免Grafana自定义变量内容被自动转义？

问题场景 #

在Grafana中配置对接Elasticsearch的仪表盘，需要实现「是否包含重要详情：是/否/全部」的筛选功能，筛选逻辑为判断文档是否携带important_details字段。
初始配置流程：

• 新建Custom类型自定义变量has_important_details，配置可选项为：

Yes : _exists_:important_details, No : NOT _exists_:important_details

• 在面板查询中直接引用$has_important_details变量后筛选不生效，排查发现Grafana自动对变量值里的特殊字符做了转义：
  • 选择「是」时实际下发查询为_exists_\\:important_details
  • 选择「否」时实际下发查询为NOT\\ _exists_\\:important_details
    转义后的内容不符合Elasticsearch Lucene查询语法，导致筛选逻辑完全失效。

修复方法 #

问题根源是Grafana默认变量引用逻辑会自动转义特殊字符，避免查询语法冲突，但该逻辑不适配Elasticsearch的Lucene查询语法，按以下两步调整即可解决：

• 补全全量筛选选项
  编辑has_important_details自定义变量，将可选项配置修改为以下内容，补充全部选项对应的匹配规则：

  All : *,
  Yes : _exists_:important_details,
  No : NOT _exists_:important_details
  

  若变量开启了「Include All option」配置，将自定义All值填入*，即可实现选中全部时匹配所有文档。
• 使用原始值引用语法，跳过自动转义
  面板查询中不要直接使用$has_important_details引用变量，替换为带raw格式符的引用写法：

  ${has_important_details:raw}
  

  该写法会让Grafana直接输出变量的原始值，不对冒号、空格、逻辑运算符做转义处理，最终下发到Elasticsearch的查询完全符合Lucene语法预期。

若调整后仍存在转义异常，检查当前Grafana的Elasticsearch数据源插件版本，部分低版本插件存在强制转义的已知问题，升级插件到适配版本即可修复。

内容的提问来源于stack exchange，提问作者Antonis Christofides