HttpClient Monitoring

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

**Table 1** HttpClient collection parameters
Parameter	Data Type	Application Type	Default	Supported Start Agent Version	Supported End Agent Version	Description
URL Normalization Configuration	obj_array	JAVA	-	2.0.0	-	URL normalization configuration, based on which some RESTful URLs are normalized. There are four modes: "startwith", "endwith", "include", and "regex".

**Table 2** HttpClient metrics
Category	Metric	Name	Description	Unit	Data Type	Default Aggregation Mode
Exception (exception: HttpClient call exception statistics)	exceptionType	Exception Type	Exception type	-	ENUM	LAST
	count	Count	Number of times the exception has occurred	-	INT	SUM
	message	Exception Message	Message returned when the exception occurred	-	STRING	LAST
	stackTrace	Exception Stack	Exception stack information	-	CLOB	LAST
	causeType	Exception Class	Exception class	-	ENUM	LAST
Cluster metrics (hostInvocation: APM counts HttpClient URL call statistics by the called party's cluster.)	envId	Cluster ID	Cluster ID of the called party	-	ENUM	LAST
	hostUri	Called Address	Called address	-	STRING	LAST
	errorCount	Errors	Number of errors that occur when the cluster URL is called	-	INT	SUM
	invokeCount	Calls	Number of times that the cluster URL is called	-	INT	SUM
	maxTime	Max. RT	Maximum response time for calling the cluster URL	ms	INT	MAX
	totalTime	Total RT	Total response time for calling the cluster URL	ms	INT	SUM
	responseCloseCount	Closed Responses	Number of closed responses when the cluster URL is called	-	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
HttpClient version (info: HttpClient package version statistics)	httpClientVersion	HttpClient Version	Version of the HttpClient package	-	STRING	LAST
	httpCoreVersion	HttpCore Version	Version of the HttpCore package	-	STRING	LAST
URL monitoring (invocation: APM counts URL call statistics by URL.)	url	url	Called URL	-	ENUM	LAST
	method	HTTP Method	HTTP method of the URL	-	ENUM	LAST
	client	Client Type	HTTP client type	-	ENUM	LAST
	concurrentMax	Max. Concurrency	Maximum concurrency of the URL	-	INT	MAX
	errorCount	Errors	Number of call errors of the URL	-	INT	SUM
	errorTraceId	Error Trace ID	ID of the trace that encounters an error in a collection period	-	STRING	LAST
	slowTraceId	Slow Trace ID	ID of the slowest trace in a collection period	-	STRING	LAST
	hostUri	Called Address	Called URL address	-	STRING	LAST
	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 called URL	ms	INT	MAX
	responseCloseCount	responseCloseCount	Number of closed responses when the URL is called	-	INT	SUM
	totalTime	Total RT	Total response time of the called URL	ms	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
	envId	Cluster ID	Cluster ID corresponding to the called URL	-	STRING	LAST
HttpClient summary (total: summary about HttpClient call statistics)	errorCount	Errors	Total number of errors	-	INT	SUM
	invokeCount	Calls	Total number of calls	-	INT	SUM
	responseCloseCount	Closed Responses	Total number of responses that are closed	-	INT	SUM
	totalTime	Total RT	Total response time	ms	INT	SUM
Status code statistics (code: HttpClient call exception statistics)	code	Status Code	Status code	-	ENUM	LAST
	url	URL	URL that returns the status code	-	STRING	LAST
	count	Count	Number of times that the status code has occurred	-	INT	SUM