文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 观测/ 调用链管理/ 查询trace列表 - ListOpsTrace
更新时间：2026-05-07 GMT+08:00
查看PDF
分享

查询trace列表 - ListOpsTrace

功能介绍

该接口用于分页查询调用链列表。

URI

POST /v1/ops/observation/traces

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释：

消息体编码格式。用于告知服务端请求体（Body）所采用的主体数据类型，以便服务端正确解析。

约束限制：

不涉及

取值范围：

application/json

默认取值：

application/json

Authorization

是

String

参数解释：

签名认证信息，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

X-Sdk-Date

是

String

参数解释：

请求发送的时间，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表2 请求Body参数

参数

是否必选

参数类型

描述

start_time

否

Long

参数解释：

开始时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

end_time

否

Long

参数解释：

截止时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

resource_id

否

String

参数解释：

资源ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

resource_type

否

String

参数解释：

资源类型。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

trace_id

否

String

参数解释：

调用链ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

status_code

否

String

参数解释：

状态码。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

session_id

否

String

参数解释：

会话ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

span_type

否

String

参数解释：

Span消耗。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

input

否

String

参数解释：

输入。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

output

否

String

参数解释：

输出。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

like

否

Integer

参数解释：

评价。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

label

否

Map<String,String>

参数解释：

标注的过滤条件。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

page_no

否

Integer

参数解释：

页码。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

page_size

否

Integer

参数解释：

每页条数。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

filter_sign

否

String

参数解释：

连接标识。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

label_filter

否

Array of FilterParam objects

参数解释：

标签过滤条件。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

filter

否

Array of ListFilterParam objects

参数解释：

过滤条件。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 FilterParam

参数

是否必选

参数类型

描述

label_name

否

String

参数解释：

标签名。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

label_value

否

String

参数解释：

标签值。

约束限制：

长度限制1-128位。

取值范围：

不涉及。

默认取值：

不涉及。

operator

否

String

参数解释：

操作类型。

约束限制：

不涉及。

取值范围：

  • equal：等于。

  • like：包含。

  • not_like：不包含。

  • empty：为空。

  • not_empty：不为空。

  • greater_than：大于。

  • less_than：小于。

  • in：属于。

  • not_in：不属于。

默认取值：

不涉及。
表4 ListFilterParam

参数

是否必选

参数类型

描述

name

否

String

参数解释：

过滤名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

value

否

String

参数解释：

过滤值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

operator

否

String

参数解释：

操作类型。

约束限制：

不涉及。

取值范围：

  • equal：等于。

  • like：包含。

  • not_like：不包含。

  • empty：为空。

  • not_empty：不为空。

  • greater_than：大于。

  • less_than：小于。

  • in：属于。

  • not_in：不属于。

默认取值：

不涉及。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

total

Integer

参数解释：

总数。

取值范围：

不涉及。

span_list

Array of SpanInfo objects

span列表
表6 SpanInfo

参数

参数类型

描述

trace_id

String

参数解释：

调用链ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

parent_span_id

String

参数解释：

父节点SpanID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

span_id

String

参数解释：

SpanID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

span_type

String

参数解释：

Span消耗。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

span_name

String

参数解释：

Span名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

status_code

String

参数解释：

状态码。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

input

String

参数解释：

输入。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

output

String

参数解释：

输出。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

duration

Integer

参数解释：

耗时。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

session_id

String

参数解释：

会话ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

tokens

Integer

参数解释：

Tokens消耗。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

input_tokens

Integer

参数解释：

Input Tokens消耗。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

output_tokens

Integer

参数解释：

Output Tokens消耗。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

start_time

Long

参数解释：

开始时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

call_type

String

参数解释：

触发类型。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

metadata

String

参数解释：

元数据。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

feedback_operation

String

参数解释：

评价状态。

约束限制：

不涉及。

取值范围：

  • like：点赞。

  • unlike：点踩。

  • cancel：取消评价。

默认取值：

不涉及。

label

Array of Label objects

参数解释：

标签组。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

resource_id

String

参数解释：

应用ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

resource_name

String

参数解释：

应用名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

resource_type

String

参数解释：

应用类型。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

model_name

String

参数解释：

模型名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

is_error

Boolean

参数解释：

是否失败。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表7 Label

参数

参数类型

描述

trace_id

String

参数解释：

调用链ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

span_id

String

参数解释：

SpanID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

start

Long

参数解释：

开始时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

last_update_time

Long

参数解释：

更新时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

label

String

参数解释：

标签名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

string_value

String

参数解释：

标签值。

约束限制：

不涉及。

取值范围：

String类型。

默认取值：

不涉及。

float_value

String

参数解释：

标签值。

约束限制：

不涉及。

取值范围：

Float类型。

默认取值：

不涉及。

请求示例

POST https://*.com/v1/ops/observation/traces

Content-Type:application/json
X-Sdk-Date:20240416T095341Z
Authorization:SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************
{
  "page_no": like,
  "page_size": 018e8d4f16496b9a,
  "start_time": 1773279366881,
  "end_time": 1775871366881,
  "span_type": root,
}

响应示例

状态码：200

查询成功。

{
  "span_list" : [ {
    "trace_id" : "94c7408e75f61939f1deb09b58a1baf1,",
    "parent_span_id" : "null,",
    "span_id" : "7176c7f41140760d,",
    "span_type" : "workflow,",
    "span_name" : "UserInput,",
    "status_code" : "STATUS_CODE_OK,",
    "input" : "10000000000美元可以兑换黄金,",
    "output" : "10000000000美元可以兑换黄金,",
    "duration" : "5,",
    "session_id" : "test111,",
    "tokens" : "0,",
    "input_tokens" : "0,",
    "output_tokens" : "0,",
    "start_time" : "1775271188055,",
    "call_type" : "debug,",
    "metadata" : "null,",
    "feedback_operation" : "null,",
    "label" : "-,",
    "resource_id" : "b0fd244b-c5c8-4ef7-97b6-645a1b03edc6,",
    "resource_name" : "测试,",
    "resource_type" : "workflow,",
    "model_name" : "null,",
    "is_error" : false
  } ],
  "total" : "5,"
}

状态码

状态码

描述

200

查询成功。

错误码

请参见错误码。

父主题： 调用链管理

相关文档