prometheus.NewHistogram() 用於直方圖度量類型的 api

Question

使用github.com/prometheus/client_golang/prometheus庫來檢測 GO 應用程序，以獲取指標：

在下面的代碼中：

requestDurations := prometheus.NewHistogram(prometheus.HistogramOpts{
     Name: "http_request_duration_seconds"
     Help: "A Histogram of the http request duration in secconds"

     // Cumulative bucket upper bounds
     Buckets: []float64{0.05, 0.1, 0.25, 0.5, 1, 2,5, 5, 10}
})

requestDurations.Observe(0.42)

---

1. Buckets: []float64{0.05, 0.1, 0.25, 0.5, 1, 2,5, 5, 10}意味着什么？

2. requestDurations.Observe(0.42)意味着什么？

Answer 1

正如包文檔所述：

Buckets 定義了對觀察進行計數的桶。 切片中的每個元素都是桶的包含上限。 這些值必須嚴格按遞增順序排序。 不需要添加一個帶有+Inf 綁定的最高bucket，它會被隱式添加。 默認值為 DefBuckets。

直方圖計算桶中的觀察值。 通過此聲明，您可以聲明上限為 0.05、0.1、0.25、...、5、10、+inf 的存儲桶。 每個觀察值都將計入這些存儲桶之一。 例如， Observe(0.42)將增加上限 >=0.5 的桶。

Answer 2

我建議您閱讀大量的在線文檔，例如Histograms

直方圖由值桶表示。

第一個命令通過上限定義直方圖的桶：值 <= 0.05、<= 0.1 等。

第二個命令通過增加 <= 0.5 桶（和所有更大的桶）將觀察值 0.42 添加到直方圖。