# 指标推送器:Pushgateway_Client
这是一个Python使用的PyPi模块,模块名为
pushgateway_client
,因为使用Python开发时,使用官方提供的客户端不支持为自定义指标添加多标签,因此便开发了该模块,希望能对有需要的小伙伴提供帮助。如果有相关问题或反馈,可以加作者微信一起讨论沟通(微信号:SPE3SRU3STAY)
- PyPi模块地址:https://pypi.org/project/pushgateway-client (opens new window)
- Github地址:https://github.com/tay3223/pushgateway_client (opens new window)
# 安装模块
pip install pushgateway-client
如果国内下载较慢可以临时加速一下
# pypi官网(原版拉取)
pip install pushgateway-client --upgrade -i https://pypi.org/project
# 阿里云源(加速拉取)
pip install pushgateway-client --upgrade -i http://mirrors.aliyun.com/pypi/simple
# 清华大学源(加速拉取)
pip install pushgateway-client --upgrade -i https://pypi.tuna.tsinghua.edu.cn/simple
# 使用说明
from pushgateway_client import client # 导入该模块
result = client.push_data(
url="127.0.0.1:9091", # 连接地址:此处只需要填写Pushgateway的IP地址+端口就行了,不用写http协议头,暂时只支持http连接
metric_name="my_metric_name", # 指标名称:此处指的就是Prometheus中的指标名(至于如何让Pushgateway中的指标投送到Prometheus中,请参阅官方文档)
metric_value="123", # 指标的值:受官网当前版本的限制,目前只支持数字做为值
job_name="demo", # Job名字:Prometheus会为所有的指标都追加一个job标签,在Prometheus这个job只是一个标签,但是在Pushgateway中这个job就是一个唯一标识符
labels={ # 标签可以自己随意设定,支持多标签;需要注意的是:<instance>标签如果不明确的指定的话,本模块会自动获取<您的主机名>来成为<instance>标签的值
"aaa": "111",
"bbb": "222",
"ccc": "333",
})
print(result) # 返回值是一个布尔类型,便于您进行后续的集成开发
print(type(result))