如何将GCP仪表盘中的MQL查询转换为PROMQL适配Prometheus与Grafana

目前没有官方自动转换工具或直接的文档来完成MQL到PromQL的转换，但可以通过手动映射核心逻辑的方式实现，以下是具体可行思路：

1. 先理清两种查询语言的核心差异 #

• MQL是GCP监控专属语法，侧重GCP资源的层级结构和特定指标命名规则，例如：fetch gce_instance | metric 'compute.googleapis.com/instance/cpu/utilization'
• PromQL基于标签维度体系，指标命名更扁平，具体命名取决于Prometheus抓取GCP指标的方式（比如通过导出工具添加的前缀）

2. 拆解MQL查询逻辑，逐一映射到PromQL #

把MQL拆分为核心组件，对应转换为PromQL语法：

• 指标选择：MQL的metric子句对应PromQL的指标名，注意Prometheus抓取GCP指标时通常会修改命名（比如stackdriver_exporter导出的指标会以stackdriver_开头，GCP官方导出工具的命名也有特定规则）
• 过滤条件：MQL的filter/where子句对应PromQL的标签匹配，例如MQL的filter (resource.instance_name = 'my-instance')对应PromQL的{instance_name="my-instance"}
• 聚合操作：MQL的group_by对应PromQL的sum()/avg()等聚合函数，注意聚合维度的映射，例如MQL的group_by [resource.zone], mean(val())对应PromQL的avg(instance_cpu_utilization) by (zone)
• 时间与速率计算：MQL的rate()/window对应PromQL的rate()/irate()，例如MQL的rate(val(), 1m)对应PromQL的rate(instance_cpu_utilization[1m])

3. 借助导出工具确认指标命名 #

如果使用stackdriver_exporter或GCP官方Prometheus导出工具，先在Prometheus的指标列表中确认导出后的GCP指标具体命名，再对照MQL中的指标名做替换匹配。

4. 测试验证转换结果 #

转换后的PromQL需要在Prometheus中逐步验证：

• 先确认目标指标已被成功抓取到Prometheus
• 逐步添加过滤、聚合条件，对比GCP仪表盘和Grafana中的数据趋势是否一致
• 对齐时间窗口设置，确保两种工具的查询时间范围参数相同

替代方案 #

如果手动转换成本过高，可以考虑：

• 直接使用Grafana的GCP数据源连接GCP监控，无需转换即可复用MQL查询搭建仪表盘
• 通过GCP监控API导出MQL查询结果，再导入Prometheus（但这种方式无法实现实时数据同步）

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