Prometheus模板参考

完整译文请访问：http://www.coderdocument.com/docs/prometheus/v2.14/prometheus/configuration/template_reference.html。

Prometheus支持模板化告警的注解和标签以及服务控制台页面。模板能够对本地数据库运行查询、遍历数据、使用条件、格式化数据等等。Prometheus模板语言基于Go模板系统。

数据结构

处理时间序列数据的主要数据结构是采样，定义如下：

type sample struct {
        Labels map[string]string
        Value  float64
}

采样的指标名称编码在标签map中的一个特殊的 __name__ 标签中。

[]sample 指的是采样列表。

interface{} 在Go中类似于C语言中的void指针。

函数

除了Go模板提供的默认函数之外，Prometheus还提供了一些函数，可以更轻松地处理模板中的查询结果。

如果函数在管道中使用，则管道的值作为最后一个参数进行传递。

查询

名称	参数	返回值	说明
query	query string	[]sample	查询数据库，不支持返回范围向量。
first	[]sample	sample	等价于 index a 0
label	label, sample	string	等价于 index sample.Labels label
value	sample	float64	等价于 sample.Value
sortByLabel	label, []samples	[]sample	根据给定的标签对采样进行分类。该函数是稳定的。

first，label和value使查询结果在管道中更易于使用。

完整译文请访问：http://www.coderdocument.com/docs/prometheus/v2.14/prometheus/configuration/template_reference.html。