04-Summary（摘要）

合集 - 【SDK卷】-----------------------------(24)
1.strings包2.envconfig包（读取环境变量）3.gocron包（定时任务）4.go-redis包5.net/http包实战6.net/http包Client的使用7.01-判断正则匹配、判断正则合法性8.02-查找正则匹配字串、查找正则匹配字串的位置9.03-查找匹配字串，查找匹配字串位置，正则分组10.04-使用正则替换11.06-其他用法12.01-注释、作用域、空格和空行、管道13.02-变量、if语句、迭代、内置函数14.01-入门示例、工作簿、文件Writer15.02-工作表操作16.03-行和列操作17.04-迭代器18.05-单元格操作19.06-样式设置20.07-流式写入21.01-Gauge（仪表盘）22.02-Counter（计数器）23.03-HIstogram（直方图）
24.04-Summary（摘要）
收起

@

目录

1. 不带标签的Summary

语法

  • 实例化
func NewSummary(opts SummaryOpts) Summary
  • SummaryOpts 结构体
type SummaryOpts struct {
    Namespace   string
    Subsystem   string
    Name        string
    Help        string
    ConstLabels Labels
    Objectives  map[float64]float64
    MaxAge      time.Duration
    AgeBuckets  uint32
    BufCap      uint32
}
  • Observe
func (Histogram) Observe(float64)

完整示例

一组学生的成绩，分别为分到59分（含）以下、69分（含）以下……等各bucket中

  • 代码
package main
 
import (
	"flag"
	"fmt"
	"github.com/prometheus/client_golang/prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"log"
	"net/http"
)
var addr = flag.String("listen-address", ":1840", "The address to listen on for HTTP requests")
 
var (
	numSummary = prometheus.NewSummary(prometheus.SummaryOpts{
		Name: "Summary_num",
		Help: "Calculate quantile",
		Objectives: map[float64]float64{0.4:0,0.5:0,0.6:0,0.7:0,0.8:0,0.88:0,0.9:0,0.95:0},
	})
 
)
 
 
func init() {
	prometheus.MustRegister(numSummary)
}
 
func main() {
	flag.Parse()
 
	var numbers = [10]float64{100,200,300,400,500,600,700,800,900,1000}
	for i:=0;i<len(numbers);i++{
		numSummary.Observe(numbers[i])
		fmt.Printf("Insert number: %f \n", numbers[i])
	}
 
	http.Handle("/metrics", promhttp.Handler())
	log.Fatal(http.ListenAndServe(*addr, nil))
}
  • 执行结果
# HELP Summary_num Calculate quantile
# TYPE Summary_num summary
Summary_num{quantile="0.4"} 400
Summary_num{quantile="0.5"} 500
Summary_num{quantile="0.6"} 600
Summary_num{quantile="0.7"} 700
Summary_num{quantile="0.8"} 800
Summary_num{quantile="0.88"} 900
Summary_num{quantile="0.9"} 900
Summary_num{quantile="0.95"} 1000
Summary_num_sum 5500
Summary_num_count 10

结果说明：

  • Summary_num{quantile="0.4"}：该数组从小到大排序，前40%（含）的成员最后一个是400

如：本例从小到大排序，前40%是：100,200，300，400。最后一个是400。

  • Summary_num{quantile="0.8"}：该数组从小到大排序，前80%（含）的成员最后一个是800
  • Summary_num{quantile="0.88"}：该数组从小到大排序，前88%（含）的成员最后一个是900

从小到大排序后，前80%（含）的最后一位是800，但前88%（含）不包含800了，而最后一个取到了900

  • summary_count_sum：所用统计的数字（10个）和为5500
  • scores_count_count：当前一共统计了10个数的结果

2. 带标签的Summary

语法

  • 实例化
func NewSummaryVec(opts SummaryOpts, labelNames []string) *SummaryVec
  • HistogramOpts结构体
