Skip to content

Latest commit

 

History

History
61 lines (41 loc) · 3.86 KB

metric-types.md

File metadata and controls

61 lines (41 loc) · 3.86 KB

指標(metrics)類型

Prometheus 的客戶端函式庫提供四種核心指標。目前這些功能僅在客戶端函式庫(使 API 能量身定制以使用特定類型)和有線協議(wire protocol)中有所不同。Prometheus 服務端尚未使用指標類型資訊,而是將所有數據展開成無類型的時間序列。這在未來可能會有所改變。

計數器(Counter)

計數器是一個累計指標,意味著它單一且單調的累加計數器,其值只能增加或重新啟動時重置為零。計數器通常使用來計數服務的請求、完成的任務、發生的錯誤等等。

計數器不應該被用來顯示其數目也可以減少的項目的當前計數,如:當前正在運行的進程的數量,這個用例適合使用測量儀

計數器的客戶端函式庫使用文檔:

測量儀(Gauge)

測量儀代表一個可以任意上下的單個數值。測量儀通常用於測量值,如:溫度或當前的內存使用情況,但也可以上下計數,如正在運行的進程的數量。

測量儀的客戶端函式庫使用文檔:

直方圖(Histogram)

直方圖對觀察結果進行採樣(通常是請求持續時間或響應大小),並將其計入可配置的貯體(buckets) 中。它也提供了所有觀測值的總和。

指標名稱為 <basename> 的直方圖在收集期間公開多個時間序列:

  • 觀察貯體的累計計數器顯示為 <basename>_bucket {le="<upper inclusive bound>"}
  • 所有觀察值的總和,輸出為 <basename>_sum
  • 觀察的是建數,輸出為 <basename>_count(與之相同 <basename>_bucket{le="+Inf"}

使用 histogram_quantile() 函數可以根據直方圖或直方圖的聚合來計算分位數。直方圖也適合計算 Apdex 得分。在貯體操作時,請記住直方圖是累積的。有關直方圖使用和差異的介紹,請參見直方圖和介紹

直方圖的客戶端函式庫使用文檔:

摘要(Summary)

類似直方圖,摘要會取樣觀察結果(通常是請求間隔和回應大小)。同時它還提供了觀測值的總數和所有觀測值的總和。在可配置的時間內計算分位數。

指標名稱為 <basename> 的摘要,顯示抓取間隔的多個時間序列:

  • 觀察事件的串流 φ-分位數(0≤φ≤1),顯示為 <basename> {quantile ="<φ>"}
  • 所有觀察值的總和(sum),顯示為 <basename>_sum
  • 已觀察的事件計數(count),顯示為 <basename>_count

有關 φ-分位數、摘要使用與直方圖差異的詳細說明,參見直方圖和摘要

摘要的客戶端函式庫使用文檔: