Prometheus学习系列(十七)之模板参考

Prometheus支持在警报的注释和标签以及服务的控制台页面中进行模板化。 模板能够针对本地数据库运行查询,迭代数据,使用条件,格式化数据等.Prometheus模板语言基于Go模板系统。

一、数据结构题

处理时间序列数据的主要数据结构是样本,定义如下:

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

样本的度量标准名称在Labels映射中的特殊__name__标签中进行编码。

[]sample表示样本列表。

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

二、函数

除了Go模板提供的默认功能外,Prometheus还提供了更轻松处理模板中查询结果的功能。

如果在管道中使用函数,则管道值将作为最后一个参数传递。

2.1 查询
名字 参数 返回值 解析
query query string []sample 查询数据库,不支持返回范围向量。
first []sample sample 索引等于0
label label, sample string 相当于index sample.Labels标签
value sample float64 相当于 sample.Value
sortByLabel label, []samples []sample 按给定标签对样品进行排序。 是稳定排序。

firstlabelvalue旨在使查询结果易于在管道中使用。

2.2 数字
名字 参数 返回 解析
humanize number string 使用度量标准前缀将数字转换为更易读的格式。
humanize1024 number string humanize一样,但使用1024作为基础而不是1000。
humanizeDuration number string 将持续时间(以秒为单位)转换为更易读的格式。
humanizeTimestamp number string 将Unix时间戳以秒为单位转换为更易读的格式。

Humanizing功能旨在为人类消费产生合理的输出,并且不保证在Prometheus版本之间返回相同的结果。

2.3 字符串
名字 参数 返回 解析
title string string strings.Title, 大写每个单词的第一个字符。
toUpper string string strings.ToUpper, 将所有字符转换为大写。
toLower string string strings.ToLower, 将所有字符转换为小写。
match pattern, text boolean regexp.MatchString 测试未锚定的正则表达式匹配。
reReplaceAll pattern, replacement, text string Regexp.ReplaceAllString Regexp替换,未经修复。
graphLink expr string 返回表达式的表达式浏览器中图表视图的路径。
tableLink expr string 返回表达式的表达式浏览器中表格(“Console”)视图的路径。
2.4 其他
名字 参数 返回 解析
args []interface{} map[string]interface{} 这会将对象列表转换为具有键arg0arg1等的映射。这旨在允许将多个参数传递给模板。
tmpl string, []interface{} nothing 与内置模板一样,但允许非文字作为模板名称。 请注意,结果被认为是安全的,不会自动转义。 仅适用于游戏机。
safeHtml string string 将字符串标记为不需要自动转义的HTML。
三、模板类型的区别

每种类型的模板都提供可用于参数化模板的不同信息,并具有一些其他差异。

3.1 报警字段模板

.Value.Labels包含警报值和标签。 为方便起见,它们也作为$value$labels变量公开。

3.2 控制台模板

控制台暴露在/consoles/上,并且来自-web.console.templates标志指向的目录。

控制台模板使用html/template呈现,提供自动转义功能。 要绕过自动转义,请使用safe*功能。,

URL参数在.Params中以地图形式提供。 要使用相同的名称访问多个URL参数,.RawParams是每个参数的列表值的映射。 URL路径在.Path中可用,不包括/consoles/前缀。

控制台还可以访问在-web.console.libraries标志指向的目录中的* .lib文件中找到的{{define"templateName"}}...{{end}}定义的所有模板。 由于这是一个共享命名空间,请注意避免与其他用户发生冲突。 以prom_prom__开头的模板名称保留供Prometheus使用,上面列出的函数也是如此。

四、链接

Prometheus官网地址:https://prometheus.io/
我的Github:https://github.com/Alrights/prometheus

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 155,541评论 4 358
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 65,987评论 1 285
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 105,387评论 0 236
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,325评论 0 201
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,657评论 3 284
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,125评论 1 202
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,519评论 2 305
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,242评论 0 193
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 33,863评论 1 234
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,198评论 2 239
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,747评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,106评论 2 249
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,635评论 3 227
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,926评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,631评论 0 190
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,131评论 2 261
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,083评论 2 257

推荐阅读更多精彩内容