type SummaryOpts struct {
    Namespace   string
    Subsystem   string
    Name        string
    Help        string
    ConstLabels Labels
    Objectives  map[float64]float64
    MaxAge      time.Duration
    AgeBuckets  uint32
    BufCap      uint32
}
  • 打标签
func (v *HistogramVec) WithLabelValues(lvs ...string) Observer
  • Observe
func (Histogram) Observe(float64)

传入Observe(float64)的数据将统计到Bucket

完整示例

package main
 
import (
	"flag"
	"github.com/prometheus/client_golang/prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"log"
	"net/http"
)
var addr = flag.String("listen-address", ":1840", "The address to listen on for HTTP requests")
 
var (
	numSummary = prometheus.NewSummaryVec(prometheus.SummaryOpts{
		Name: "Summary_num",
		Help: "Calculate quantile",
		Objectives: map[float64]float64{0.4:0,0.5:0,0.6:0,0.7:0,0.8:0,0.88:0,0.9:0,0.95:0},
	},[]string{"group"})
 
)
 
 
func init() {
	prometheus.MustRegister(numSummary)
}
 
func main() {
	flag.Parse()
 
	var numbers01 = [10]float64{100,200,300,400,500,600,700,800,900,1000}
	var numbers02 = [10]float64{1100,1200,1300,1400,1500,1600,1700,1800,1900,2000}
	for i:=0;i<10;i++{
		numSummary.WithLabelValues("group-01").Observe(numbers01[i])
		numSummary.WithLabelValues("group-02").Observe(numbers02[i])
	}
 
	http.Handle("/metrics", promhttp.Handler())
	log.Fatal(http.ListenAndServe(*addr, nil))
}
  • 输出
# HELP Summary_num Calculate quantile
# TYPE Summary_num summary
Summary_num{group="group-01",quantile="0.4"} 400
Summary_num{group="group-01",quantile="0.5"} 500
Summary_num{group="group-01",quantile="0.6"} 600
Summary_num{group="group-01",quantile="0.7"} 700
Summary_num{group="group-01",quantile="0.8"} 800
Summary_num{group="group-01",quantile="0.88"} 900
Summary_num{group="group-01",quantile="0.9"} 900
Summary_num{group="group-01",quantile="0.95"} 1000
Summary_num_sum{group="group-01"} 5500
Summary_num_count{group="group-01"} 10
Summary_num{group="group-02",quantile="0.4"} 1400
Summary_num{group="group-02",quantile="0.5"} 1500
Summary_num{group="group-02",quantile="0.6"} 1600
Summary_num{group="group-02",quantile="0.7"} 1700
Summary_num{group="group-02",quantile="0.8"} 1800
Summary_num{group="group-02",quantile="0.88"} 1900
Summary_num{group="group-02",quantile="0.9"} 1900
Summary_num{group="group-02",quantile="0.95"} 2000
Summary_num_sum{group="group-02"} 15500
Summary_num_count{group="group-02"} 10

说明：见上例

posted on   运维开发玄德公  阅读(31)  评论(0)  编辑  收藏  举报  

相关博文：
· 03-HIstogram（直方图）
· 02-Counter（计数器）
· asp.net core监控—引入Prometheus（五）
· asp.net core监控—引入Prometheus（五）
· Go：Promethus Eexporter开发，一篇带你玩妥它。
阅读排行：
· 全程不用写代码，我用AI程序员写了一个飞机大战
· DeepSeek 开源周回顾「GitHub 热点速览」
· MongoDB 8.0这个新功能碉堡了，比商业数据库还牛
· 记一次.NET内存居高不下排查解决与启示
· 白话解读 Dapr 1.15：你的「微服务管家」又秀新绝活了
< 2025年3月 >
日 一 二 三 四 五 六
23 24 25 26 27 28 1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31 1 2 3 4 5

导航

统计

点击右上角即可分享
微信分享提示