文档中心

应用性能监控全链路版

Trace 分析

GetTraceTrend

GetTraceTrend

获取 Span 上报量趋势。

请求说明

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

请求方式：POST

请求地址：https://apmplus-server.cn-beijing.volcengineapi.com?Action=GetTraceTrend&Version=2026-01-01

请求参数

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

参数	类型	是否必选	示例值	描述
Action	String	是	GetTraceTrend	接口名称。当前 API 的名称为 GetTraceTrend。
Version	String	是	2026-01-01	接口版本。当前 API 的版本为 2026-01-01。
StartTime	Long	是	1767196800	查询起始时间戳，单位：秒。
EndTime	Long	是	1767200400	查询结束时间戳，单位：秒。
GranularityUnit	String	是	s	时间粒度单位，例如 "s", "m", "h" 等。说明 GranularityUnit 和 Granularity 共同负责对齐起止时间，决定时序数据步长，对应页面中的聚合方式。
Granularity	Long	是	30	时间粒度数值。
MinCallCostMillisecond	Long	是	100	调用耗时最小值，用于过滤数据。配置为 0 表示不进行过滤。
MaxCallCostMillisecond	Long	是	1000	调用耗时最大值，用于过滤数据。配置为 0 表示不进行过滤。
Filters	Array of FilterCondition	是	-	通用过滤条件，对应页面筛选框。无筛选时允许传空列表。一个 Item 由 key、op、value 组成，例如：span_type,in,server。
ProjectName	String	否	default	项目名称。
TagFilters	Array of TagFilter	是	-	Tag 过滤条件。通过键值对形式配置，对应页面中的标签筛选功能。无筛选时允许传空列表。
BusinessCarrier	String	否	agentkit_runtime	业务载体，可选值包括：agentkit_runtime。注意配置为 agentkit_runtime时，ProjectName 和 TagFilters 参数的取值不生效。

FilterCondition

参数	类型	是否必选	示例值	描述
Op	String	否	in	过滤条件操作符，一般为 in, not_in。
Key	String	否	call_service_type	过滤条件的键。
Values	Array of String	否	['http']	过滤条件的值。

TagFilter

参数	类型	是否必选	示例值	描述
Key	String	否	testKey	过滤 Tag 的键。
Values	Array of String	否	['testValue']	过滤 Tag 的值。

请求示例

返回参数

参数	类型	示例值	描述
Panel	Object of MetricPanel	-	指标时序数据。

MetricPanel

参数	类型	示例值	描述
Accuracy	Integer	0	数据精度，默认为 0。
TrendList	Array of MetricTrend	-	数据时序列表。

MetricTrend

参数	类型	示例值	描述
Avg	Double	100	平均值。
Tags	Array of TagKV	-	Trend 相关的标签。使用三元组形式表示，例如：标签键,标签显示名称,标签值。
Unit	String	%	单位。 %：接口将返回数据 0-1。通过控制台可视化展示时，若使用 % 作为单位，需要对接口返回数据乘以 100，以保证数值与单位匹配。 byte：接口将返回字节数。通过控制台可视化展示时，可根据实际需求，进行单位转换，例如：转换成 KiB，MiB 等。
Points	Array of SeriesPoint	-	趋势点。使用三元组形式表示，例如：起始时间戳,指标值,结束时间戳。
MetricName	String	report volume	指标名。
MetricLabel	String	testLabel	指标显示 Label。

TagKV

参数	类型	示例值	描述
Key	String	testKey	标签键。
Label	String	testLabel	标签显示名称。
Value	String	testValue	标签值。

SeriesPoint

参数	类型	示例值	描述
Value	Double	100	指标值。
Timestamp	Long	1640995200	起始时间戳。
EndTimestamp	Long	1640995260	结束时间戳。

返回示例

错误码

若接口调用返回异常，可参考以下接口错误码和公共错误码进行故障排查。

HTTP 状态码	错误码	错误信息	说明
500	ErrInternalServerError	We encountered an unexpected server error, please try again later.	服务器内部错误。

最近更新时间：2026.02.10 19:56:34

这个页面对您有帮助吗？

有用

有用

无用

无用