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

查询调用链详细信息 - ShowOpsTrace

功能介绍

该接口用于查询调用链详细信息。

URI

GET /v1/ops/observation/traces/{trace_id}

表1 路径参数

参数

是否必选

参数类型

描述

trace_id

是

String

参数解释：

调用链ID。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

application/json

默认取值：

application/json

Authorization

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

X-Sdk-Date

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

total

Integer

参数解释：

总数。

取值范围：

不涉及。

span_list

Array of SpanInfo objects

span列表
表4 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

参数解释：

是否失败。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表5 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类型。

默认取值：

不涉及。

请求示例

GET https://*.com/v1/ops/observation/traces/5af65999f08e136b0963253064a2f693

Content-Type:application/json
X-Sdk-Date:20240416T095341Z
Authorization:SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************

响应示例

状态码：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

查询成功。

错误码

请参见错误码。

父主题： 调用链管理

相关文档