统一数据源时序查询接口
POST
https://api.flashcat.cloud/api/n9e-plus/ds-query
最后修改时间：2026-06-09 03:24:46
cate + datasource_id 决定走哪个数据源，由 query 数组承载该数据源的查询配置。⚠️ 本接口不支持 Prometheus 数据源。Prometheus 类（含 VictoriaMetrics 等兼容数据源）的时序查询请使用 Prometheus 专用查询接口。
请求示例（按数据源 cate）
datasource_id替换为实际数据源 ID；from/to（ES 为start/end）为 Unix 秒级时间戳；query为数组，可一次传多个查询，结果按顺序拼接返回。日志类数据源通过keys（valueKey/labelKey/timeKey，多个用空格分隔）把日志聚合结果映射为时序。
Elasticsearch（cate=elasticsearch）
{
"cate": "elasticsearch",
"datasource_id": 1,
"query": [
{
"ref": "A",
"index_type": "index",
"index": "metrics-*",
"date_field": "@timestamp",
"interval": 60,
"start": 1748246400,
"end": 1748250000,
"value": {
"func": "avg",
"field": "response_time"
},
"group_by": [
{
"cate": "terms",
"field": "service.keyword",
"size": 10
}
],
"filter": "status:200"
}
]
}阿里云 SLS（cate=aliyun-sls）
{
"cate": "aliyun-sls",
"datasource_id": 1,
"query": [
{
"ref": "A",
"project": "my-project",
"logstore": "nginx-access",
"query": "* | select count(1) as cnt",
"from": 1748246400,
"to": 1748250000,
"power_sql": false,
"time_series": true,
"keys": {
"valueKey": "cnt",
"labelKey": "",
"timeKey": ""
}
}
]
}腾讯云 CLS（cate=tencent-cls）
{
"cate": "tencent-cls",
"datasource_id": 1,
"query": [
{
"ref": "A",
"topic_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"query": "status:200 | select count(*) as pv",
"from": 1748246400,
"to": 1748250000,
"time_series": true,
"keys": {
"valueKey": "pv",
"labelKey": "",
"timeKey": ""
}
}
]
}火山引擎 TLS（cate=volc-tls）
{
"cate": "volc-tls",
"datasource_id": 1,
"query": [
{
"ref": "A",
"topic_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"query": "* | select count(*) as cnt",
"from": 1748246400,
"to": 1748250000,
"keys": {
"valueKey": "cnt",
"labelKey": ""
}
}
]
}华为云 LTS（cate=huawei-lts）
{
"cate": "huawei-lts",
"datasource_id": 1,
"query": [
{
"ref": "A",
"group_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"stream_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"query": "select count(*) as cnt",
"from": 1748246400,
"to": 1748250000,
"keys": {
"valueKey": "cnt",
"labelKey": ""
}
}
]
}请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.flashcat.cloud/api/n9e-plus/ds-query' \
--header 'X-User-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"cate": "aliyun-sls",
"datasource_id": 1,
"query": [
{
"ref": "A",
"project": "my-project",
"logstore": "nginx-access",
"query": "* | select count(1) as cnt",
"from": 1748246400,
"to": 1748250000,
"power_sql": false,
"time_series": true,
"keys": {
"valueKey": "cnt",
"labelKey": "",
"timeKey": ""
}
}
]
}'响应示例响应示例
{
"err": "string",
"dat": [
{
"ref": "string",
"metric": {
"property1": "string",
"property2": "string"
},
"values": [
[
0
]
],
"query": "string"
}
]
}修改于 2026-06-09 03:24:46