Prometheus API
  1. 表达式查询
Prometheus API
  • 介绍
  • 表达式查询
    • 瞬时查询
      GET
    • 范围查询
      GET
  • 元数据
    • 目标targets
      • 查询目标列表
      • 查询目标元数据
    • 时间序列series
      • 查找时间序列列表
    • 指标metric
      • 查询指标metric元数据
    • 标签label
      • 获取标签名称列表
      • 查询标签值列表
    • 规则rules
      • 查询规则列表
    • 告警alerts
      • 查询告警列表
      • 查询告警管理器状态
  • 状态Status
    • 查询配置文件
      GET
    • 查询运行时信息
      GET
    • 构建信息
      GET
    • 查询标志位flag
      GET
    • TSDB 状态
      GET
    • wal replay统计
      GET
  • 时序数据库 (TSDB)操作
    • TSDB管理api说明
    • 创建数据快照
      POST
    • 删除时间序列series
      POST
    • Clean Tombstones
      POST
  1. 表达式查询

瞬时查询

GET
/api/v1/query
在单个时间点评估即时查询:

请求参数

Query 参数
query
string 
必需
Prometheus 表达式查询字符串。
示例值:
up
time
string 
可选

<rfc3339 | unix_timestamp>: 评估时间戳。
如果省略该参数,则使用当前服务器时间。

示例值:
2015-07-01T20:10:51.781Z
timeout
string 
可选

评估的超时时间

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://localhost:9090/api/v1/query?query=up&time=2015-07-01T20:10:51.781Z&timeout='

返回响应

🟢200成功
application/json
Body
status
string 
必需
"success" | "error"
data
object 
必需
仅在 status 为 "error" 时设置。data 字段可能仍包含其他数据。
resultType
string 
查询结果格式
必需
"matrix" | "vector" | "scalar" | "string",
result
array[string]
查询结果数据
必需
查询结果数据,其格式取决于resultType
示例
{
  "status": "string",
  "data": {
    "resultType": "string",
    "result": [
      "string"
    ]
  }
}
上一页
介绍
下一页
范围查询
Built with