文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 观测/ 指标查询/ 查询调用链span指标 - ListOpsAgentSpanMetric
更新时间:2026-04-15 GMT+08:00
分享

查询调用链span指标 - ListOpsAgentSpanMetric

功能介绍

该接口用于查询调用链详情页面中每个span的数据信息。

URI

GET /v1/ops/observation/agent/{agent_id}/span/{span_name}/metrics

表1 路径参数

参数

是否必选

参数类型

描述

agent_id

String

参数解释

智能体 ID。

约束限制

长度1-64位。

取值范围

不涉及。

默认取值

不涉及。

span_name

String

参数解释

spanName。

约束限制

长度1-128位。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

agent_span_metric_list

Array of AgentSpanMetricInfo objects

span列表

表4 AgentSpanMetricInfo

参数

参数类型

描述

metric_name

String

参数解释

指标名称。

取值范围

不涉及。

metric_total_value

Integer

参数解释

总数。

取值范围

取值范围0-100000。

agent_metric_value_list

Array of AgentSpanMetricValueInfo objects

参数解释

span列表。

取值范围

不涉及。

表5 AgentSpanMetricValueInfo

参数

参数类型

描述

time

Long

参数解释

时间戳。

取值范围

不涉及。

value

String

参数解释

时间节点上计算出的值。

取值范围

不涉及。

请求示例

GET https://*.com/v1/ops/observation/agent/b0fd244b-c5c8-4ef7-97b6-645a1b03edc6/span/UserInput/metrics?span_time=1775271200803

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

响应示例

状态码

状态码

描述

200

查询成功。

错误码

请参见错误码

相关文档