一、安装prometheus-client-c库
需要安装prom、promhttp两个库,其中promhttp依赖microhttd库; 安装包下载路径:
链接:https://www.ecpan.cn/web/#/yunpanProxy?path=%2F%23%2Fdrive%2Foutside&data=fb07a83cb8d5fe8e7e4ce36730bb5488Wlq3edsza2&isShare=1
提取码:BJZLBD
安装命令:
dpkg -i libprom-dev-0.1.3-Linux.debapt
install libmicrohttpd-dev
# 若出错
apt --fix-broken install
dpkg -i libpromhttp-dev-0.1.3-Linux.deb
二、参数说明
新增两个GUC参数:
he3db_prom_enable
表示是否开启采集指标,取值true(开启)|false(关闭),默认true
he3db_prometheus_port
metrics指标端口,取值1-65535
三、集成说明
因prometheus-client-c库申请内存资源为进程私有,不支持使用共享内存, 所以多进程无法直接使用一个客户端,He3DB在集成时使用单独子进程注册采集器、开启metrics http服务,并采用共享队列的方式实现多进程使用同一个客户端,具体如下::
(1)首先为队列申请共享内存,并初始化队列值,队列主要用于暂存采集的指标值, 目前定义了double类型的队列,如要新增其他数据类型的指标采集,则需要再次申请共享内存并新建一个共享队列; (详见代码prometheusclient.c: He3dbPrometheusClientSize、He3dbPrometheusClientInit)
(2)初始化prometheus采集器并注册需要采集的metric, 如新增一个指标需要再注册一个metric;prometheus-client-c库支持三种类型指标的采集: counter、gauge、 histogram,建议除histogram类型指标外, 其他采用扩展pg_exporter的方式收集指标(可参考pr add view、testcase); (详见代码 prometheusclient.c:init)
(3)在指标生产的代码中调用入队方法,将指标推送到共享队列(注意添加he3db_prom_enable的判断,true时再推送指标), 并在PrometheusClientMain的循环中添加消费队列的方法,消费队列值插入metric采集器中。(详见代码prometheusclient.c:PrometheusClientMain)