j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ 观测/ / 查询指标趋势图 - showopsagentmetrictrend
更新时间：2026-07-10 gmt 08:00
查看pdf

查询指标趋势图 -j9九游会登录

功能介绍

该接口用于查询智能体的指标趋势图。

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts::showopsagentmetrictrend

read

-

-

-
  • apm:apm2traceevents:get
  • apm:apm2service:get
  • aom:metric:list

uri

post /v1/ops/observation/agents/metric/trend

请求参数

表1 请求body参数

参数

是否必选

参数类型

描述

group_by

否

array of strings

参数解释：

分组名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

start_time

是

string

参数解释：

开始时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

unix时间戳，单位为ms。

end_time

是

string

参数解释：

截止时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

unix时间戳，单位为ms。

metric_name

否

string

参数解释：

指标名。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

resource_id

否

string

参数解释：

智能体id。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

resource_type

否

string

参数解释：

智能体类型。

约束限制：

不涉及。

取值范围：

  • agent：单智能体。

  • multiagents：多智能体。

  • workflow：工作流。

默认取值：

不涉及。

user_id

否

string

参数解释：

用户id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

filter

否

array of metricfilterparam objects

参数解释：

过滤条件。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表2 metricfilterparam

参数

是否必选

参数类型

描述

label_name

否

string

参数解释：

指标维度标签名称，用于指定过滤条件的维度。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

label_value

否

string

参数解释：

维度标签值，用于指定过滤条件的维度值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

operator

否

string

参数解释：

过滤操作符，用于定义label_name与label_value之间的匹配关系。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应body参数

参数

参数类型

描述

line_list

array of frontline objects

趋势图数据。

step

string

步长
表4 frontline

参数

参数类型

描述

point_list

array of frontpoint objects

参数解释：

趋势线上的数据点列表，每个点包含时间和对应的值。

取值范围：

不涉及。

group_by

string

参数解释：

分组名。

取值范围：

不涉及。
表5 frontpoint

参数

参数类型

描述

time

long

参数解释：

时间戳。

取值范围：

不涉及。

value

string

参数解释：

时间节点上计算出的值。

取值范围：

不涉及。

请求示例

post https://api.example.com/v1/ops/observation/agents/metric/trend
content-type:application/json
x-sdk-date:20240416t095341z
authorization:sdk-hmac-sha256 access=****************, signedheaders=content-type;host;x-sdk-date, signature=****************
{
  "start_time": "1776129766990",
  "end_time": "1776133366990",
  "metric_name": "model_avg_duration",
  "resource_type": "agent",
  "filter": [
    {
      "label_name": "gen_ai_resource_type",
      "label_value": "agent",
      "operator": "="
    }
  ]
}

响应示例

状态码：200

参数解释：

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

取值范围：

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

{
  "step" : "60",
  "line_list" : [ {
    "point_list" : [ {
      "time" : 1774970788,
      "value" : "100"
    } ],
    "group_by" : ""
  } ]
}

状态码

状态码

描述

200

参数解释：

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

取值范围：

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

错误码

请参见错误码。

父主题：

相关文档

网站地图