PromQL 从⼊⻔到精通 对于 Prometheus 生态的监控系统，PromQL 是必备技能，本文着重点讲解这个查询语言，掺 杂一些生产实践场景，希望对你有所帮助。 ? 本文作者：秦晓辉，Open-Falcon、Nightingale 等开源项目创始人之一，极客时间《运 维监控系统实战笔记》作者；当前在创业（快猫星云联创），为客户提供监控/可观测性产品 方案，有需求的朋友欢迎联系我的微信 不动上报给监控服务端，那计算增量、计算速率这个需求，就要放到服务端来实现了，所以服务 端必须要能对这种类型的数据建模抽象，也就是所谓的 Counter 类型。 时序数据 PromQL 就是查询时序数据的一种 Query Language，要想对 PromQL 有了解，得先搞清楚时 序数据。 认识时序数据 我们先来看一张图，图上是 5 台机器的内存可用率： 每个机器的内存可用率数据，体现为图上的一条线，我们称为 文档中有一个章节专门介绍函数，各个函数的介绍中，都会写明是用于 instant- vector，还是用于 range-vector，如果不理解查询类型，就无法很好的应用这些函数。 查询选择器 PromQL大括号里的部分是 selector，查询选择器，用于从一大堆监控数据中，过滤出真正关心 的数据，在 Prometheus 生态里，时序数据的标识，就是一堆标签集合，所以这里的过滤，就 是针对标签做过滤，支持四类操作符：

