# Threshold Monitoring

Threshold Monitoring is one of the possible **Data Analysis techniques** that Crystal can apply to Topics to **monitor changes in time**, and for which you can receive a specific [**Alert**](https://docs.igenius.ai/crystal-advisor/analyze-your-data/alerts) notification.

This is how it works.

{% hint style="warning" %} <mark style="color:orange;">**Remember**</mark>

This kind of analysis can only be applied to the following Objectives:&#x20;

* Overtime Single Line
* Highlight
  {% endhint %}

## What is Threshold Monitoring

{% hint style="success" %} <mark style="color:green;">**Pills of Data Analysis**</mark>

This type of Data Analysis focuses on **catching the exact moment** when a **value goes** **above or below a specific threshold**.&#x20;
{% endhint %}

You can use this type of Alert when you *precisely need to monitor how a specific Topic value behaves in comparison to a specific threshold value,* if and when it goes below or above it.

When you set this type of Alert, you can decide the direction of the analysis and the threshold value.

## Set a Threshold Monitoring

You can set a Threshold Monitoring by asking for it in a Conversation.

{% hint style="warning" %} <mark style="color:orange;">**Remember**</mark>

When setting a Threshold Monitoring Alert, it will be counted as an Anomaly Detection.

Currently, you can set up to 10 Anomaly Detection Alerts.
{% endhint %}

### Ask in a Conversation

You can set a Threshold Monitoring by directly asking Crystal in a conversation, either via text or voice.

Simply ask:

1. *"Notify me / advise me / let me know etc"* + *"when"*
2. Specify the Topic of interest
3. Specify Filters, if any
4. Specify the direction of comparison: *"goes above"* or *"goes below"*
5. Choose the threshold value: it can be an *absolute value* or a *percentage.*

<details>

<summary>Recommendations</summary>

Consider the following recommendations for writing the *absolute threshold value* correctly:

* the numeric value needs to be specified in full: you cannot include *“,”* or *“.”*&#x20;
  * these symbols should be used only to indicate a decimal number
* you cannot abbreviate the number
* you cannot include a currency symbol

For example, you can not specify a number like "$ 3,4K": instead, it needs to be "3400".

</details>

{% hint style="info" %} <mark style="color:blue;">**Please Note**</mark>

* Alerts are filter-sensitive, meaning that if the monitored Topic includes Dynamic Filters, it will be added to the Alert (however, this is not true for Time Range!)
* You do not need to ask the Topic of interest on the Advisor for this request to work, as Crystal will understand the scope of the request based on your question alone.
  {% endhint %}

{% hint style="success" %} <mark style="color:green;">**Examples**</mark>

* *"Notify me when sales over time by week go above 80 million"*
* *"Notify me when sales over time by week go above 80 million in Spain"*
* *“Let me know when my total sales growth rate goes under 10%”*
  {% endhint %}

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FdrTuvj5AKrESrpkwH3IX%2Fimage.png?alt=media&#x26;token=1c9eec03-4c85-445f-ac87-c949ab4dc50f" alt=""><figcaption><p>Ask for a Threshold Monitoring</p></figcaption></figure>

{% hint style="warning" %} <mark style="color:orange;">**Remember**</mark>

This capability is *only available for* [*Configured Topics*](https://docs.igenius.ai/crystal-console/topics-configuration), whereas [*Auto-generated ones*](https://docs.igenius.ai/crystal-advisor/talk-to-your-data/conversation/request-topics/entity-based-conversation) don't support it.
{% endhint %}

## Check the Activation

At this point, Crystal will give you feedback about the result of your request.

<details>

<summary>Feedback about the Request</summary>

These are the possible scenarios:

* Alert set correctly
* Alert already active
* Alert limit reached
* Threshold already reached
* Technical errors (not enough data, not applicable, no network, etc...)
* [Disambiguation](https://docs.igenius.ai/crystal-advisor/talk-to-your-data/conversation/disambiguation): choose the correct Topic to continue

</details>

To make sure that the Alert was set correctly, check that it's active in your Account's [Alerts](https://docs.igenius.ai/crystal-advisor/analyze-your-data/alerts) Section.

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2F64JiOeVc7oL7hFZRVCua%2Fimage.png?alt=media&#x26;token=135ea60d-965f-4bf3-a369-81a9322abe0b" alt="" width="563"><figcaption><p>Check for Alert Activation</p></figcaption></figure>

Once the Threshold Monitoring is active, just wait until the threshold is actually reached.

## Receive a Notification for a Threshold Reached

If the threshold is actually reached, you'll receive a notification in the Notification Center.

{% hint style="info" %} <mark style="color:blue;">**Please Note**</mark>

Sometimes you won't receive any Threshold Monitoring notifications because your data did not undergo relevant changes (and that can be good news!)
{% endhint %}

Let's see what happens in this case:

1. When the notification arrives, open the Notification Center and read it. This notification signals that a variation in the data linked to the threshold has been detected.

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FN48rYA6QTjPVNQf8dL5U%2FScreenshot%202024-03-21%20at%2011.39.35.png?alt=media&#x26;token=5466b83f-b15c-4ce2-9fe3-4c5e88a069b8" alt="" width="393"><figcaption><p>Threshold Reached</p></figcaption></figure>

2. To delve deeper, simply tap on the notification and you will be redirected to the Advisor.
3. You will now see the Topic monitored with an intro message that accurately describes *when and how the values reached the threshold.* Read the text and explore the analysis!

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FjMKmTTdJgfcxFWEYxunU%2FScreenshot%202024-03-21%20at%2011.41.17.png?alt=media&#x26;token=fe9acbca-9e30-4311-aea5-f48dba1191ab" alt=""><figcaption><p>Threshold Reached</p></figcaption></figure>

Explore your analysis to **quickly** **adapting to the turns of events,** and ultimately make better decisions!

## How Does It Work?

Once a Threshold Monitoring Alert is set, Crystal simply keeps in memory the conditions that need to be monitored and is able to catch the exact moment when the values meet the threshold.

#### Rules&#x20;

* Threshold Monitoring is available for the **Overtime Single Line** and **Highlight** Objectives.

#### Limitations

* Limit of **10** Anomaly Detection Alerts running at a time (Threshold Monitoring is counted as an Anomaly Detection).
* Threshold Monitoring can be requested on **one Topic** at a time only.
* At the moment, it is not possible to **edit** Alerts yet. If you need to modify the details of your Threshold Monitoring, please delete the Alert first and create a new one.
* **Be careful** when modifying or deleting a Topic with an active Threshold Monitoring, as this may impact the outcome of Crystal's monitoring.

Keep analyzing your data!

***