当前位置:首页 > 科技  > 软件

Prometheus Go client library 详解

来源: 责编: 时间:2024-01-03 11:36:15 326观看
导读介绍Prometheus 支持 4 种 指标类型,分别是 Counter、Gauge、Histogram 和 Summary。Counter 指标类型,指标值是只能递增,不能递减的数值。需要注意的是,当 Prometheus server 重启时,指标值会被重置为 0。该指标类型可用

介绍

Prometheus 支持 4 种 指标类型,分别是 Counter、Gauge、Histogram 和 Summary。OdS28资讯网——每日最新资讯28at.com

  • Counter 指标类型,指标值是只能递增,不能递减的数值。需要注意的是,当 Prometheus server 重启时,指标值会被重置为 0。该指标类型可用于统计接口的请求数、错误数等使用场景。
  • Gauge 指标类型,指标值是可增可减的数值。该指标类型可用于统计 CPU、内存和硬盘的使用情况,goroutine 的数量等使用场景。
  • Histogram 指标类型,指标值基于桶分布。开发者可以自定义桶的区间。该指标类型可用于统计接口的延时请求数等使用场景。
  • Summary 指标类型,与 Histogram 类似,区别是 Histogram 直接统计了不同区间中的指标数值,而 Summary 是基于客户端级别,因此不能统计多个实例的聚合数据。该指标类型可用于预先不知道指标桶划分区间的场景。

OdS28资讯网——每日最新资讯28at.com

使用方式

一般在实际应用场景中,通常一个指标需要对应多条时序数据(Label Name 为维度),此时就需要使用支持标签的指标类型。OdS28资讯网——每日最新资讯28at.com

Prometheus 有 4 种支持标签的指标类型,分别是 ConterVec、GaugeVec、HistogramVec、SummaryVec。OdS28资讯网——每日最新资讯28at.com

1.CounterVec

CounterVec 与 Counter 的区别是,它支持 Label,我们可以按照 Lable 维度,将同一个指标的数据按照 Lable 分组统计。例如,同一个 Api 接口的请求数,我们可以定义 Lable (Code、Method),按照状态码和 HTTP 请求方式,分组统计同一个 Api 接口的请求数。OdS28资讯网——每日最新资讯28at.com

示例代码:OdS28资讯网——每日最新资讯28at.com

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。OdS28资讯网——每日最新资讯28at.com

示例代码:OdS28资讯网——每日最新资讯28at.com

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。OdS28资讯网——每日最新资讯28at.com

需要注意的是,在我们创建指标之后,还需要使用 Register() 接口的 Register() 方法,注册之后才可以被收集到指标数据。如果需要注册多个指标,可以使用 MustRegister() 方法。OdS28资讯网——每日最新资讯28at.com

示例代码:OdS28资讯网——每日最新资讯28at.com

reg := prometheus.NewRegistry()reg.MustRegister(prometheus_metrics.HttpReqs, prometheus_metrics.OpsQueued, prometheus_metrics.Latencies, prometheus_metrics.Temps)

2.GaugeVec

GaugeVec 与 Gauge 的区别是,它支持 Label,我们可以按照 Lable 维度,将同一个指标的数据按照 Lable 分组统计。OdS28资讯网——每日最新资讯28at.com

示例代码:OdS28资讯网——每日最新资讯28at.com

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 创建实例。OdS28资讯网——每日最新资讯28at.com

3.HistogramVec

HistogramVec 与 Histogram 的区别是,它支持 Label,我们可以按照 Lable 维度,将同一个指标的数据按照 Lable 分组统计。OdS28资讯网——每日最新资讯28at.com

示例代码:OdS28资讯网——每日最新资讯28at.com

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, ))

4.SummaryVec

SummaryVec 与 Summary 的区别是,它支持 Label,我们可以按照 Lable 维度,将同一个指标的数据按照 Lable 分组统计。OdS28资讯网——每日最新资讯28at.com

示例代码:OdS28资讯网——每日最新资讯28at.com

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 创建实例。OdS28资讯网——每日最新资讯28at.com

总结

本文我们主要介绍 4 种指标类型的含义,通过 Label 可以将 4 种类型的指标数据,按照 Label 的维度分组统计,我们以支持 Label 的 CounterVec 为例,介绍了它的使用方式,其余 3 种支持 Label 的指标也提供了简单的使用示例。OdS28资讯网——每日最新资讯28at.com

本文链接:http://www.28at.com/showinfo-26-56597-0.htmlPrometheus Go client library 详解

声明:本网页内容旨在传播知识,若有侵权等问题请及时与本网联系,我们将在第一时间删除处理。邮件:2376512515@qq.com

上一篇: Python实战:打造高效多进程TCP服务器,轻松应对并发请求!

下一篇: 11个优秀开源TTS引擎

标签:
  • 热门焦点
  • 一加Ace2 Pro官宣:普及16G内存 引领24G

    一加官方今天继续为本月发布的新机一加Ace2 Pro带来预热,公布了内存方面的信息。“淘汰 8GB ,12GB 起步,16GB 普及,24GB 引领,还有呢?#一加Ace2Pro#,2023 年 8 月,敬请期待。”同时
  • 7月安卓手机性能榜:红魔8S Pro再夺榜首

    7月份的手机市场风平浪静,除了红魔和努比亚带来了两款搭载骁龙8Gen2领先版处理器的新机之外,别的也想不到有什么新品了,这也正常,通常6月7月都是手机厂商修整的时间,进入8月份之
  • iPhone卖不动了!苹果股价创年内最大日跌幅:市值一夜蒸发万亿元

    8月5日消息,今天凌晨美股三大指数高开低走集体收跌,道指跌0.41%;纳指跌0.36%;标普500指数跌0.52%。热门科技股也都变化极大,其中苹果报181.99美元,跌4.8%,创
  • 如何使用JavaScript创建一只图像放大镜?

    译者 | 布加迪审校 | 重楼如果您曾经浏览过购物网站,可能遇到过图像放大功能。它可以让您放大图像的特定区域,以便浏览。结合这个小小的重要功能可以大大改善您网站的用户体验
  • 三万字盘点 Spring 九大核心基础功能

    大家好,我是三友~~今天来跟大家聊一聊Spring的9大核心基础功能。话不多说,先上目录:图片友情提示,本文过长,建议收藏,嘿嘿嘿!一、资源管理资源管理是Spring的一个核心的基础功能,不
  • 为什么你不应该使用Div作为可点击元素

    按钮是为任何网络应用程序提供交互性的最常见方式。但我们经常倾向于使用其他HTML元素,如 div span 等作为 clickable 元素。但通过这样做,我们错过了许多内置浏览器的功能。
  • 网传小米汽车开始筛选交付中心 建筑面积不低于3000平方米

    7月7日消息,近日有微博网友@长三角行健者爆料称,据经销商集团反馈,小米汽车目前已经开始了交付中心的筛选工作,要求候选场地至少有120个车位,建筑不能低
  • 2纳米决战2025

    集微网报道 从三强争霸到四雄逐鹿,2nm的厮杀声已然隐约传来。无论是老牌劲旅台积电、三星,还是誓言重回先进制程领先地位的英特尔,甚至初成立不久的新
  • iQOO Neo8 Pro抢先上架:首发天玑9200+ 安卓性能之王

    经过了一段时间的密集爆料,昨日iQOO官方如期对外宣布:将于5月23日推出全新的iQOO Neo8系列新品,官方称这是一款拥有旗舰级性能调校的作品。随着发布时
Top