同组织 Trace 查询¶

POST /api/v1/df/same_org/trace/query

概述¶

按 traceId 查询当前工作空间或同组织指定工作空间 tracing 数据

Body 请求参数¶

参数名	类型	必选	说明
traceId	string	Y	链路 ID，最大长度 512 允许为空: False
workspaceUUIDs	array		可选，指定同组织工作空间 UUID 列表，单个 UUID 最大长度 128；不传或空数组按当前工作空间查询允许为空: True
startTime	integer		可选，查询开始时间，13 位毫秒时间戳允许为空: True
endTime	integer		可选，查询结束时间，13 位毫秒时间戳；不传时不自动补结束时间允许为空: True
source	string		可选，tracing source；不传时查询所有 source；仅支持具体 source 名或 *，最大长度 128 允许为空: True
whereClause	string		可选，附加 DQL where 条件片段，最大长度 4096，不包含外层花括号，服务端会做 parser 校验允许为空: True
limit	integer		可选，返回数量限制；不传时沿用 DQL 默认分页大小，显式传入时默认最大 1000，受站点配置控制允许为空: True
searchAfter	array		可选，分页标记，结构为 [time, token]，其中 time 必须落在本次查询时间窗口内，token 最大长度 512 允许为空: True
cursorTime	integer		可选，滚动分页分段查询阀值，必须落在本次查询时间窗口内允许为空: True
cursorToken	string		可选，分页查询 token，最大长度 512 允许为空: True

参数补充说明¶

本接口只用于 trace 查询，不支持通用 DQL q。

参数名	type	必选	说明
traceId	string	Y	链路 ID
workspaceUUIDs	array		同组织工作空间 UUID 列表；单个 UUID 最大长度 128；不传或空数组时查询当前工作空间
startTime	integer		查询开始时间；不传时默认最近 1 小时的开始时间
endTime	integer		查询结束时间；不传时内部 time_range 只包含开始时间
source	string		tracing source；不传时查询所有 source；仅支持具体 source 名或 `*`，最大长度 128
whereClause	string		附加 DQL where 条件片段，最大长度 4096，不包含外层花括号，服务端会做 parser 校验
limit	integer		返回数量限制；不传时沿用 DQL 默认分页大小，显式传入时默认最大 1000，受站点配置控制
searchAfter	array		分页标记，结构为 `[time, token]`，其中 `time` 必须落在本次查询时间窗口内，`token` 最大长度 512
cursorTime	integer		滚动分页分段查询阀值，必须落在本次查询时间窗口内
cursorToken	string		分页查询 token，最大长度 512

OpenAPI 参数保持小驼峰；不支持 selectClause 和 offset。

响应¶

{
    "code": 200,
    "content": {
        "data": [
            {
                "series": [
                    {
                        "columns": [
                            "trace_id",
                            "service"
                        ],
                        "values": [
                            [
                                "TRACE-XXXX",
                                "api"
                            ]
                        ]
                    }
                ]
            }
        ]
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-XXXX"
}