跳转到主要内容
GET
查询 Prometheus 标签值列表

限制说明

使用说明

  • 通过 X-DSID 请求头传入目标数据源 ID。数据源必须属于当前账户且为 Prometheus 类型;可用 /monit/datasource/list 获取 ID。
  • 若数据源限制了可查询的团队,只有这些团队的成员、其管理团队以及账户所有者或管理员可以查询,其他人会收到 403。数据源 ID 不存在时返回 400。
  • 200 响应体是数据源原生的 Prometheus HTTP API 结构,不是统一的 { request_id, data } envelope。查询字符串参数会原样转发,因此 Prometheus 自身的 match[]、start、end 等参数都可使用。
  • 省略 X-DSID,或数据源所在集群中有任意 monit-edge 低于 v0.35.0 时,请求会由平台自有的 Prometheus 响应,而不是您的数据源。请携带该请求头并保持 monit-edge 为较新版本,才能获得数据源自身的取值。
  • 到达数据源之前发生的失败以 text/plain 返回,并携带对应的 4xx/5xx 状态码。数据源自身返回的 400 及以上状态码会连同其响应体一并透传。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求头

X-DSID
string

要查询的数据源 ID,十进制字符串。必须是当前账户下的 Prometheus 类型数据源。省略时由平台自有的 Prometheus 响应,而不是您的数据源。

路径参数

label_name
string
必填

要枚举取值的标签名,例如 job。

响应

数据源返回的原生 Prometheus 标签值响应。

所查询数据源返回的原生 Prometheus HTTP API 响应。本接口不会把结果包装进 Flashduty 统一响应 envelope。

status
enum<string>
必填

Prometheus 结果状态。success 携带 data,error 携带 errorType 与 error。

可用选项:
success,
error
data
string[]

标签值列表,status 为 success 时出现。

一个标签值。

errorType
string

Prometheus 错误类别,status 为 error 时出现。

error
string

Prometheus 错误信息,status 为 error 时出现。