Several built-in agent policies are provided with the App Visibility agent for Java:
- Light
Records the least amount of information and has a low performance hit on the recorded application. - Medium
Records more information than the Light policy, and has a higher performance hit on the recorded application. This is the out-of-the-box default policy. - Deep
Records extensive details of transactions and has a severe performance hit on the recorded application. Use this policy sparingly. - Standalone
Use the Standalone policy when App Visibility is not integrated with Real End User Experience Monitoring Software Edition. The settings are the same as the Light policy, except for any settings related to the integration. - Max
The Max policy fully activates all recording parameters, for use in small proof-of-concept environments. The Max policy has the following characteristics:- Overrides global and custom threshold settings to maximize the number of "interesting" transactions that are considered for capture.
- Records all types of technologies
- Uses a very short heartbeat interval so that agents are updated quickly
Choosing the right policy
- Use the Standalone policy if App Visibility is not integrated with BMC Real End User Experience Monitoring Software Edition.
- Use a Light, Medium (default), or Deep policy by evaluating the configuration settings in the following table.
The table includes a selection of significant properties in the agent policies.
Properties that are commented out (that is, begin with a # character) have a default value that is usually mentioned in the property's comment.
Comparison of Light, Medium, and Deep policies
Data recording and collection configurations | Light | Medium (default) | Deep |
---|
Percentage of total requests that are sampled by the agent sampling.rate
Valid values: 0-100 | 50 | 75 | 100 |
Time frame (in milliseconds) in which only the worst SLA breaching request is persisted persisting.single.worst.sla. breach.server.request.timeframe
| 300000 (5 minutes) | 300000 (5 minutes) | 150000 (2.5 minutes) |
Time frame (in milliseconds) in which error requests are buffered persisting.error.server. requests.timeframe
| 300000 (5 minutes) | 300000 (5 minutes) | 150000 (2.5 minutes) |
Number of different error types that can be sent in a specified time persisting.max.num.unique.errors.per.timeframe
| 3 | 6 | 12 |
List of parameters (such as HTTP parameters and headers) with values that might contain sensitive information that should be masked. Parameters are case insensitive. persisting.param.names.to.mask
Default = password, j_password, pass, pswd, authorization, passwordInput, j_id_id3:passwordInput, passwd, vpasswd For details, see Concealing sensitive data recorded by the App Visibility agents. | no list | default list | default list |
Enables global modifiers to be added to each recording rule agent.recording.global.modifiers
| executesnapin iftrimming | executesnapin iftrimming | method details |
Snapin controls | Light | Medium (default) | Deep |
---|
JDBC snapin to collect extended query data snapin.collect.extended.data.jdbc
| false | true | true |
JMS snapin to collect extended data snapin.collect.extended.data.jms
| false | false | true |
Servlet snapin to collect extended data snapin.collect.extended.data. headers.servlet
snapin.collect.extended.data. parameters.servlet
- false = Only the client user name, user IP, user browser, URL, method, request and response lengths are collected
- true = All request parameter and header names and values are collected
| false false | true true | true true |
Maximum extended data size snapin.collect.extended.max.size
Longer data is truncated. | 0 | 0 | 1024 |
Maximum number of back-to-back, same-method calls before ignoring further calls calltree.limit.duplicate. methodcalls
| 20 | 30 | 50 |
Maximum number of method calls in a server request before ignoring further calls calltree.limit.total. methodcalls
| 50 | 75 | 150 |
Determines the level of impact in terms of possible agent overhead: 1 is the lowest impact and 5 is the highest. Increased impact can provide more accurate and comprehensive results. agent.recording.mode
- 1 = brief
- 2 = light
- 3 = medium
- 4 = heavy
- 5 = verbose
To configure recording rules, contact Customer Support. | 2 | 3 | 4 |