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

    You can configure the App Visibility agent to collect data for stack traces that exceed thresholds. In the TrueSight console, you can see the results by viewing a trace at the code level.

    Adjust the following parameters in the Agent Policy file to define stack traces that exceed thresholds (also called retrotraced methods).

    Parameters that control stack traces for exceeded thresholds

    Parameter

    Default value

    Description

    persisting.threshold.retrotrace

    true

    If true, when a threshold is exceeded, the entire stack from the beginning of the request, to the method where the threshold is crossed, is added to the call tree. The methods in the stack do not contain full method information, such as start time, end time, and arguments.

    If false, the feature is disabled and a stack trace is not recorded when a threshold is crossed.

    persisting.threshold.retrotrace.method2

    Java, only:

    If set to 1, the stack trace is captured when the first recorded method is encountered after the request has crossed the threshold. This is the default setting of the Light policy.

    If set to 2, all executing threads are sampled at the frequency defined by presisting.retrtotrace.granularity and the stack trace is captured when the threshold is crossed.

    persisting.retrotrace.granularity

    500

    Java: Frequency (in milliseconds) of the stack trace sampling, relevant when persisting.threshold.retrotrace.method=2.

    .NET: Frequency (in milliseconds) of the stack trace sampling, relevant when persisting.threshold.retrotrace=true.

    persisting.retrotrace.min.threshold

    2000

    Java: The threshold when persisting.threshold.retrotrace.method=2.

    .NET: The threshold when persisting.threshold.retrotrace=true.

    Related topics

    Modifying an App Visibility agent policy

    Configuring an App Visibility agent policy to collect and monitor application information

    Method trimming and stack traces