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

查询调用链span指标 - ListOpsAgentSpanMetric

功能介绍

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

调用方法

请参见如何调用API

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::listOpsAgentSpanMetric

Read

-

-

-

  • apm:apm2TraceEvents:get
  • apm:apm2Service:get
  • aom:metric:list

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 Query参数

参数

是否必选

参数类型

描述

span_time

String

参数解释

调用链产生的时间。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

响应参数

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

响应示例

状态码

状态码

描述

200

参数解释

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

取值范围

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

错误码

请参见错误码

相关文档