## Overview

AApplication Performance Index (Apdex) is a standardized metric used to measure and quantify user satisfaction with the response time of software applications. It provides a numerical score on a scale of 0 to 1, where a score of 0-0.74 is considered poor, 0.75-0.84 is fair, 0.85-0.94 is good, and 0.95-1 is excellent.

Apdex takes into account the response time threshold, categorizing user interactions as satisfied, tolerated, or frustrating based on a predefined performance threshold. This metric is particularly valuable for organizations and developers in assessing and optimizing application performance, as it offers a concise and standardized way to communicate and benchmark user satisfaction with application responsiveness.

## How it works

An Apdex score is calculated using a simple formula that involves defining a response time threshold and then categorizing "Satisfied" user requests based on those thresholds. The formula is as follows:

In this formula, request satisfaction is categorized as follows:

- **Satisfied requests**: The response time is less than or equal to T (Threshold).
- **Tolerated requests**: The response time is greater than T and less than or equal to 4T.
- **Frustrated requests**: The response time is greater than 4T or the request returns a server-side error (not shown in the formula).
- **Total requests**: The total number of requests.

## Configure response time threshold

The threshold (T) is used to calculate Apdex and classify requests as satisfactory (≤ T), tolerated (> T and ≤ 4T), or frustrated (> 4T). For example, if T = 2 seconds, then 0–2s is satisfactory, 2–8s is tolerated, and ≥ 8s is frustrated. Apdex then produces a score from 0 to 1, where values closer to 1 indicate higher user satisfaction.

For example, if the threshold is 0.5 seconds (default value), it produces the following response times:

- 0 - 0.5 seconds: **Satisfied**
- 0.51 - 2 seconds: **Tolerated**
- 2+ seconds: **Frustrated**

To configure response time threshold for your service:

1. In your Coralogix toolbar, navigate to **APM**, then **Service Catalog**.

1. Select a service to view the Overview widgets.

1. From the **Apdex score** widget, select **Threshold**.

1. Select the threshold and unit for the Apdex score.

   The Latency graph shows your selected threshold along with the P99, P95, P75 and Average latencies, enabling you to see how the threshold compares with the current latency of your service.

   This graph offers a clear context to evaluate the appropriateness of your threshold. For instance, setting a threshold of 5 seconds for services with a p99 latency of 1 second can be overly tolerant, indicating a need for a more stringent threshold.

1. Select **Save changes**.

## When Apdex cannot be calculated

If your service's duration histogram is missing the threshold bucket (`le=T`) or its 4× counterpart (`le=4T`), the **Apdex score** widget cannot run the calculation and shows an empty state in place of a score.

To resolve this, configure your collector so both `T` and `4T` are present in the histogram bucket list. For the full setup, see [Apdex settings](https://coralogix.com/docs/user-guides/apm/getting-started/span-metrics-recommended-configuration/#apdex-settings) under Span Metrics configuration.

## Next steps

Compare Apdex across releases by enabling [Group by service version](https://coralogix.com/docs/user-guides/apm/features/group-by-service-version/index.md).

## Additional resources

|               |                                                                                                                                                                                                    |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Documentation | [APM](https://coralogix.com/docs/user-guides/apm/getting-started/apm-onboarding-tutorial/index.md) [Service Catalog](https://coralogix.com/docs/user-guides/apm/features/service-catalog/index.md) |
| Blogs         | [Apdex Score: Calculation, Pros/Cons & 5 Ways to Improve Yours - Coralogix](https://coralogix.com/guides/real-user-monitoring/apdex-score/)                                                        |

## Support

**Need help?**

Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.

Feel free to reach out to us **via our in-app chat** or by sending us an email at [support@coralogix.com](mailto:support@coralogix.com).
