更新时间:2026-07-10 gmt 08:00

查询trace列表 -j9九游会登录

功能介绍

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

调用方法

请参见如何调用api

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::listopstrace

list

-

-

-

  • apm:apm2traceevents:get
  • apm:apm2service:get

uri

post /v1/ops/observation/traces

请求参数

表1 请求body参数

参数

是否必选

参数类型

描述

start_time

long

参数解释

开始时间,用于指定查询时间范围的起始时间点。

约束限制

必须为有效的unix时间戳,且不大于end_time。

取值范围

unix时间戳,单位为ms。

默认取值

不涉及。

end_time

long

参数解释

截止时间,用于指定查询时间范围的结束时间点。

约束限制

必须为有效的unix时间戳,且不小于start_time。

取值范围

unix时间戳,单位为ms。

默认取值

不涉及。

resource_id

string

参数解释

应用id,用于筛选指定应用的调用链数据。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

resource_type

string

参数解释

资源类型,用于筛选指定类型的资源调用链数据。

约束限制

不涉及。

取值范围

  • agent:单智能体。

  • multiagents:多智能体。

  • workflow:工作流。

默认取值

不涉及。

trace_id

string

参数解释

调用链id,用于精确查询指定的调用链数据。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

status_code

string

参数解释

状态码,用于筛选指定状态的调用链数据。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

session_id

string

参数解释

会话id,用于筛选指定会话的调用链数据。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

span_type

string

参数解释

span类型,用于筛选指定类型的span数据。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

input

string

参数解释

span的输入内容,用于模糊匹配筛选调用链数据。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

output

string

参数解释

span的输出内容,用于模糊匹配筛选调用链数据。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

like

integer

参数解释

评价状态,用于筛选已评价或未评价的调用链数据。

约束限制

不涉及。

取值范围

  • 1:点赞。

  • 2:点踩。

  • 0:取消评价。

默认取值

不涉及。

label

map

参数解释

标注的过滤条件,用于筛选带有特定标签的调用链数据。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。map说明:key为标签名称,value为标签值。

page_no

integer

参数解释

页码,用于分页查询,指定返回第几页的数据。

约束限制

必须为正整数。

取值范围

大于等于1的整数。

默认取值

1。

page_size

integer

参数解释

每页条数,用于分页查询,指定每页返回的数据条数。

约束限制

必须为正整数。

取值范围

1-100。

默认取值

10。

filter_sign

string

参数解释

连接标识,用于标明查询语句中条件之间且或者或的关系。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

label_filter

array of filterparam objects

参数解释

标签过滤条件,用于按标签筛选调用链数据,支持多个条件的组合查询。

约束限制

不涉及。

filter

array of listfilterparam objects

参数解释

过滤条件,用于多条件组合筛选调用链数据。

约束限制

不涉及。

表2 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:不属于。

默认取值

不涉及。

表3 listfilterparam

参数

是否必选

参数类型

描述

name

string

参数解释

过滤名,指定要过滤的字段名称,如resource_id、resource_type等。

约束限制

长度限制为1-64位。

取值范围

不涉及。

默认取值

不涉及。

value

string

参数解释

过滤值,指定要过滤的字段值,需与name字段配合使用。

约束限制

长度限制为1-64位。

取值范围

根据name字段确定。

默认取值

不涉及。

operator

string

参数解释

操作类型。

约束限制

不涉及。

取值范围

  • equal:等于。

  • like:包含。

  • not_like:不包含。

  • empty:为空。

  • not_empty:不为空。

  • greater_than:大于。

  • less_than:小于。

  • in:属于。

  • not_in:不属于。

默认取值

不涉及。

响应参数

状态码:200

表4 响应body参数

参数

参数类型

描述

total

integer

参数解释

总数。

取值范围

不涉及。

span_list

array of spaninfo objects

参数解释

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

取值范围

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

表5 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:成功。

表6 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

参数解释

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

取值范围

浮点数值的字符串表示。

请求示例

post https://api.example.com/v1/ops/observation/traces
{
  "page_no" : 1,
  "page_size" : 10,
  "start_time" : 1773279366881,
  "end_time" : 1775871366881,
  "span_type" : "root"
}

响应示例

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

状态码

状态码

描述

200

参数解释

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

取值范围

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

错误码

请参见错误码

相关文档

网站地图