Updated on 2023-08-02 GMT+08:00

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