Modifying the request threshold value

The request threshold is a global threshold for request latency. Requests taking longer than this value will be considered for capture. Requests taking less time than this value are not be captured, unless the requests are tagged.

The request threshold is defined in the recording.regulator parameters of the BMC Application Diagnostics Agent policy file.

The recording.regulator.filters parameter is used to filter persisted requests. There are two types of thresholds:

• staticThreshold (default)
   This is a global static threshold that is used for all entry points. This value is expressed in milliseconds. The default is 2000 (2 seconds).

• lastSampleWeight
   This is a dynamic threshold calculated per entry point. Each entry point's threshold is continuously calculated based on an approximated average duration of requests made in the specific entry point.
  
  This dynamic threshold is determined by an algorithm that uses the ratio and excess  parameters to calculate new averages.
  • recording.regulator.lastSampleWeight.ratio=
     The weight ratio between the previous average and duration of the last sample.
    A lower ratio will give a higher weight to the current sample, and will cause the average to change faster. The default is 1000.

• 
  
  • recording.regulator.lastSampleWeight.excess=
     Excess determines how much higher than the average a request’s duration has to be, in order to record the request. Excess is expressed as a percentage. For example, if the current average is 1000 ms, and the excess is 20 percent, then only requests with a duration of over 1200 ms will be recorded.

This topic presents instructions to modify the request threshold value:

• • To select and modify staticThreshold
  • To select and modify lastSampleWeight
  • Excess
  • Related topics

To perform this procedure, you must have Administrator-level access, or higher, or have tenant Application Owner-level access.

To select and modify staticThreshold

1. In the BMC Application Diagnostics Agent policy file, locate the following parameter:

   recording.regulator.filters=staticThreshold

2. To modify the static value of the threshold, locate the following property, and enter a higher or lower value.

   recording.regulator.staticThreshold.threshold=2000
   

To select and modify lastSampleWeight

1. In the BMC Application Diagnostics Agent policy file, locate the following parameter:

   recording.regulator.filters=staticThreshold
2. Delete staticThreshold and enter lastSampleWeight to change the threshold.

3. To change the ratio between the last average and the current sample, locate the following property, and modify the value to a higher or lower value.

   recording.regulator.lastSampleWeight.ratio=1000

Excess

If you have selected to use the lastSampleWeight threshold, you can also set the excess. Excess determines by how much the duration of a request must exceed the calculated average for it to be collected. Excess is reflected as a percentage. The default is 20.

Locate the following property, and modify the excess value to a higher or lower value.

Related topics

Creating-and-editing-an-Agent-policy-file
Configuring-persistence-of-tagged-transactions
Applying-a-policy-to-an-Agent
Setting-a-default-Agent-Policy