Configuring stack traces for exceeded thresholds (agent for Java)
This topic describes configuration parameters for the BMC Application Diagnostics Agent for Java to collect data for stack traces that exceed thresholds.
Adjust the following parameters in the agent policy file to define stack traces that exceed thresholds (also called retrotraced methods):
Parameter | Description |
|---|---|
persisting.threshold.retrotrace Default value = 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.method Default value:
| If set to 1, the stack trace is captured when the first recorded method is encountered after the request has crossed the threshold. 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. |
presisting.retrtotrace.granularity Default value = 500 | Frequency (in milliseconds) of the stack trace sampling, relevant when persisting.threshold.retrotrace.method=2 |
presisting.retrtotrace.min.threshold Default value = 2000 | The threshold when persisting.threshold.retrotrace.method=2 |
Related topic