Skip to content

Same Organization Trace Query¶

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

Overview¶

Query tracing data of the current workspace or specified workspaces within the same organization by traceId.

Body Request Parameters¶

Parameter Name	Type	Required	Description
traceId	string	Y	Trace ID, maximum length 512 Allow empty: False
workspaceUUIDs	array		Optional, list of UUIDs of workspaces within the same organization, maximum length 128 for a single UUID; if not provided or an empty array, query the current workspace. Allow empty: True
startTime	integer		Optional, query start time, 13-digit millisecond timestamp. Allow empty: True
endTime	integer		Optional, query end time, 13-digit millisecond timestamp; if not provided, the end time will not be automatically filled. Allow empty: True
source	string		Optional, tracing source; if not provided, query all sources; only supports specific source names or *, maximum length 128. Allow empty: True
whereClause	string		Optional, additional DQL where condition fragment, maximum length 4096, does not include outer curly braces, server-side parser validation will be performed. Allow empty: True
limit	integer		Optional, limit on the number of results returned; if not provided, follows the DQL default pagination size; when explicitly provided, the default maximum is 1000, controlled by site configuration. Allow empty: True
searchAfter	array		Optional, pagination marker, structure is [time, token], where time must fall within the current query time window, token maximum length 512. Allow empty: True
cursorTime	integer		Optional, threshold for scroll pagination segmented queries, must fall within the current query time window. Allow empty: True
cursorToken	string		Optional, pagination query token, maximum length 512. Allow empty: True

Parameter Supplementary Description¶

This interface is only used for trace queries and does not support generic DQL q.

Parameter Name	type	Required	Description
traceId	string	Y	Trace ID
workspaceUUIDs	array		List of UUIDs of workspaces within the same organization; maximum length 128 for a single UUID; if not provided or an empty array, query the current workspace.
startTime	integer		Query start time; if not provided, defaults to the start time of the last 1 hour.
endTime	integer		Query end time; if not provided, the internal time_range only includes the start time.
source	string		Tracing source; if not provided, query all sources; only supports specific source names or `*`, maximum length 128.
whereClause	string		Additional DQL where condition fragment, maximum length 4096, does not include outer curly braces, server-side parser validation will be performed.
limit	integer		Limit on the number of results returned; if not provided, follows the DQL default pagination size; when explicitly provided, the default maximum is 1000, controlled by site configuration.
searchAfter	array		Pagination marker, structure is `[time, token]`, where `time` must fall within the current query time window, `token` maximum length 512.
cursorTime	integer		Threshold for scroll pagination segmented queries, must fall within the current query time window.
cursorToken	string		Pagination query token, maximum length 512.

OpenAPI parameters remain in camelCase; selectClause and offset are not supported.

Response¶

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