查询 LLM trace 列表
更新时间：2026-06-26
DescribeLLMTraces
查询LLM Trace列表，支持按时间范围、过滤条件和排序方式获取Trace数据，支持分页。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v1/apm/query?action=DescribeLLMTraces HTTP/1.1
2Host: apm.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "beginDatetime": "20241011T10:10:10Z",
7 "endDatetime": "20241011T10:25:10Z",
8 "filters": [
9 {
10 "key": "userId",
11 "op": "=",
12 "value": "user-82a8863fa52c2"
13 }
14 ],
15 "orderBy": "startTime",
16 "order": "desc",
17 "pageNo": 1,
18 "pageSize": 10
19}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为v1 |
| beginDatetime | String | 是 | RequestBody参数 | 开始时间，UTC时间 |
| endDatetime | String | 是 | RequestBody参数 | 结束时间，UTC时间 |
| filters | List<Filter> | 否 | RequestBody参数 | 过滤项列表。支持的过滤字段：service(应用名称)、traceId(TraceID)、sessionId(会话ID)、userId(用户ID)、duration(响应时间，单位ms)、inputTokens(输入token数)、outputTokens(输出token数)、totalTokens(总token数) |
| orderBy | String | 否 | RequestBody参数 | 排序字段，默认值：startTime，可选项：startTime(开始时间)、duration(持续时间)、totalTokens(总token数) |
| order | String | 否 | RequestBody参数 | 排序方向，可选值：asc(升序)、desc(降序) |
| pageNo | Integer | 是 | RequestBody参数 | 第几页，从1开始计数 |
| pageSize | Integer | 是 | RequestBody参数 | 每页展示数量，最大值：100 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 状态码 |
| message | String | 错误信息 |
| traces | List<LLMTraceItem> | Trace列表 |
请求示例
Plain Text
1POST /v1/apm/query?action=DescribeLLMTraces HTTP/1.1
2HOST apm.bj.baidubce.com
3Authorization bce-auth-v1/...
4
5{
6 "beginDatetime": "20241011T10:10:10Z",
7 "endDatetime": "20241011T10:25:10Z",
8 "filters": [
9 {
10 "key": "userId",
11 "op": "=",
12 "value": "user-82a8863fa52c2"
13 }
14 ],
15 "orderBy": "startTime",
16 "order": "desc",
17 "pageNo": 1,
18 "pageSize": 10
19}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: request-id-example
3Date: Wed, 08 Jan 2025 03:25:48 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "success": true,
10 "code": "OK",
11 "message": "",
12 "traces": [
13 {
14 "traceId": "255e69731af9f35845d453d0c321e42e",
15 "startTime": "20241011T10:10:10Z",
16 "endTime": "20241011T10:15:13Z",
17 "service": "demo",
18 "sessionId": "sess-f35fc20d04eb9b6bf0",
19 "userId": "user-82a8863fa52c2",
20 "inputTokens": 4100,
21 "outputTokens": 113,
22 "totalTokens": 4213,
23 "input": "how can I use ...",
24 "output": "you can ...",
25 "models": ["deepseek-v3.2", "chatgpt-5"],
26 "tools": ["baidu-search", "git-commit"]
27 }
28 ]
29}评价此篇文章