# Alerts

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FRV5fN0EQEW69VgCmWABT%2FScreenshot%202024-03-20%20at%2010.53.01.png?alt=media&#x26;token=3e6015cd-8a38-4cf2-af07-e563ac17dd49" alt=""><figcaption><p>Alerts</p></figcaption></figure>

By nature, **data changes over time**.&#x20;

For this reason, in order to have a clear understanding of data, it is crucial to capture all its changes and fluctuations.

Of course, Crystal can do this for you!&#x20;

Crystal is able to **monitor** data fluctuations, in order to **spot relevant events** and to **warn you about them** through an **"Alert"** notification, in the case of an unexpected event.&#x20;

All you have to do is **select a Topic** of interest and activate it by **choosing a specific kind of Alert** from the options available.&#x20;

Alerts are useful to stay **constantly** **updated, informed, and in control** of your data, without the need to worry about searching manually.

Here's an overview of the Alerts available and how to use them.

## Alert Types

There are three types of Alert options on Crystal. Each of them correspond to **specific Data Analysis techniques** that can be applied on the chosen Topic.

### **Anomaly Detection** <a href="#adaptive-alerts" id="adaptive-alerts"></a>

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

Anomaly Detection is a Data Analysis technique used to **identify patterns or occurrences that deviate** significantly from the usual or expected behavior of the given dataset.&#x20;

Some types of anomalies can be **errors**, **outliers**, or **unusual patterns**.
{% endhint %}

You can use this type of Alert when you don’t have a specific data change in mind but want to *keep an eye* *on* a specific Topic in general.&#x20;

After setting this type of Alert, Crystal’s expertise will determine which kind of anomaly can be found, among several types of anomalies possible.&#x20;

### **Threshold Monitoring** <a href="#static-threshold-alerts" id="static-threshold-alerts"></a>

{% 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 %}

Using this type of Alert is most appropriate when you *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.

### **Topic Scheduling** <a href="#h_cc81f03935" id="h_cc81f03935"></a>

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

This type of Data Analysis is focused on **obtaining instant** **snapshots** of data at **specific** **moments in time**.
{% endhint %}

Using this type of Alert is most appropriate if you need to be notified on a Topic in order to *compare its status at different moments in time*.

When you set this type of Alert, you can decide when and how often you should receive the reports you're programming.&#x20;

## **Set an Alert** <a href="#how-to-set-an-alert" id="how-to-set-an-alert"></a>

In general, there are two alternative methods to set Alerts:

* By asking Crystal in a **Conversation** (textual or vocal)
* By setting it from the **Topic Card** of a selected Topic (clicking on the relative icon)

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

As of now, different kinds of Alerts support different activation methods.

You can find a recap in the following table.
{% endhint %}

| Alert Type               | Conversational Method                 | Topic Card Method                     |
| ------------------------ | ------------------------------------- | ------------------------------------- |
| **Anomaly Detection**    | <mark style="color:green;">Yes</mark> | <mark style="color:green;">Yes</mark> |
| **Threshold Monitoring** | <mark style="color:green;">Yes</mark> | <mark style="color:red;">No</mark>    |
| **Topic Scheduling**     | <mark style="color:red;">No</mark>    | <mark style="color:green;">Yes</mark> |

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

* Currently, the maximum amount of Alerts that you can set is *20:* 10 Anomaly Detections and 10 Topic Scheduling
* Threshold Monitoring counts as an Anomaly Detection
* The Topic Card method applies to both [*Configured Topics*](https://docs.igenius.ai/crystal-console/topics-configuration) and [*Auto-generated ones*](https://docs.igenius.ai/crystal-advisor/talk-to-your-data/conversation/request-topics/entity-based-conversation), whereas the Conversational method applies to Configured Topics only
  {% endhint %}

## **Manage Active Alerts** <a href="#h_4e5127cb92" id="h_4e5127cb92"></a>

After setting your Alerts, you can always check and manage them as you need.

All of your **Active Alerts** can be found in the **Alert Section**, accessible from your **Account,** as follows:&#x20;

1. Open the *Account Section*
2. Open the *Alert Section,* where you'll see the total number of Active Alerts at a glance

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2F02WNJbY059NiVKVfKT2x%2FScreenshot%202024-03-20%20at%2012.49.25.png?alt=media&#x26;token=65e964af-ab08-49c7-bb27-1eda29d19a9d" alt="" width="563"><figcaption><p>Steps 1, 2</p></figcaption></figure>

3. [**Check** your Alerts. You can find the full list of Active Alerts and all the relative settings and details (e.g. threshold values, frequencies of occurrence, etc.)](#user-content-fn-1)[^1]

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

Alerts are divided between Anomaly Detection (which also includes Threshold Monitoring) and Topic Scheduling.
{% endhint %}

4. **Search** for your Alert. If you want to quickly find a specific Alert, you can use the Search Bar
5. Finally, you can **delete** Alerts by clicking on the corresponding icon within the selected Alert Card. A pop-up will appear to confirm that you want this Alert deleted.&#x20;

<figure><img src="https://2516160394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmAOqTQkYofJrevcpklA7%2Fuploads%2FitmaTVByGTLO7acg24RF%2FScreenshot%202024-03-20%20at%2012.50.47.png?alt=media&#x26;token=75e63a26-9865-4562-b3ca-3dcf982ba475" alt="" width="239"><figcaption><p>Steps 3, 4, 5</p></figcaption></figure>

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

At the moment, it is not possible to **edit** Alerts yet.

If you need to modify an existing Alert, please delete it first and create a brand new one.
{% endhint %}

## **Receive an Alert Notification** <a href="#how-to-set-an-alert" id="how-to-set-an-alert"></a>

When an event of interest takes place or if a scheduled time has come, Crystal will send you a notification about it. Just click on it to discover what happened!

This way, you will always be **updated on your data in real time** and you will be able to **quickly** **adapt your decisions to the turns of events**.&#x20;

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

If you are using the Crystal app, be sure to turn on push notifications, so that you don't miss any Alerts.
{% endhint %}

Now, let's dive deeper, with a concrete example. Choose an Alert of your interest to see the full experience!

***

## Deep-Dive!

{% content-ref url="alerts/alerts" %}
[alerts](https://docs.igenius.ai/crystal-advisor/analyze-your-data/alerts/alerts)
{% endcontent-ref %}

{% content-ref url="alerts/alerts-1" %}
[alerts-1](https://docs.igenius.ai/crystal-advisor/analyze-your-data/alerts/alerts-1)
{% endcontent-ref %}

{% content-ref url="alerts/alerts-2" %}
[alerts-2](https://docs.igenius.ai/crystal-advisor/analyze-your-data/alerts/alerts-2)
{% endcontent-ref %}

[^1]: suggestion: let's delete this, the part about the details can be added in 2. what do you say?
