Skip to main content
POST
执行探索查询

限制说明

使用说明

  • 需要数据源原生结果形态时使用本接口;/monit/query/data 返回稳定的 query_result.v1 契约。本接口根据 data.result.kindframessampleslogs)分发结果。
  • execution.kind 决定可接受的配套字段:instant 只需 to_msrange 需要 from_msto_msmax_data_pointswindow 需要 from_msto_ms。不接受 step_seconds,步长由 max_data_pointsmin_step_seconds 推导。
  • args 用于宏替换(例如 Grafana 风格变量),取值均为字符串。
  • logs 结果最多返回 1,000 条,并通过 applied_limithas_more 说明截断情况。时序与采样结果各最多 1,000 条,成功响应整体上限 8 MiB。
  • WebAPI 跨实例转发与 Edge 执行合计可能耗时 35 秒,客户端超时建议至少 40 秒。

授权

app_key
string
query
必填

在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。

请求体

application/json

探索查询请求。四个顶层字段均为必填,未知字段会被拒绝。

datasource_id
integer<int64>
必填

数据源 ID,来自 /monit/datasource/list。必须是正数且不超过 JavaScript 安全整数范围,且属于当前账户。

必填范围: 1 <= x <= 9007199254740991
expr
string
必填

使用数据源原生语言的查询表达式(如 PromQL、LogsQL、SQL 等)。非空 UTF-8 字符串,最长 64 KiB;部分数据源类型限制更小。

Minimum string length: 1
args
object
必填

宏替换参数,按变量名索引,用于 Grafana 风格变量。键最长 256 字节,值最长 64 KiB,总预算 128 KiB。

execution
object
必填

查询的时间语义。可接受的配套字段取决于 kindinstant 只需 to_msfrom_ms 可选),range 需要 from_msto_msmax_data_pointswindow 需要 from_msto_ms。HTTP 接口不接受 step_seconds

响应

成功

成功响应结构。2xx 响应中 request_id 标识本次调用(同时出现在 Flashcat-Request-Id 响应头中),data 为接口业务 payload。失败响应使用不同结构,参见 ErrorResponse

request_id
string
必填

本次请求的唯一 ID,也会在 Flashcat-Request-Id 响应头中返回。反馈问题时请一并附上。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
必填

探索查询结果载荷。