最近對服務進行監控,而當前監控最流行的數據庫就是 Prometheus,同時 go-zero 默認接入也是這款數據庫。今天就對 go-zero 是如何接入 Prometheus ,以及開發者如何本身定義本身監控指標。html
go-zero 框架中集成了基於 prometheus 的服務指標監控。可是沒有顯式打開,須要開發者在 config.yaml 中配置:git
Prometheus: Host: 127.0.0.1 Port: 9091 Path: /metrics
若是開發者是在本地搭建 Prometheus,須要在 Prometheus 的配置文件 prometheus.yaml 中寫入須要收集服務監控信息的配置:github
- job_name: 'file_ds' static_configs: - targets: ['your-local-ip:9091'] labels: job: activeuser app: activeuser-api env: dev instance: your-local-ip:service-port
由於本地是用 docker 運行的。將 prometheus.yaml 放置在 docker-prometheus 目錄下:docker
docker run \ -p 9090:9090 \ -v dockeryml/docker-prometheus:/etc/prometheus \ prom/prometheus
打開 localhost:9090 就能夠看到:數據庫
點擊 http://service-ip:9091/metrics 就能夠看到該服務的監控信息:api
上圖咱們能夠看出有兩種 bucket,以及 count/sum 指標。app
那 go-zero 是如何集成監控指標?監控的又是什麼指標?咱們如何定義咱們本身的指標?下面就來解釋這些問題框架
以上的基本接入,能夠參看咱們的另一篇:https://zeromicro.github.io/go-zero/service-monitor.htmlide
上面例子中的請求方式是 HTTP,也就是在請求服務端時,監控指標數據不斷被蒐集。很容易想到是 中間件 的功能,具體代碼:https://github.com/tal-tech/go-zero/blob/master/rest/handler/prometheushandler.go。函數
var ( metricServerReqDur = metric.NewHistogramVec(&metric.HistogramVecOpts{ ... // 監控指標 Labels: []string{"path"}, // 直方圖分佈中,統計的桶 Buckets: []float64{5, 10, 25, 50, 100, 250, 500, 1000}, }) metricServerReqCodeTotal = metric.NewCounterVec(&metric.CounterVecOpts{ ... // 監控指標:直接在記錄指標 incr() 便可 Labels: []string{"path", "code"}, }) ) func PromethousHandler(path string) func(http.Handler) http.Handler { return func(next http.Handler) http.Handler { return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { // 請求進入的時間 startTime := timex.Now() cw := &security.WithCodeResponseWriter{Writer: w} defer func() { // 請求返回的時間 metricServerReqDur.Observe(int64(timex.Since(startTime)/time.Millisecond), path) metricServerReqCodeTotal.Inc(path, strconv.Itoa(cw.Code)) }() // 中間件放行,執行完後續中間件和業務邏輯。從新回到這,作一個完整請求的指標上報 // [????:洋蔥模型] next.ServeHTTP(cw, r) }) } }
其實整個很簡單:
go-zero 中也提供了 prometheus metric 基本封裝,供開發者本身開發本身 prometheus 中間件。
代碼:https://github.com/tal-tech/go-zero/tree/master/core/metric
名稱 | 用途 | 蒐集函數 |
---|---|---|
CounterVec | 單一的計數。用作:QPS統計 | CounterVec.Inc() 指標+1 |
GuageVec | 單純指標記錄。適用於磁盤容量,CPU/Mem使用率(可增長可減小) | GuageVec.Inc()/GuageVec.Add() 指標+1/指標加N,也能夠爲負數 |
HistogramVec | 反應數值的分佈狀況。適用於:請求耗時、響應大小 | HistogramVec.Observe(val, labels) 記錄指標當前對應值,並找到值所在的桶,+1 |
另外對 HistogramVec.Observe() 作一個基本分析:
咱們其實能夠看到上圖每一個 HistogramVec 統計都會有3個序列出現:
- _count:數據個數
- _sum:所有數據加和
- _bucket{le=a1}:處於 [-inf, a1] 的數據個數
因此咱們也猜想在統計過程當中,分3種數據進行統計:
// 基本上在prometheus的統計都是使用 atomic CAS 方式進行計數的 // 性能要比使用 Mutex 要高 func (h *histogram) observe(v float64, bucket int) { n := atomic.AddUint64(&h.countAndHotIdx, 1) hotCounts := h.counts[n>>63] if bucket < len(h.upperBounds) { // val 對應數據桶 +1 atomic.AddUint64(&hotCounts.buckets[bucket], 1) } for { oldBits := atomic.LoadUint64(&hotCounts.sumBits) newBits := math.Float64bits(math.Float64frombits(oldBits) + v) // sum指標數值 +v(畢竟是總數sum) if atomic.CompareAndSwapUint64(&hotCounts.sumBits, oldBits, newBits) { break } } // count 統計 +1 atomic.AddUint64(&hotCounts.count, 1) }
因此開發者想定義本身的監控指標:
上述都是針對 HTTP 部分邏輯的解析,RPC 部分的邏輯相似,你能夠在 攔截器 部分看到設計。
本文分析了 go-zero 服務監控指標的邏輯,固然對於一些基礎設施的監控,prometheus 能夠經過引入對應的 exporter 來完成。