第三届中国 Rust 开发者大会 PromQL Got a BOOST: 用 Rust 重写 Prometheus 的查询引擎 Ruihang Xia @greptime.com Ruihang GitHub: waynexia Losing hair at Greptime Wanna sleep 10 hrs/day Learn JS every year Healing About Prometheus and PromQL Why rewrite? What are boosted? PROMETHEUS AND PROMQL The de facto standard in cloud-native monitor scenario Has its own query language called “PromQL” rate(api_reque n{host=“foo”}[5m]) More than a monitor: alert, visualize with many integrations PROMETHEUS AND PROMQL rate(api_request_duration{host=“foo”}[5m]) Operator Data Filter Range SELECT rate(val) OVER (

ServiceMonitor API 7.3. 查询指标 OpenShift Container Platform 监控仪表板可供您运行 Prometheus Query Language (PromQL) 查询来 查看图表中呈现的指标。此功能提供有关集群以及要监控的任何用户定义工作负载的状态信息。 作为集群管理 集群管理员 员，您可以查询所有 OpenShift Container Platform 监 监控 控 74 2. 选择 Insert Metric at Cursor 来查看预定义的查询列表。 3. 要创建自定义查询，请将 Prometheus Query Language (PromQL) 查询添加到 Expression 字 段。 4. 要添加多个查询，选择 Add Query。 5. 要删除查询，选择查询旁边的 ，然后选择 Delete query。 6. 要禁止运行查询，请选择查询旁边的 并且仅使用指标表来校准查询。然后，在找 到可行的查询后，启用图表来绘制图形。 8. 可选：页面 URL 现在包含您运行的查询。要在以后再次使用这一组查询，请保存这个 URL。 其他 其他资 资源 源 有关创建 PromQL 查询的更多详情，请参阅 Prometheus query 文档。 7.3.2. 以开发者身份查询用户定义的项目的指标 您可以以开发者或具有项目查看权限的用户身份访问用户定义项目的指标。 在

Virtualization 仪表板提供虚拟机和相关 pod 的资源消耗数据。OpenShift Virtualization 仪表板中显示的视觉化指标基于 Prometheus Query Language (PromQL) 查询。 3.4. 弃用和删除的功能 3.4.1. 已弃用的功能 弃用的功能包括在当前发行版本中并被支持。但是，它们将在以后的发行版本中删除，且不建议用于新部 署。 在以后的发行版本中，对旧的 Virtualization 仪表板提供有关虚拟机和相关 pod 资源消耗的数据。OpenShift Virtualization 仪 表板中显示的视觉化指标基于 Prometheus Query Language (PromQL) 查询。 OpenShift Container Platform 4.10 虚 虚拟 拟化 化 272 为了在 OpenShift Virtualization 仪表板中监控用户定义的命名空间，需要一个 Period 下拉菜单中选择预定义的时间周期。您可以在表中查看顶级使用者的数据。 4. 可选：点击 Inspect 以查看或编辑与表顶使用者关联的 Prometheus Query Language (PromQL) 查询。 第 第 13 章 章 日志 日志记录 记录、事件和 、事件和监 监控 控 273 13.8.3. 其他资源 监控概述 查看监控仪表板 13.9. OPENSHIFT CONTAINER

户机上启用内存交换。 14.3.3.2. 查询指 指标 OpenShift Container Platform 监控仪表板可供您运行 Prometheus Query Language (PromQL) 查询来 查看图表中呈现的指标。此功能提供有关集群以及要监控的任何用户定义工作负载的状态信息。 作为集群管理员，您可以查询所有 OpenShift Container Platform 核心项目和用户定义的项目的指标。 2. 要添加一个或多个查询，请执行以下操作之一： 选项 选项 描述 描述 创建自定义查询。 将 Prometheus Query Language (PromQL) 查询 添加到 Expression 字段中。 当您输入 PromQL 表达式时，自动完成建议会出 现在下拉列表中。这些建议包括功能、指标、标 签和时间令牌。您可以使用键盘箭头选择其中一 项建议的项目，然后按 Enter 将项目添加到您的 UI 包括所选项目的一些预定义 CPU、内存、带宽和网络数据包查询。您 还可以对项目的 CPU、内存、带宽、网络数据包和应用程序指标运行自定义 Prometheus Query Language (PromQL) 查询。 注意 注意 开发者只能使用 Developer 视角，而不能使用 Administrator 视角。作为开发者，您一次 只能查询一个项目的指标。 先决条件 先决条件 对于您要

被监控组 件信息的HTTP接口被叫做exporter Promethus特点： 支持多维数据模型：由度量名和键值对组成的时间序列数据 内置时间序列数据库TSDB 支持PromQL查询语言，可以完成非常复杂的查询和分析，对图表展示和告警 非常有意义 支持HTTP的Pull方式采集时间序列数据 支持PushGateway采集瞬时任务的数据 支持服务发现和静态配置两种方式发现目标 删除操作都是删除一段时间的数据，而不涉及到删除无规律数据 读操作一般都是升序或者降序 ③HTTP Server: 为告警和绘图提供查询接口 Promethus通过PromQL语句查询指标信息，并在页面展示。虽然Prometheus自 带UI界面，但是大多数是使用Grafana进行绘图展示。另外也可通过API接口来给 第三方软件提供监控指标。alertmanager组件负责邮件报警。

获取的指标的摘要。 METRICS_SUMMARY_BY_LABEL 参见 METRICS_SUMMARY 表。 METRICS_TABLES 为 METRICS_SCHEMA 中的表提供 PromQL 定义。 SEQUENCES 描述了基于 MariaDB 实现的 TiDB 序列。 SLOW_QUERY 提供当前 TiDB 服务器上慢查询的信息。 STATEMENTS_SUMMARY 类似于 tpch 大查询导致了出现很多的 cop 请求。 12.11.14.2.25 METRICS_TABLES METRICS_TABLES 表为metrics_schema 数据库中的每个视图提供 PromQL（Prometheus 查询语言）定义。 USE information_schema; DESC metrics_tables; +------------+-------------- +------------+--------------+------+------+---------+-------+ | TABLE_NAME | varchar(64) | YES | | NULL | | | PROMQL | varchar(64) | YES | | NULL | | | LABELS | varchar(64) | YES | | NULL | | | QUANTILE | double

获取的指标的摘要。 METRICS_SUMMARY_BY_LABEL 参见 METRICS_SUMMARY 表。 METRICS_TABLES 为 METRICS_SCHEMA 中的表提供 PromQL 定义。 SEQUENCES 描述了基于 MariaDB 实现的 TiDB 序列。 SLOW_QUERY 提供当前 TiDB 服务器上慢查询的信息。 STATEMENTS_SUMMARY 类似于 tpch 大查询导致了出现很多的 cop 请求。 12.11.14.2.25 METRICS_TABLES METRICS_TABLES 表为metrics_schema 数据库中的每个视图提供 PromQL（Prometheus 查询语言）定义。 USE information_schema; DESC metrics_tables; 1725 +------------+-------- +------------+--------------+------+------+---------+-------+ | TABLE_NAME | varchar(64) | YES | | NULL | | | PROMQL | varchar(64) | YES | | NULL | | | LABELS | varchar(64) | YES | | NULL | | | QUANTILE | double

integration with kubernetes at infrastructure and app level. ● Key - value data model with powerful PromQL. ● Emerging open source community.Prometheus 2.0 - deal with dynamic nature ● Storage engine redesign

可能会丢数据 ○ 没有 WAL(Write-Ahead Log) ● 扩容/维护时可能容易崩溃 ○ vmstorage 没有服务自动发现 ● 兼容性需要关注 ○ MetricsQL 与 PromQL 有差异 总结与展望 第五部分 2023 关键成果 ● 查询性能大幅提升，用户体验好 ● 稳定性大幅提升，几乎没有 OOM ● 资源成本得到降低，至少降低 30% 的成本 2024