01、介紹

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

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

02、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" 中的 = 是等式匹配器，此外，還有 != 不等、=~ 正則等、!~ 正則不等。

03、總結

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

1. 指標名稱
2. 標簽
3. 聚合運算符
4. 子句
5. 函數
6. 選擇器
7. 匹配器

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

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