j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ 观测/ / 查询调用链详细信息 - showopstrace
更新时间：2026-07-10 gmt 08:00
查看pdf

查询调用链详细信息 -j9九游会登录

功能介绍

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

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts::showopstrace

read

-

-

-
  • apm:apm2traceevents:get
  • apm:apm2service:get
  • agentarts:studiomodelprovider:liststudiomodels

uri

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

表1 路径参数

参数

是否必选

参数类型

描述

trace_id

是

string

参数解释：

调用链id。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表2 响应body参数

参数

参数类型

描述

total

integer

参数解释：

总数。

取值范围：

不涉及。

span_list

array of spaninfo objects

参数解释：

span列表，包含查询到的所有span数据。

取值范围：

数组中的每个元素为spaninfo对象。"
表3 spaninfo

参数

参数类型

描述

trace_id

string

参数解释：

调用链id，唯一标识一次完整的调用链。

取值范围：

由系统生成的唯一标识字符串。

parent_span_id

string

参数解释：

父节点spanid，标识当前span的父节点。

取值范围：

spanid字符串或null（根节点）。"

span_id

string

参数解释：

spanid，唯一标识当前span。

取值范围：

由系统生成的唯一标识字符串。

span_type

string

参数解释：

span类型，标识当前span所属的类型。

取值范围：

不涉及。

span_name

string

参数解释：

span名称，标识当前span的操作名称。

取值范围：

不涉及。

status_code

string

参数解释：

状态码，标识当前span的执行状态。

取值范围：

不涉及。

status_message

string

状态信息

input

string

参数解释：

输入。

取值范围：

不涉及。

output

string

参数解释：

输出。

取值范围：

不涉及。

duration

integer

参数解释：

耗时，当前span的执行时长。

取值范围：

大于等于0的整数，单位为ms。

session_id

string

参数解释：

会话id。

取值范围：

不涉及。

tokens

integer

参数解释：

tokens消耗，当前span消耗的总token数量。

取值范围：

大于等于0的整数，单位为个。

input_tokens

integer

参数解释：

input tokens消耗，当前span输入部分消耗的token数量。

取值范围：

大于等于0的整数，单位为个。

output_tokens

integer

参数解释：

output tokens消耗，当前span输出部分消耗的token数量。

取值范围：

不涉及。

start_time

long

参数解释：

开始时间，当前span开始执行的时间戳。

取值范围：

unix时间戳，单位为ms。

call_type

string

参数解释：

触发类型。

取值范围：

不涉及。

metadata

string

参数解释：

元数据。

取值范围：

不涉及。

feedback_operation

string

参数解释：

评价状态，标识当前span的用户评价。

取值范围：

  • like：点赞。

  • unlike：点踩。

  • cancel：取消评价。

label

array of label objects

参数解释：

标签组，当前span关联的所有标签信息。

resource_id

string

参数解释：

应用id，当前span所属应用的唯一标识。

取值范围：

应用id字符串。

resource_name

string

参数解释：

应用名称，当前span所属应用的名称。

取值范围：

不涉及。

resource_type

string

参数解释：

应用类型，当前span所属应用的类型。

取值范围：

  • agent：单智能体。

  • multiagents：多智能体。

  • workflow：工作流。

model_name

string

参数解释：

模型名称，当前span使用的模型名称。

取值范围：

不涉及。

is_error

boolean

参数解释：

是否失败，标识当前span是否执行失败。

取值范围：

  • true：失败。

  • false：成功。
表4 label

参数

参数类型

描述

trace_id

string

参数解释：

调用链id，标签所属的调用链唯一标识。

取值范围：

调用链id字符串。

span_id

string

参数解释：

spanid，标签所属的span唯一标识。

取值范围：

spanid字符串。

start

long

参数解释：

开始时间，标签创建或关联的时间戳。

取值范围：

unix时间戳，单位为ms。

last_update_time

long

参数解释：

更新时间，标签最后更新的时间戳。

取值范围：

unix时间戳，单位为ms。

label

string

参数解释：

标签名称，标签的标识名。

取值范围：

不涉及。

string_value

string

参数解释：

标签值，当标签值为字符串类型时返回此字段。

取值范围：

字符串值。

float_value

string

参数解释：

标签值，当标签值为浮点数类型时返回此字段。

取值范围：

浮点数值的字符串表示。

请求示例

get https://api.example.com/v1/ops/observation/traces/5af65999f08e136b0963253064a2f693

响应示例

状态码：200

参数解释：

响应码，用于标识接口调用结果。

取值范围：

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,
    "status_message" : "状态信息"
  } ],
  "total" : 5
}

状态码

状态码

描述

200

参数解释：

响应码，用于标识接口调用结果。

取值范围：

200表示成功，其他值表示失败，具体参见错误码文档。

错误码

请参见错误码。

父主题：

相关文档

网站地图