查询trace列表 - ListOpsTrace

agentarts::listOpsTrace

List

-

-

-

• apm:apm2TraceEvents:get
• apm:apm2Service:get

Content-Type

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

application/json。

默认取值：

application/json。

Authorization

是

String

参数解释：

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

约束限制：

SDK自动填充,格式为SDK-HMAC-SHA256。

取值范围：

符合签名规范的字符串。

默认取值：

不涉及。

X-Sdk-Date

是

String

参数解释：

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

约束限制：

符合ISO 8601格式。

取值范围：

格式为YYYYMMDDTHHMMSSZ,如20240416T095341Z。

默认取值：

不涉及。

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<String,String>

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。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

参数解释：

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

约束限制：

不涉及。

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：不属于。

默认取值：

不涉及。

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：不属于。

默认取值：

不涉及。

total

Integer

参数解释：

总数。

取值范围：

不涉及。

span_list

Array of SpanInfo objects

参数解释：

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

取值范围：

数组中的每个元素为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的执行状态。

取值范围：

不涉及。

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：成功。

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

参数解释：

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

取值范围：

浮点数值的字符串表示。

200

参数解释：

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

取值范围：

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