文档中心

应用性能监控全链路版

网络监控

GetAppHttpTrend

获取网络 Http 监控的各项指标趋势。

请求说明

客户端监控已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地选择最合适的接入点。

请求方式：POST

请求地址：https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppHttpTrend&Version=2025-12-01

请求参数

下方仅列出该接口特有的请求参数和部分公共参数，更多详细信息参见公共参数。

说明

调用本接口前，请在请求中传入必填的公共请求参数（如 x-app-ids），否则将调用失败。

参数	类型	是否必选	示例值	描述
Action	String	是	GetAppHttpTrend	接口名称。当前 API 的名称为 GetAppHttpTrend。
Version	String	是	2025-12-01	接口版本。当前 API 的版本为 2025-12-01。
StartTime	Integer	是	1617225600	查询开始时间的时间戳。
EndTime	Integer	是	1617312000	查询结束时间的时间戳。
Filters	Object of Condition	否	filters	筛选条件，可以指定多个键值对来筛选数据。
LastGroupFilters	Array of Condition	否	last_group_filters	之前的分组被选中的条件。
GroupField	String	是	os_version	要对结果进行分组的字段名称，没有分组时传空字符串。
Metrics	Array of String	是	["req_cnt_v2","req_cnt_rate_v2"]	需要查询的指标名称。取值： all_report_cnt_v2：上报数 req_cnt_v2：请求数 req_cnt_rate_v2：请求率 req_success_cnt_v2：请求成功数 req_success_rate_v2：请求成功率 reused_cnt_v2：链接复用数 reused_rate_v2：链接复用率 reused_success_rate_v2：链接复用成功率 req_err_cnt_v2：请求错误数 req_all_err_cnt_v2：所有请求错误数 req_err_rate_v2：请求错误率 req_total_cost_v2：所有请求数 req_user_cnt_v2：请求用户数 req_success_user_cnt_v2：请求成功用户数 req_success_user_rate_v2：请求成功用户率
DomainTag	String	是	all	主机标签。取值： all：全部 self：自身服务 other：第三方
StatisticScale	String	否	avg	统计口径。取值： avg pct50 pct75 pct95 pct99
Granularity	Integer	是	5	聚合粒度，单位：分钟。
TopN	Integer	是	10	分组 topN 的数量，没有分组时传 0。

Condition

参数	类型	是否必选	示例值	描述
Op	String	否	in	操作符。取值： gt：大于 gte：大于等于 lt：小于 lte：小于等于 eq：等于 neq：不等于 in：包含 not_in：不包含 lk：模糊匹配特定模式的数据 nlk：排除模糊匹配的数据
Type	String	否	expression	筛选条件类型。示例值： expression：当前条件为单一表达式。 and：当前条件为复合表达式，各子条件 SubConditions 之间为逻辑“与”关系。 or：当前条件为复合表达式，各子条件 SubConditions 之间为逻辑“或”关系。 map：当前条件为 map 类型。
Value	String	否	123456	筛选值。
MapKey	String	否	key_1	map 类型的 key。说明当 type取值为 map 时，必须配置此参数。
Values	Array of String	否	[123456]	筛选值，支持同时配置多个。
Dimension	String	否	aid	条件的名称。
SubConditions	Array of Condition	否	-	子条件。

请求示例

返回参数

参数	类型	示例值	描述
key	String	1	指标名称。
value	Array of TrendLine	-	趋势值。

TrendLine

参数	类型	示例值	描述
Name	String	test123	曲线名称。分组时取值为分组维度的值，可用作图例显示。
Total	Double	10	总数。
Points	Array of TrendPoint	-	曲线上的数据点。

TrendPoint

参数	类型	示例值	描述
Value	Double	123	指标值。
Timestamp	Long	1665417600	指标发生时间的时间戳。
ReadableTimestamp	String	2022-10-11	指标发生时间。

返回示例

错误码

当前接口暂无独立错误码，若接口调用返回异常，可参考公共错误码进行故障排查。

最近更新时间：2026.10.21 16:47:31

这个页面对您有帮助吗？

有用

无用