Maintenance outage for upgrade on Sunday, September 22

This site, docs.bmc.com, will be inaccessible for two hours starting at 8 AM CDT, Sunday, September 22, for a platform upgrade.

    Page tree
    Skip to end of metadata
    Go to start of metadata

    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