Use this Knowledge Script to specify the filters to be used for generating request metrics traces. You must specify filters using this script before you can collect response time data with the RequestMetrics Knowledge Script. Three types of filtering can be specified, as described below. In each case, the filter pattern is expressed as a string that can optionally contain an asterisk (*) as the last character. Matching is done character by character, until either an asterisk is found in the filter, a mismatch occurs, or an exact match occurs.
URL filters: Requests are filtered based on the URL of the incoming HTTP request.
Client IP address filters: Requests are filtered based on the IP address of the incoming HTTP request.
EJB method name filters: Requests are filtered based on the full name of the enterprise bean method.
If both URL filters and client IP address filters are specified, a match occurs only if a filter of each type is matched. It is strongly suggested that at least one URL or client IP address filter be supplied, to avoid performance degradation due to the large number of trace records that otherwise would be written to the trace log.
If no filters are specified, this script turns off request metrics tracing altogether. That is, it has the effect of stopping request metrics tracing completely, rather than causing all requests to be traced. Thus, to turn on request metrics tracing, you must specify at least one filter. If you do not plan to run the RequestMetrics Knowledge Script on any computer in the WebSphere Application Server domain for a long period of time, you can turn off tracing by specifying no filters to avoid the performance penalty engendered by writing request traces to the log file.
NOTE:In an IBM WebSphere Application Server network deployment, the Request Metrics configuration is managed centrally by the deployment manager, and the settings apply to all nodes and application servers in the cell. Therefore, you only need to run this Knowledge Script against a single server in the deployment cell.
WebSphere Application Server
The default interval for this script is Run Once.
Set the following parameters as needed:
|
Description |
How to Set It |
|---|---|
|
Event? (y/n) |
Set to y to raise events. The default is y. |
|
Semicolon-separated list of URL filters |
Specify the URL patterns to be used in filtering. Patterns should be separated from one another by semicolons. |
|
Semicolon-separated list of client IP address filters |
Specify the IP address patterns to be used in filtering. Patterns should be separated from one another by semicolons. |
|
Semicolon-separated list of EJB method name filters |
Specify the EJB method name patterns to be used in filtering. Patterns should be separated from one another by semicolons. |