URL Monitoring

This section describes the types, names, and meanings of URL metrics collected by APM.

**Table 1** Collection parameters for URL monitoring
Parameter	Data Type	Application Type	Default	Supported Start Agent Version	Supported End Agent Version	Description
Key for Header Value Interception	array	JAVA	-	2.0.0	-	Key based on which header value content is to be intercepted
Key for Parameter Value Interception	array	JAVA	-	2.0.0	-	Key based on which parameter value content is to be intercepted
Key for Cookie Value Interception	array	JAVA	-	2.0.0	-	Key based on which cookie value content is to be intercepted
URL Collection Configuration	obj_array	JAVA	-	2.0.0	-	URL collection configuration, based on which RESTful URLs are normalized. There are four modes: "startwith", "endwith", "include", and "regex".
Blocklist Configuration	obj_array	JAVA	-	2.0.0	-	URLs that match the specified rule will not be collected. There are four modes: "startwith", "endwith", "include", and "regex".
Service Code Length	integer	JAVA	0	2.0.0	-	Maximum length of the body content to be collected for service code parsing
Key for Service Code Interception	array	JAVA	-	2.0.0	-	Specify a key. Then the system parses the key in the body (JSON) and obtains the service status code based on the key.
Normal Service Code	array	JAVA	-	2.0.0	-	Normal service code range. If a service code is not within this range, the corresponding trace is regarded as an error trace.
Slow Request Threshold	integer	JAVA	800	2.0.0	-	Slow request threshold. If the threshold is crossed, the URL is regarded as a slow URL. In that case, the trace sampling ratio will be increased by default.
URL Configuration	obj_array	JAVA	-	2.0.0	-	Configure the slow request threshold and sampling ratio for each URL separately. The following sampling policies can be set: percentage sampling, fixed-quantity sampling per minute, and automatic sampling.
Error Code	radio	JAVA	500	2.0.0	-	Status codes that are counted as errors
Auto URL Normalization	radio	JAVA	false	2.3.11	-	Whether the URL will be automatically normalized

**Table 2** URL metrics
Category	Metric	Name	Description	Unit	Data Type	Default Aggregation Mode
Summary (total, URL call statistics summary)	errorCount	Errors	Total number of errors	-	INT	SUM
	invokeCount	Calls	Total number of calls	-	INT	SUM
	totalTime	Total RT	Total response time	ms	INT	SUM
	satisfiedCount	Satisfied Requests	Number of satisfied requests	-	INT	SUM
	toleratingCount	Tolerable Requests	Number of tolerable requests	-	INT	SUM
Status code (statuscode: APM counts URL call statistics based on the status code returned.)	code	Status Code	Status code	-	ENUM	LAST
	count	Calls	Number of times that the status code has occurred	-	INT	SUM
	url	Sample URL	Sample URL which returns the status code in a collection period	-	STRING	LAST
URL monitoring (url: APM counts URL call statistics by URL.)	url	URL	Request URL	-	ENUM	LAST
	method	HTTP Method	Request HTTP method	-	ENUM	LAST
	concurrentMax	Max. Concurrency	Maximum concurrency of the URL	-	INT	MAX
	errorCount	Errors	URL call errors	-	INT	SUM
	invokeCount	Calls	Number of times that the URL is called	-	INT	SUM
	lastError	Error Message	Error details	-	STRING	LAST
	maxTime	Max. RT	Maximum response time of the URL in a collection period	ms	INT	MAX
	maxTimeNativeUrl	Slowest URL	Slowest URL in the collection period	-	STRING	LAST
	runningCount	Ongoing Executions	Number of tasks that are being executed at the time of collection	-	INT	SUM
	range1	0–10 ms	Number of requests with 0–10 ms response time	-	INT	SUM
	range2	10–100 ms	Number of requests with 10–100 ms response time	-	INT	SUM
	range3	100–500 ms	Number of requests with 100–500 ms response time	-	INT	SUM
	range4	500–1000 ms	Number of requests with 500–1000 ms response time	-	INT	SUM
	range5	1–10s	Number of requests with 1–10s response time	-	INT	SUM
	range6	> 10s	Number of requests with response time longer than 10s	-	INT	SUM
	totalTime	Total RT	Total response time	ms	INT	SUM
	isRoot	Root Span or Not	Whether the span is a root span	-	INT	SUM
	satisfiedCount	Satisfied Requests	Number of satisfied requests	-	INT	SUM
	toleratingCount	Tolerable Requests	Number of tolerable requests	-	INT	SUM
Cluster call (user: APM counts URL call statistics based on the cluster ID of the caller.)	clusterId	Cluster ID	Cluster ID of the caller	-	ENUM	LAST
	invokeCount	Calls	Number of times the cluster is called	-	INT	SUM
	total1xxCount	1xx Count	Number of times that a 1xx status code was returned	-	INT	SUM
	total2xxCount	2xx Count	Number of times that a 2xx status code was returned	-	INT	SUM
	total3xxCount	3xx Count	Number of times that a 3xx status code was returned	-	INT	SUM
	total4xxCount	4xx Count	Number of times that a 4xx status code was returned	-	INT	SUM
	total5xxCount	5xx Count	Number of times that a 5xx status code was returned	-	INT	SUM
	totalTime	Total RT	Total response time for calling the cluster	ms	INT	SUM
	errorCount	Errors	Number of times that the cluster fails to be called	-	INT	SUM
	concurrentMax	Max. Concurrency	Maximum concurrency of the cluster	-	INT	MAX
	maxTime	Max. RT	Maximum response time of the URL in a collection period	ms	INT	MAX