Prometheus Go client library使用方式详解
介绍
Prometheus 支持 4 种 指标类型，分别是 Counter、Gauge、Histogram 和 Summary。
Counter 指标类型，指标值是只能递增，不能递减的数值。需要注意的是，当 Prometheus server 重启时，指标值会被重置为 0。该指标类型可用于统计接口的请求数、错误数等使用场景。
Gauge 指标类型，指标值是可增可减的数值。该指标类型可用于统计 CPU、内存和硬盘的使用情况，goroutine 的数量等使用场景。
Histogram 指标类型，指标值基于桶分布。开发者可以自定义桶的区间。该指标类型可用于统计接口的延时请求数等使用场景。
Summary 指标类型，与 Histogram 类似，区别是 Histogram 直接统计了不同区间中的指标数值，而 Summary 是基于客户端级别，因此不能统计多个实例的聚合数据。该指标类型可用于预先不知道指标桶划分区间的场景。
使用方式
一般在实际应用场景中，通常一个指标需要对应多条时序数据（Label Name 为维度），此时就需要使用支持标签的指标类型。
Prometheus 有 4 种支持标签的指标类型，分别是 ConterVec、GaugeVec、HistogramVec、SummaryVec。
CounterVec
CounterVec 与 Counter 的区别是，它支持 Label，我们可以按照 Lable 维度，将同一个指标的数据按照 Lable 分组统计。例如，同一个 Api 接口的请求数，我们可以定义 Lable (Code、Method)，按照状态码和 HTTP 请求方式，分组统计同一个 Api 接口的请求数。
示例代码：
var (
// 标签名
labelNames = []string{"host", "code", "path", "method"}
// HttpReqs 实例化 CounterVec
HttpReqs *prometheus.CounterVec = prometheus.NewCounterVec(prometheus.CounterOpts{
Name: "http_requests_total",
Help: "How many HTTP requests processed, partitioned by status code and HTTP method.",
},
labelNames,
)
)
阅读上面这段代码，我们使用 NewCounterVec 创建一个实例，它支持多个方法，我们可以使用其中一个性能相对较高的方法 WithLabelValues，返回一个 Counter。
示例代码：
func Metrics() gin.HandlerFunc {
return func(c *gin.Context) {
c.Next()
host := c.RemoteIP()
code := fmt.Sprintf("%d", c.Writer.Status())
method := c.Request.Method
labelsByHttpReqs := []string{host, code, c.FullPath(), method}
prometheus_metrics.HttpReqs.WithLabelValues(labelsByHttpReqs...).Inc()
}
}
Counter 支持两个方法，分别是 Inc() 和 Add()，其中 Inc() 将 Counter 增加 1，Add() 将 Counter 增加给定值，需要注意的是，给定值必须为非负值，否则会引发 panic。
需要注意的是，在我们创建指标之后，还需要使用 Register() 接口的 Register() 方法，注册之后才可以被收集到指标数据。如果需要注册多个指标，可以使用 MustRegister() 方法。
示例代码：
reg := prometheus.NewRegistry() reg.MustRegister(prometheus_metrics.HttpReqs, prometheus_metrics.OpsQueued, prometheus_metrics.Latencies, prometheus_metrics.Temps)
GaugeVec
GaugeVec 与 Gauge 的区别是，它支持 Label，我们可以按照 Lable 维度，将同一个指标的数据按照 Lable 分组统计。
示例代码：
var (
labelNamesByOpsQueued = []string{
"user",
"type",
}
OpsQueued = prometheus.NewGaugeVec(
prometheus.GaugeOpts{
Name: "ops_queued",
Help: "Number of blob storage operations waiting to be processed, partitioned by user and type.",
},
labelNamesByOpsQueued,
)
)
阅读上面这段代码，我们使用 NewGaugeVec 创建实例。
HistogramVec
HistogramVec 与 Histogram 的区别是，它支持 Label，我们可以按照 Lable 维度，将同一个指标的数据按照 Lable 分组统计。
示例代码：
var (
labelNamesByLatencies = []string{"method", "code"}
Latencies = prometheus.NewHistogramVec(
prometheus.HistogramOpts{
Name: "http_request_duration_seconds",
Help: "Tracks the latencies for HTTP requests.",
Buckets: []float64{0.99, 0.9, 0.5},
},
labelNamesByLatencies,
)
)
SummaryVec
SummaryVec 与 Summary 的区别是，它支持 Label，我们可以按照 Lable 维度，将同一个指标的数据按照 Lable 分组统计。
示例代码：
var (
labelNamesByTemps = []string{"species"}
Temps = prometheus.NewSummaryVec(
prometheus.SummaryOpts{
Name: "pond_temperature_celsius",
Help: "The temperature of the frog pond.",
Objectives: map[float64]float64{0.5: 0.05, 0.9: 0.01, 0.99: 0.001},
},
labelNamesByTemps,
)
)
阅读上面这段代码，使用 NewSummaryVec 创建实例。
总结
本文我们主要介绍 4 种指标类型的含义，通过 Label 可以将 4 种类型的指标数据，按照 Label 的维度分组统计，我们以支持 Label 的 CounterVec 为例，介绍了它的使用方式，其余 3 种支持 Label 的指标也提供了简单的使用示例。
感兴趣的读者朋友们可以通过阅读源码，了解更多关于其它 3 种支持 Label 的指标。
更多关于Prometheus Go client library的资料请也可以关注脚本之家其它相关文章！
相关文章
这篇文章主要为大家介绍了Go语言Goroutinue和管道效率使用详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-09-09
Golang微服务框架Kratos实现分布式任务队列Asynq的方法详解
任务队列（Task Queue） 一般用于跨线程或跨计算机分配工作的一种机制,在Golang语言里面,我们有像Asynq和Machinery这样的类似于Celery的分布式任务队列,本文就给大家详细介绍一下Golang微服务框架Kratos实现分布式任务队列Asynq的方法,需要的朋友可以参考下2023-09-09
这篇文章主要介绍了解决goland 导入项目后import里的包报红问题，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2021-05-05
这篇文章主要介绍了谈谈对Golang IO读写的困惑，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-08-08
viper 配置管理解析库，是由大神 Steve Francia 开发，本文就来和大家详细讲讲它的具体使用，文中的示例代码讲解详细，需要的可以收藏一下2023-06-06
在Go语言中,有两个比较雷同的内置函数,分别是new和make方法,二者都可以用来分配内存,那他们有什么区别呢？下面就跟随小编一起来学习一下吧2024-02-02
这篇文章主要介绍了Golang学习笔记（六）：struct,本文讲解了struct的声明及初始化、struct的匿名字段(继承)、method、method继承和重写等内容,需要的朋友可以参考下2015-05-05
这篇文章主要为大家介绍了 Apache IoTDB开发系统之Go原生接口方法,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2023-09-09
golang结构化日志log/slog包之slog.Record的用法简介
这篇文章主要为大家详细介绍了golang结构化日志log/slog包中slog.Record结构体的使用方法和需要注意的点,文中的示例代码讲解详细,需要的可以学习一下2023-10-10
这篇文章主要给大家介绍了关于golang如何实现mapreduce单进程版本的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧。2018-01-01
最新评论