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. 以开发者身份查询用户定义的项目的指标 您可以以开发者或具有项目查看权限的用户身份访问用户定义项目的指标。 在

points Highly dynamic, built-in service discovery No hierarchical model, n-dimensional label set PromQL: for processing, graphing, alerting, and export Simple operation Highly efficient Richard Hartmann Prometheus Deep Dive Introduction Intro 2.0 to 2.2.1 2.4 - 2.6 Beyond Outro PromQL Quick is not quick enough Brian Brazil optimized PromQL 5x faster for time vector functions 100x reduction in garbage to collect

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

points Highly dynamic, built-in service discovery No hierarchical model, n-dimensional label set PromQL: for processing, graphing, alerting, and export Simple operation Highly efficient Richard Hartmann @TwitchiH & @fredbrancz Intro to Prometheus Introduction Background Operations & observability Outro PromQL vs SQL avg by(city) (temperature_celsius{country=" germany" }) SELECT city, AVG(value) FROM temperature_celsius

户机上启用内存交换。 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 视角。作为开发者，您一次 只能查询一个项目的指标。 先决条件 先决条件 对于您要

Description METRICS_SUMMARY_BY_LABEL See METRICS_SUMMARY �→ table. METRICS_TABLES Provides the PromQL definitions for tables in METRICS_SCHEMA �→ . SEQUENCES The TiDB implemen- tation of sequences is cause many Coprocessor requests. 12.11.14.2.25 METRICS_TABLES The METRICS_TABLES table provides the PromQL (Prometheus Query Language) defini- tion for each of the views in the metrics_schema database. USE +------------+--------------+------+------+---------+-------+ | TABLE_NAME | varchar(64) | YES | | NULL | | | PROMQL | varchar(64) | YES | | NULL | | | LABELS | varchar(64) | YES | | NULL | | | QUANTILE | double

Description METRICS_SUMMARY_BY_LABEL See METRICS_SUMMARY �→ table. METRICS_TABLES Provides the PromQL definitions for tables in METRICS_SCHEMA �→ . PLACEMENT_RULES Provides information on all objects cause many Coprocessor requests. 12.11.17.2.25 METRICS_TABLES The METRICS_TABLES table provides the PromQL (Prometheus Query Language) defini- tion for each of the views in the metrics_schema database. USE +------------+--------------+------+------+---------+-------+ | TABLE_NAME | varchar(64) | YES | | NULL | | | PROMQL | varchar(64) | YES | | NULL | | | LABELS | varchar(64) | YES | | NULL | | | QUANTILE | double

Description METRICS_SUMMARY_BY_LABEL See METRICS_SUMMARY �→ table. METRICS_TABLES Provides the PromQL definitions for tables in METRICS_SCHEMA �→ . SEQUENCES The TiDB implemen- tation of sequences is cause many Coprocessor requests. 12.11.14.2.25 METRICS_TABLES The METRICS_TABLES table provides the PromQL (Prometheus Query Language) defini- tion for each of the views in the metrics_schema database. USE +------------+--------------+------+------+---------+-------+ | TABLE_NAME | varchar(64) | YES | | NULL | | | PROMQL | varchar(64) | YES | | NULL | | | LABELS | varchar(64) | YES | | NULL | | | QUANTILE | double