02-Counter（计数器）

合集 - 【SDK卷】-----------------------------(24)

1.strings包2022-07-302.envconfig包（读取环境变量）2022-05-123.gocron包（定时任务）2023-01-044.go-redis包2023-03-145.net/http包实战2022-05-026.net/http包Client的使用2022-05-107.01-判断正则匹配、判断正则合法性2022-06-188.02-查找正则匹配字串、查找正则匹配字串的位置2022-06-199.03-查找匹配字串，查找匹配字串位置，正则分组2022-06-2010.04-使用正则替换2022-06-2211.06-其他用法2022-06-2512.01-注释、作用域、空格和空行、管道2022-08-2913.02-变量、if语句、迭代、内置函数2022-08-3114.01-入门示例、工作簿、文件Writer2022-09-0415.02-工作表操作2022-09-0816.03-行和列操作2022-09-1317.04-迭代器2022-09-1618.05-单元格操作2022-09-2719.06-样式设置2022-09-2920.07-流式写入2022-10-2121.01-Gauge（仪表盘）2022-08-08

22.02-Counter（计数器）2022-08-09

23.03-HIstogram（直方图）2022-08-2224.04-Summary（摘要）2022-08-21

收起

@

目录

• 概述
• 1. 不带标签的Counter
  • 1.1 定义指标
    • 语法
    • 完整示例
  • 1.2 获取数据
    • 语法
    • 完整示例
• 2. 带标签的Counter
  • 2.1 定义指标
    • 语法
    • 完整示例
  • 2.2 获取数据
    • 语法
    • 完整示例

概述

• 特点：只增不减（除非系统发生重启，或者用户进程有异常）。

常见的监控指标如http_requests_total, node_cpu都是Counter类型的监控指标。

• 标记：一般以_total作为后缀。

1. 不带标签的Counter

1.1 定义指标

语法

• 实例化

func NewCounter(opts CounterOpts) Counter

• CounterOpts类型

type CounterOpts Opts

• Opts结构体

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

完整示例

• 代码

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.NewCounter(prometheus.CounterOpts{
		Namespace: "xi_shu",
		Subsystem: "jing_zhou_team",
		Name:      "guanyu_eaten_num_all",
		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))
}
 

• 结果显示

# 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 counter
xi_shu_jing_zhou_team_guanyu_eaten_num_all 0

1.2 获取数据

语法

• Add() 增加N

func (Counter) Add(float64)

• Inc() 增加1

func (Counter) Inc()

完整示例

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.NewCounter(prometheus.CounterOpts{
		Namespace: "xi_shu",
		Subsystem: "jing_zhou_team",
		Name:      "guanyu_eaten_num_all",
		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))
}

• 结果显示

# HELP xi_shu_jing_zhou_team_guanyu_eaten_num_all Number of steamed buns eaten by Guan Yu
# TYPE xi_shu_jing_zhou_team_guanyu_eaten_num_all counter
xi_shu_jing_zhou_team_guanyu_eaten_num_all 74

2. 带标签的Counter

2.1 定义指标

语法

• 实例化

func NewCounterVec(opts CounterOpts, labelNames []string) *CounterVec

• CounterOpts类型

type CounterOpts Opts

• Opts结构体

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

完整示例

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.NewCounterVec(prometheus.CounterOpts{
		Namespace: "xi_shu",
		Subsystem: "jing_zhou_team",
		Name:      "eaten_num_all",
		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))
}

• 输出
  带标签的指标，没有打标签之前，不会显示。

2.2 获取数据

语法

• Add() 增加N

func (Counter) Add(float64)

• Inc() 增加1

func (Counter) Inc()

完整示例

• 代码

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.NewCounterVec(prometheus.CounterOpts{
		Namespace: "xi_shu",
		Subsystem: "jing_zhou_team",
		Name:      "eaten_num_all",
		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)
			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"} 33
xi_shu_jing_zhou_team_eaten_num{age="25",name="guan_yu"} 22

---