Updated on 2026-02-25 GMT+08:00

Configuring the HttpClient Monitoring Item

On the Modify HttpClient Monitoring Configuration page, set the following URL normalization parameters:

  • Collection Interval: The default value is 60s and cannot be changed.
  • URL normalization is used to aggregate URLs that meet the conditions you set. For example, http://localhost/rest/v1/test/123 and http://localhost/rest/v1/test/234 can be aggregated into http://localhost/rest/v1/test/{id}. For details, see URL Normalization Configuration.
  • httpClientMaxRows: the maximum number of HttpClient rows that can be collected by the Agent. If this value has been reached, the Agent stops collecting data immediately. The default value is 500. The value ranges from 10 to 2000.
  • Blocklist configuration: The data of URLs that meet the conditions you set will not be collected. For details, see Blocklist Configuration.
Figure 1 Configuring the HttpClient monitoring item

URL Normalization Configuration

There are four modes: Startwith, Endwith, Include, and Regex.

  • Startwith: The URLs starting with a certain expression are counted as normalized URLs. For example, URLs starting with http://127.0.0.1/v1 are aggregated into /v1/test/{id}, as shown in Figure 1.
  • Endwith: The URLs ending with a certain expression are counted as normalized URLs. For example, URLs ending with /test are aggregated into /{id}/test, as shown in Figure 1.
  • Include: The URLs containing a certain expression are counted as normalized URLs. For example, URLs containing test are aggregated into /test/{id}, as shown in Figure 1.
  • Regex: The URLs that meet the wildcard expression are counted as normalized URLs. For details about the wildcard rules, see Table 1.
    Table 1 Wildcard description

    Wildcard

    Description

    ?

    Matches any character.

    *

    Matches zero, one, or more characters.

    **

    Matches zero, one, or more directories.

Blocklist Configuration

There are four modes: Startwith, Endwith, Include, and Regex.

  • Startwith: The URLs starting with a certain expression are blocked, as shown in Figure 1.
  • Endwith: The URLs ending with a certain expression are blocked, as shown in Figure 1.
  • Include: The URLs containing a certain expression are blocked, as shown in Figure 1.
  • Regex: The URLs that meet the wildcard expression are blocked. For details about the wildcard rules, see Table 1.

Usage Example

The following is an example:

URL Path

Description

/app/p?ttern

Matches files such as /app/pattern and /app/pAttern, excluding /app/pttern.

/app/*.x

Matches all .x files in the app directory.

/**/example

Matches /app/example, /app/foo/example, and /example.

/app/**/dir/file.*

Matches /app/dir/file.jsp, /app/foo/dir/file.htm, /app/foo/bar/dir/file.pdf, and /app/dir/file.c.

/**/*.jsp

Matches all .jsp files.