j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ 观测/ / 查询调用链span指标 - listopsagentspanmetric
更新时间：2026-07-06 gmt 08:00
查看pdf

查询调用链span指标 -j9九游会登录

功能介绍

该接口用于查询调用链详情页面中每个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://api.example.com/v1/ops/observation/agent/b0fd244b-c5c8-4ef7-97b6-645a1b03edc6/span/userinput/metrics?span_time=1775271200803

响应示例

无

状态码

状态码

描述

200

参数解释：

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

取值范围：

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

错误码

请参见错误码。

父主题：

相关文档

网站地图