# KPI alerts

KPI Alerts are very useful for improving the overview of your project. A KPI Alert will change the look of your chart if a certain expression is true. This allows you to see immediately if something significant is happening in your project.

If you would like to configure KPI alerts, simply click on the 'KPI Alert' option. Here, you can define alerts based on specific conditions being met. For example, you can add a selector such as a specific status. Next, select your desired comparison operator, such as 'greater than', and add a number. This will create an expression like 'In Progress > 3'.

To customize the appearance of your KPI alert, choose the colour you want the bar or pie to have when the expression is true. Finally, to save your alert, simply click on the plus sign next to it.\
 

<figure><img src="/files/KqcAWBMCBk5b9ZY1G8wO" alt=""><figcaption><p>Creating a KPI alert</p></figcaption></figure>

To save your chart, simply click on the 'Save' or 'Save & Close' button. Once you have done this, your first chart will be visible on your dashboard.

{% hint style="success" %}
If you do not wish to define warning colours for specific values being exceeded, but instead want to define the colours of the statuses in general (or any other field you are grouping by), you can easily create a KPI alert for each status. In this case, you would use the logical expression ">=1" and specify the desired colour for that particular status.
{% endhint %}

It is important to note that when grouping by the status of the last test case execution, the expected colours are automatically applied. For example, green for passed, red for failed, and so on.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aqua-cloud.io/documentation/dashboards/kpi-alerts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.