Configure Request Metrics trace filters

To specify which requests you want to trace with Request Metrics, set trace filters. The data is recorded to the system log file standard output and can be used for real-time and historical analysis.

If you collect request metrics data in a production environment, it is recommended that you filter by IP address. If you choose to enable Request Metrics, but not filter by a specific IP address, performance can be adversely affected. If you do not want to filter by IP address, it is recommended that you enable Request Metrics collection in test environments only.

Incoming HTTP requests

You can filter incoming HTTP requests based on client IP address and the URI of the request.

• Client IP address filters. Requests are filtered based on a known IP address. Use an asterisk (*) to specify a mask for an IP address. The asterisk must always be the last character of the mask. For example, 127.0.0.* is a valid filter, but 127.0.*.30 is not. For performance reasons, the pattern matches character by character, until either an asterisk is found in the filter, a mismatch occurs, or the filters are found as an exact match.

• URI filters. Requests are filtered based on the URI of the incoming HTTP request. URI filters and client IP address filters use the same pattern matching rules.

• Filter combinations. If both URI and client IP address filters are active, then Request Metrics requires a match for both filter types. If neither filter type is active, all requests are considered a match.

Incoming enterprise bean requests

You can filter enterprise bean requests based on the full name of the enterprise bean method. As with IP address and URI filters, you can use the asterisk (*) to provide a mask. The asterisk must always be the last character of a filter pattern.

Enable Request Metrics filters

To enable Request Metrics filters, follow these steps:

1. Start the administrative console.
2. In the administrative console navigation tree, click Troubleshooting.
3. Click PMI Request Metrics.
4. Click Filters.
5. Click the filter type that you want to enable.
6. Select the check box in the Enable field under the Configuration tab.
7. Click Apply or OK.
8. Save the configuration.
9. Stop and restart the application server.

Note: You can enable or disable a filter group. If the group is enabled, you can enable or disable individual filters within the group.

Add and remove Request Metrics filters

To configure Request Metrics filters, follow these steps:

1. Start the administrative console.
2. In the administrative console navigation tree, click Troubleshooting.
3. Click PMI Request Metrics.
4. Click Filters.
5. Click the filter type that you want to configure.
6. Click New.
7. Choose a filter type from the drop down box in the type field under the Configuration tab.
8. Select the check box in the Enable field to enable the filter.
9. Click filterValues.
10. Make changes to the filter.
11. Click Apply or OK.
12. Save the configuration.
13. Stop and restart the application server.

For more information, see these help topics:

• Performance Monitoring Infrastructure Request Metrics configuration settings
• PMIRMFilter collection
• PMIRM filter settings
• Filter value collection
• Filter value settings