---
title: "query promql monitor check by ts"
method: POST
path: "/check/query/ts/promql"
---

# query promql monitor check by ts

`POST /check/query/ts/promql`

## Headers

- `traceparent` string
- `X-Bk-Scope-Space-Uid` string
- `X-Bk-Scope-Skip-Space` string

## Request body

- StructuredQueryPromQL
  - `add_dimensions` string[] — AddDimensions 额外添加的聚合维度，会与每个 function.dimensions 合并
  - `bk_biz_ids` string[]
  - `down_sample_range` string — DownSampleRange 降采样：大于Step才能生效，可以为空
  - `end` string
  - `instant` boolean — 瞬时数据
  - `is_verify_dimensions` boolean
  - `limit` integer
  - `look_back_delta` string — LookBackDelta 偏移量
  - `match` string
  - `max_source_resolution` string
  - `not_align_influxdb` boolean — 不与influxdb对齐
  - `not_time_align` boolean
  - `promql` string
  - `reference` boolean
  - `slimit` integer
  - `start` string
  - `step` string
  - `timezone` string — Timezone 时区

## Response `200`

OK

- HttpCheckQueryTsDataResponse
  - `data` unknown[] — Data 每项为子查询对应 tsdb.Instance.GetRequestBody(ctx) 的序列化结果。直查 VM 常为单元素 VmQueryCheckBody：metricql 由 vmCheckMetricql 生成后经 metadata.SetCheckPreviewMetricQL 写入，VM 实例在 GetRequestBody 中与 GetExpand 一并读出。非直查若某存储无预览体则该项不出现在 data 中。 Data 可为空：当仅有路由预览（RouteInfo 非空）且各存储未实现 GetRequestBody 预览体时，不调真实 TSDB 仍返回 200。
    - unknown
  - `route_info` MetadataRouteInfo[] — RouteInfo 与 ToQueryReference 展开后的每条子查询一一对应，用于路由排障（如 table_id、db 是否为空）。与 data 是否为空无关。
    - `data_label` string
    - `data_source` string
    - `db` string
    - `measurement` string
    - `metric_name` string
    - `reference_name` string
    - `storage_id` string
    - `storage_type` string
    - `table_id` string
  - `trace_id` string — TraceID 链路 ID（与 trace span 一致）。

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/tencentblueking/apis/bk-unify-query.md) · [All operations](https://skmtc.net/tencentblueking/apis/bk-unify-query/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tencentblueking/bk-unify-query/revisions/1c1ea4b46f93/schema)