IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1
Enable_Auto_Threshold: set threshold parameters
To set automatic threshold parameters, and remove any overrides of the thresholds, use the Take Action...
The baselining process supplies statistical information about request response times. ITCAM interprets this information to set automatic thresholds. If the baselining process was run recently, and...
- Default thresholds are not adequate, with a lot of false alarms or warnings, you can raise the bad or fair threshold.
- Alarms and warnings are not triggered when needed, you can lower the bad or fair threshold.
To set threshold parameters for all requests in an application, select the application in either...
To set threshold parameters for all requests of a given type in an application, select the request type in the Application Request Configuration table in...
To set threshold parameters for an individual request, select the request in...
Selecting a line representing a request displays bar charts representing statistical data for the request gathered during the baselining process. Changing the parameters using Enable_Auto_Threshold immediately alters the charts.
The Response Times Distribution chart shows the statistical distribution of response times for this request. To the left are smaller (faster) response times; to the right, larger (slower) ones. The height of every bar shows the percentage of requests that had the indicated response time during the baselining period.
Some bars represent bigger time intervals than others; more bars are devoted to most common response times. For example, if the maximum encountered time is 1000 ms but most response times are between 300 and 500 ms, then the first bar may be 0 to 50 ms, but there may also be bars like 305 to 310 ms and 400 to 402 ms.
The bars colored blue show the zone into which the "typical" response times for this application fall. The green bars show response times that are not "typical", but are below the fair threshold. Response times above the fair threshold but below the bad threshold are shown as yellow bars; for those above the bad threshold, the bars are red.
Use the Enable_Auto_Threshold take action to set the parameters that affect both the position of the "typical" zone and the way the thresholds are derived from this zone.
For more information about how the bar chart and parameters work, see Threshold calculation detail.
The Level2 Delays Distribution chart shows the distribution of time spent in "nested requests" within the requests that had this response time range. Each bar represents a response time of the top-level request (the same as on the top chart). Within this bar, colored sections show how much time is spent within nested requests of different types; the color legend is shown on the bar. ITCAM will use this distribution within the selection zone (that is for typical overall request types)
to work out the average share of time that each nested request type takes. When an error or warning arises, ITCAM will check which of the request types takes more than its usual share of time; based on this, it will display whether the likely cause is the application, backend, or server.
Command syntax
YN:Enable_Auto_Threshold App_Id Request_Id Auto_Threshold_Percent Auto_Threshold_Deviation Auto_Threshold_Fair_Projection Auto_Threshold_Bad_Projection Use_Default
Parameters:
App_Id
The application ID, automatically assigned in the portal from the selection context when Take Action was invoked.
Request_Id
The request ID, automatically assigned in the portal from the selection context when Take Action was invoked.
Auto_Threshold_Percent
Auto_Threshold_Deviation
Calculate the borders of the "typical zone". See Threshold calculation detail.
Auto_Threshold_Fair_Projection
Determines of the fair threshold. Increase this parameter to increase the fair threshold; decrease the parameter to decrease the fair threshold. If the parameter is set to 100, the fair threshold will be at the right border of the selection zone. For details, see Threshold calculation detail. The bad threshold is not affected.
Auto_Threshold_Bad_Projection
Determines of the bad threshold. Increase this parameter to increase the bad threshold; decrease the parameter to decrease the bad threshold. If the parameter is set to 100, the bad threshold will be at the right border of the selection zone. For details, see Threshold calculation detail. The fair threshold is not affected.
Use_Default
If set to 0, the auto threshold settings will be modified according to the other parameters in this Take Action. If set to 1, the value of the auto threshold settings for this request will be taken from the "parent": the values that have been set for the request type, for the entire application, or the ITCAM default values.
Example:
YN:Enable_Auto_Threshold 1 12 50 200 150 300 0