【Prometheus】查询数据接口

最新推荐文章于 2024-04-30 17:15:06 发布

VIP文章小企鹅么么

最新推荐文章于 2024-04-30 17:15:06 发布

阅读量935

点赞数 11

文章标签： prometheus 网络云原生

本文链接：https://blog.csdn.net/sjy8207380/article/details/136991706

版权

文章目录

1. 前言
2. API接口文档

1. 前言

以下是介绍调用Prometheus的API获取数据的方法

1.1. API终端

IP:PORT(prometheus一般在内网暴露9090端口，对外网暴露8395端口)

1.2. API状态码说明

2xx: 调用成功
404 Bad Request ：参数错误或者缺失。
422 Unprocessable Entity : 表达式无法执行。
503 Service Unavailable : 请求超时或者被中断

1.3. API请求返回的格式均使用以下的 JSON 格式

{
   
  "status": "success" | "error",
  "data": <data>,
 
  // 当有错误的时候才有以下返回字段
  "errorType": "<string>",
  "error": "<string>"
}

2. API接口文档

2.1. 查询时间点结果

2.1.1. 请求类型

GET/POST

2.1.2. URL

/api/v1/query

2.1.3. 请求参数

参数名称	类型	是否必须	实例	备注
query	string	是	base_user_count{project=“测试22”, organization=“test123”}	PromQL表达式，需要url encode
time	rfc3339或unix_timestamp	否	1646382531	时间戳，精确到秒。如果不填写则用系统当前时间。
timeout	duration	否	5m	请求Prometheus的超时时间，一般不用填写。

2.1.4. 返回

{
   
    "status": "success",
    "data": {
   
        "resultType": "vector",   //返回字段参考：响应数据格式
        "result": [
            {
   
                "metric": {
   },  //指标的label，可以理解为索引，可以根据以下字段进行具体查询
                "value": []    //返回结果  时间戳（与传入的时间对应）+具体值
            }
        ]
    }
}