Prometheus 的查詢語言 PromQL 詳解

作者：frank 2023-11-26 23:59:16

需要注意的是，本文我們介紹的是 PromQL 的查詢范疇，關于 PromQL 計算范疇的內容，我們都沒有介紹，比如，算術運算符、比較運算符、邏輯運算符，也是非常重要的內容，尤其在我們配置告警時會用到這些運算符。?

我們使用 Prometheus Go client library 在 Go 代碼中埋點，將指標數據上報到 Prometheus server，接下來我們使用 PromQL 查詢指標數據。

PromQL 可以在 Prometheus 提供的 http://localhost:9090/graph 中執行，本文我們介紹怎么使用 PromQL 查詢指標數據。

PromQL 除了直接使用指標名稱查詢時序數據之外，還可以聯合使用 Label 和函數等。

比如我們使用最多的 Counter 指標類型，它會統計自啟動 Prometheus 以來的計數總和，但是我們并不關心總數。我們只想知道 Counter 隨著時間的推移，計數增加的速度。

比如我們可以直接使用自定義指標名稱 http_request_count_total 查詢所有指標名稱為 http_request_count_total 的指標數據（HTTP 請求數）。

實際上，我們并不是要查詢 HTTP 請求數的總和，而是想查詢單位時間內，請求數的增長速度。此時，我們可以使用函數 rate 完成。

使用 rate(http_request_count_total[5m]) 可以查詢 HTTP 每秒請求數，其中 [5m] 是指過去 5 分鐘每秒請求數的平均值。

比如我們的 HTTP 請求數指標中包含 PATH 標簽，如果我們想要統計所有 HTTP 請求數指標的每秒請求數的總和，可以使用 sum 聚合運算符和 without 子句，sum without(path)(rate(http_request_count_total[5m]))。

比如我們想要查詢指定 PATH 的 HTTP 每秒請求數，我們可以使用 rate(http_request_count_total{path="/ping"}[5m]) 查詢，我們通過 {path="/ping"} 過濾指標數據。

實際上 http_request_count_total{path="/ping"} 中 {} 稱為選擇器，其中 path="/ping" 中的 = 稱為匹配器，我們可以在 {} 中使用多個匹配器，使用 , 分隔。

匹配器有 4 種，path="/ping" 中的 = 是等式匹配器，此外，還有 != 不等、=~ 正則等、!~ 正則不等。

本文我們主要介紹 PromQL 的一般使用方式，主要包括以下幾個維度：

除了指標名稱和標簽，我們在之前的文章介紹過之外，其它都屬于新知識，聚合運算符共計 11 個，我們只使用了 sum，子句除了 without 之外，還有 by，函數也只是使用 rate 舉例，建議讀者朋友們閱讀官方文檔，了解所有聚合運算符和函數的使用方式。

需要注意的是，本文我們介紹的是 PromQL 的查詢范疇，關于 PromQL 計算范疇的內容，我們都沒有介紹，比如，算術運算符、比較運算符、邏輯運算符，也是非常重要的內容，尤其在我們配置告警時會用到這些運算符。

責任編輯：武曉燕來源： Golang語言開發棧