Configuring threshold for Apdex score

You can configure the threshold value for Apdex score calculation. The default threshold value is 3 seconds.

About this task

The Apdex score is a ratio value of the number of satisfied and tolerating requests to the total requests made. An Apdex score varies from 0 to 1, with 0 as the worst possible score (100% of response times were Frustrated), and 1 as the best possible score (100% of response times were Satisfied).

Explanation with example:

User sets the threshold value in KQ7_agent.properties file as 0.1seconds:ResponseTime.Threshold=0.1

Based on the threshold value configured by user, the agent calculates the maximum threshold value by multiplying the threshold value by 4.
Hence,
  • Minimum threshold value=0.1 seconds
  • Maximum threshold value=0.1 * 4 = 0.4 seconds
Subsequently, the agent derives the Apdex levels based on the minimum and maximum threshold values.
Apdex Level Time duration (T)
Satisfied <=0.1 seconds
Tolerating In between 0.1 and 0.4 seconds
Frustrating >0.4 seconds

  • If a request execution is completed in less than or equals 0.1 seconds, it is classified as Satisfied.
  • If a request execution is completed between 0.1 and 0.4 seconds, it is classified as Tolerating.
  • If a request execution is completed in more than 0.4 seconds, it is classified as Frustrating.

Formula to calculate Apdex score:

Apdex Score = satisfiedCount+(toleratingCount*0.5) + (frustratedCount*0))/totalSamples;

where,
  • Satisfied count, tolerating count and frustrated count is calculated based on the threshold value set by user.
  • Satisfied count = Count of requests that are executed in less than time T or equal to T (threshold value).
  • Tolerating count = Count of requests that are executed in between T and 4T.
  • Frustrated count= Count of requests that are executed in greater than 4T time.
  • Total samples = Total number of requests executed.
    Note: Apdex score of requests executed in last 15 minutes.

Procedure

On the agent machine, modify the threshold value in the %CANDLE_HOME%\TMAITM6_x64\KQ7_agent.properties file.
Example of KQ7_agent.properties:
#Threshold value is in seconds
ResponseTime.Threshold=3

Results

On UI, the Apdex score attribute is showed on the last column of group widget.
Initial Apdex score is showed as Not_Available when request execution is in progress.
Apdex score is calculated for requests executed in the last 15 minutes.
Note: If there is no data available in group widget, the Apdex score column shows Not_Available.