特点：Data can be increased or decreased（Reflect the current state）.

1. 不带lab的Gauge

1.1 定义指标

语法

• 实例化

func NewGauge(opts GaugeOpts) Gauge

• GaugeOpts

type GaugeOpts Opts

• 结构体Opts

type Opts struct {
    
    Namespace   string
    Subsystem   string
    Name        string
    Help        string
    ConstLabels Labels
}

完整示例

• 写一段简单的exporter如下：

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 (
	numOfBuns = prometheus.NewGauge(prometheus.GaugeOpts{
    
		Namespace: "xi_shu",
		Subsystem: "jing_zhou_team",
		Name:      "guanyu_eaten_num",
		Help:      "Number of steamed buns eaten by Guan Yu",
	})
)

func init() {
    
	prometheus.MustRegister(numOfBuns)
}

func main() {
    
	flag.Parse()
	http.Handle("/metrics", promhttp.Handler())
	log.Fatal(http.ListenAndServe(*addr, nil))
}

• 结果如下
  我们访问http://127.0.0.1:1840/metrics页面,The following paragraph can be found

# HELP xi_shu_jing_zhou_team_guanyu_eaten_num Number of steamed buns eaten by Guan Yu
# TYPE xi_shu_jing_zhou_team_guanyu_eaten_num gauge
xi_shu_jing_zhou_team_guanyu_eaten_num 0

如上可知,我们的指标是用Opts结构体的实例化拼接出来的.

1.2 Get a value for the indicator

语法

• add() 增加n

func (Gauge) Add(float64)

• sub() 减去n

func (Gauge) Sub(float64)

• Inc() 增加1

func (Gauge) Inc()

• dec() 减少1

func (Gauge) Dec()

• set() 重新设置

func (Gauge) Set(float64)

• The set value is the current time timestamp

func (Gauge) SetToCurrentTime()

完整示例

• 代码

package main

import (
	"flag"
	"github.com/prometheus/client_golang/prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"log"
	"net/http"
	"time"
)
var addr = flag.String("listen-address", ":1840", "The address to listen on for HTTP requests")

var (
	numOfBuns = prometheus.NewGauge(prometheus.GaugeOpts{
    
		Namespace: "xi_shu",
		Subsystem: "jing_zhou_team",
		Name:      "guanyu_eaten_num",
		Help:      "Number of steamed buns eaten by Guan Yu",
	})
)

func init() {
    
	prometheus.MustRegister(numOfBuns)
}

func main() {
    
	flag.Parse()
	go func() {
    
		for true {
    
			numOfBuns.Add(2)
			time.Sleep(time.Second)
		}
	}()
	http.Handle("/metrics", promhttp.Handler())
	log.Fatal(http.ListenAndServe(*addr, nil))
}

• 结果

We keep refreshing visible,The steamed bread that Guan Yu eats every second+2

# HELP xi_shu_jing_zhou_team_guanyu_eaten_num Number of steamed buns eaten by Guan Yu
# TYPE xi_shu_jing_zhou_team_guanyu_eaten_num gauge
xi_shu_jing_zhou_team_guanyu_eaten_num 24

2. 带lab的Gauge

2.1 定义指标

语法

• 实例化

func NewGaugeVec(opts GaugeOpts, labelNames []string) *GaugeVec

• GaugeOpts 见上例

完整示例

package main

import (
	"flag"
	"github.com/prometheus/client_golang/prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"log"
	"net/http"
	"time"
)

//自定义端口
var addr = flag.String("listen-address", ":1840", "The address to listen on for HTTP requests")

var (
	numOfBuns = prometheus.NewGaugeVec(prometheus.GaugeOpts{
    
		Namespace: "xi_shu",
		Subsystem: "jing_zhou_team",
		Name:      "eaten_num",
		Help:      "Number of steamed buns eaten by Guan Yu",
	},[]string{
    "name","age"})
)

func init() {
    
	prometheus.MustRegister(numOfBuns)
}

func main() {
    
	flag.Parse()
	http.Handle("/metrics", promhttp.Handler())
	log.Fatal(http.ListenAndServe(*addr, nil))
}

• 结果显示
  有lab的CounterNo assignment is invisible（The above example shows that,没有tag的CounterThe mode value is0.）

2.2 取值

语法

• 添加lab
  实例化之后,The instance needs to be marked firstlab,因为不同的labwill be displayed as a single data.

func (v *GaugeVec) WithLabelValues(lvs ...string) Gauge

• 取值

见前文,同“不带lab的Gauge”

完整示例

• 代码如下

package main

import (
	"flag"
	"github.com/prometheus/client_golang/prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"log"
	"net/http"
	"time"
)

//自定义端口
var addr = flag.String("listen-address", ":1840", "The address to listen on for HTTP requests")

var (
	numOfBuns = prometheus.NewGaugeVec(prometheus.GaugeOpts{
    
		Namespace: "xi_shu",
		Subsystem: "jing_zhou_team",
		Name:      "eaten_num",
		Help:      "Number of steamed buns eaten by Guan Yu",
	},[]string{
    "name","age"})
)

func init() {
    
	prometheus.MustRegister(numOfBuns)
}

func main() {
    
	flag.Parse()
	go func() {
    
		for true {
    
			numOfBuns.WithLabelValues("guan_yu","25").Add(2)
			time.Sleep(time.Second)
		}
	}()
	go func() {
    
		for true {
    
			numOfBuns.WithLabelValues("zhang_fei","22").Add(3)
			time.Sleep(time.Second)
		}
	}()
	http.Handle("/metrics", promhttp.Handler())
	log.Fatal(http.ListenAndServe(*addr, nil))
}

• 结果

# HELP xi_shu_jing_zhou_team_eaten_num Number of steamed buns eaten by Guan Yu
# TYPE xi_shu_jing_zhou_team_eaten_num gauge
xi_shu_jing_zhou_team_eaten_num{
    age="22",name="zhang_fei"} 21
xi_shu_jing_zhou_team_eaten_num{
    age="25",name="guan_yu"} 14