Page tree

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