Updated on 2024-07-04 GMT+08:00

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