Obtains the trend of reported Span events.

Request description

Server-side Monitoring has been deployed in multiple regions around the world to provide you with a more stable and low-latency access experience. You can refer to the Service addresses topic to choose the most suitable access point based on your business location.

Request method: POST

Request URL: https://apmplus-server.cn-beijing.volcengineapi.com?Action=GetTraceTrend&Version=2026-01-01

Request parameters

The following table lists only the request parameters specific to this API and some common parameters. For details, see Common parameters.

Parameters	Type	Required	Sample value	Description
Action	String	Yes	GetTraceTrend	The API name. The API name is GetTraceTrend.
Version	String	Yes	2026-01-01	The API version. The API version is 2026-01-01.
StartTime	Long	Yes	1767196800	The query start timestamp in seconds.
EndTime	Long	Yes	1767200400	Query end timestamp in seconds.
GranularityUnit	String	Yes	s	The time granularity unit, such as "s", "m", and "h". tip GranularityUnit and Granularity together align the start and end times and determine the time series data step, corresponding to the aggregation method on the page.
Granularity	Long	Yes	30	The time granularity value.
MinCallCostMillisecond	Long	Yes	100	The minimum call duration. This is used to filter data. A value of 0 indicates no filtering.
MaxCallCostMillisecond	Long	Yes	1,000	The maximum call duration. This is used to filter data. A value of 0 indicates no filtering.
Filters	Array of FilterCondition	Yes	-	The general-purpose filter criteria, which correspond to the filter boxes on the page. If no filter is specified, an empty list can be passed in. An item consists of key, op, and value, such as span_type,in,server.
ProjectName	String	No	default	The project name.
TagFilters	Array of TagFilter	Yes	-	Tag filter condition. It is set to a value in the format of key-value pairs, which corresponds to the tag filter feature on the page. If no filter is specified, an empty list can be passed in.
BusinessCarrier	String	No	agentkit_runtime	The business carrier. Valid value: agentkit_runtime. warning If this parameter is set to agentkit_runtime, the values of the ProjectName and TagFilters parameters do not take effect.

FilterCondition

Parameters	Type	Required	Sample value	Description
Op	String	No	in	The operator in the filter criteria. Valid values: in and not_in.
Key	String	No	call_service_type	Key of the filter condition.
Values	Array of String	No	['http']	Value of the filter condition.

TagFilter

Parameters	Type	Required	Sample value	Description
Key	String	No	testKey	The tag key.
Values	Array of String	No	['testValue']	The tag value.

Sample request

Response parameters

Parameters	Type	Sample value	Description
Panel	Object of MetricPanel	-	The metric time series data.

MetricPanel

Parameters	type	Sample value	Description
Accuracy	Integer	0	The data accuracy. The default value is 0.
TrendList	Array of MetricTrend	-	The data time series.

MetricTrend

Parameters	Type	Sample value	Description
Avg	Double	100	Average value.
Tags	Array of TagKV	-	The tags related to the trend. The value is expressed as a triplet, such as tag key,tag display name,tag value.
Unit	String	%	Unit. %: The API will return data in the range from 0 to 1. When the value is visualized in the console, if % is used as the unit, the data returned by the API needs to be multiplied by 100 to ensure the value matches the unit. byte: The API will return the number of bytes. When the value is visualized in the console, unit conversion can be performed based on actual needs. For example, convert the unit to KiB or MiB.
Points	Array of SeriesPoint	-	The trend points. The value is expressed as a triplet, such as start timestamp,metric value,end timestamp.
MetricName	String	report volume	The metric name.
MetricLabel	String	testLabel	The metric display label.

TagKV

Parameters	Type	Sample value	Description
Key	String	testKey	Tag key.
Label	String	testLabel	The tag display name.
Value	String	testValue	Tag value.

SeriesPoint

Parameters	Type	Sample value	Description
Value	Double	100	The metric value.
Timestamp	Long	1640995200	The start timestamp.
EndTimestamp	Long	1640995260	The end timestamp.

Sample response

Error codes

If the API call returns an exception, you can troubleshoot by referring to the API error codes and the Public error codes below.

HTTP status codes	Error codes	Error messages	Description
500	ErrInternalServerError	We encountered an unexpected server error, please try again later.	Internal server error.

Application Performance Management Plus