kube-state-metrics代码分析

前言

整体来看，kube-state-metrics是为prometheus采集k8s资源数据的exporter。prometheus 的exporter任务是将和业务相关的数据指标转换成prometheus的数据模型，当然prometheus 为这种转换提供了方法。

kube-state-metrics采集的数据

kube-state-metrics能够采集绝大多数k8s内置资源的相关数据，例如pod、deploy、service等等。同时它也提供自己的数据，主要是资源采集个数和采集发生的异常次数统计。

prometheus指标类别

• Counter (累加指标)

  一个累加指标数据，这个值随着时间只会逐渐的增加，比如程序完成的总任务数量，运行错误发生的总次数。常见的还有交换机中snmp采集的数据流量也属于该类型，代表了持续增加的数据包或者传输字节累加值。

• Gauge (测量指标)

  Gauge代表了采集的一个单一数据，这个数据可以增加也可以减少，比如CPU使用情况，内存使用量，硬盘当前的空间容量等等。

• Summary (概略图)

• Histogram (直方图)

prometheus为exporter提供的方法

定义指标

定义一个指标描述，第一个参数是指标的名字，第二个是指标的帮助信息，第三个是指标含有的label数组。

descDeploymentLabelsDefaultLabels = []string{"namespace", "deployment"}
descDeploymentCreated = prometheus.NewDesc(
		"kube_deployment_created",
		"Unix creation timestamp",
		descDeploymentLabelsDefaultLabels,
		nil,
	)

上面的代码是kube-state-metrics定义了一个名为kube_deployment_created指标描述。在prometheus中，这个指标的形式类似kube_deployment_created{“namesapces”=xxx, “deployment”=xxx, …}。

采集器

顾名思义，采集器就是采集数据，它是一个结构体，注册到prometheus注册器后，会被自动调用，从而实现采集功能。采集器要实现Describe和Collect方法。

type Collector interface {
    // 用于传递所有可能的指标的定义描述符
    // 可以在程序运行期间添加新的描述，收集新的指标信息
    // 重复的描述符将被忽略。两个不同的Collector不要设置相同的描述符
    Describe(chan<- *Desc)

    // Prometheus的注册器调用Collect执行实际的抓取参数的工作，