文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 观测/ 指标查询/ 查询调用链span指标 - ListOpsAgentSpanMetric
更新时间：2026-08-27 GMT+08:00
查看PDF
分享

查询调用链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

参数解释：

调用链中span的名称，用于标识和定位具体的调用链环节。

约束限制：

长度限制为1~128个字符。

取值范围：

不涉及。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

span_time

否

String

参数解释：

调用链产生的时间，Unix时间戳，单位为ms。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

resource_type

否

String

参数解释：

资源类型，用于指定查询的资源对象类型。

约束限制：

不涉及。

取值范围：

  • agent：单智能体；

  • multiagents：多智能体；

  • workflow：工作流。

默认取值：

不涉及。

请求参数

无

响应参数

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

参数解释：

指标值列表，包含时间戳及对应时间点的指标值。

取值范围：

不涉及。
表5 AgentSpanMetricValueInfo

参数

参数类型

描述

time

Long

参数解释：

时间戳，单位为毫秒。

取值范围：

不涉及。

value

String

参数解释：

时间节点上计算出的值。

取值范围：

不涉及。

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：403

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

编码后的授权信息，用于客户端解析权限问题。

取值范围：

不涉及。

details

Array of OpsObserverCommonError objects

参数解释：

赖的下游服务错误信息列表。

取值范围：

不涉及。
表8 OpsObserverCommonError

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

请求示例

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

响应示例

状态码：400

参数解释：

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

取值范围：

400表示请求参数不正确。

{
  "error_code" : "AgentArts.05001003",
  "error_msg" : "请求参数不正确"
}

状态码：403

参数解释：

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

取值范围：

403表示权限不足，拒绝访问。

{
  "error_code" : "AgentArts.05004003",
  "error_msg" : "权限不足，拒绝访问",
  "encode_authorization_message" : "eyJIcnJvciI6ICJVbmF1dGhvcm16ZWQifQ==",
  "details" : [ {
    "error_code" : "AgentArts.05001003"
  }, {
    "error_msg" : "请求参数不正确"
  } ]
}

状态码：500

参数解释：

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

取值范围：

500表示内部服务器错误。

{
  "error_code" : "AgentArts.05005000",
  "error_msg" : "内部服务器错误"
}

状态码

状态码

描述

200

参数解释：

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

取值范围：

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

400

参数解释：

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

取值范围：

400表示请求参数不正确。

403

参数解释：

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

取值范围：

403表示权限不足，拒绝访问。

500

参数解释：

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

取值范围：

500表示内部服务器错误。

错误码

请参见错误码。

父主题： 指标查询

相关文档