# Monitoraggio di Soglia

Il Monitoraggio di Soglia è una delle possibili tecniche di **Analisi dei Dati** che Crystal può applicare ai Topic per **monitorare i cambiamenti nel tempo** e per i quali è possibile ricevere una notifica di [**Avviso**](https://docs.igenius.ai/italiano/crystal-advisor/analizza-i-tuoi-dati/avvisi) specifica. 

Vediamo come funziona!

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

Questo tipo di analisi può essere applicato solo ai seguenti Obiettivi:&#x20;

* Overtime Single Line
* Highlight
  {% endhint %}

## Cos'è il Monitoraggio di Soglia

{% hint style="success" %} <mark style="color:green;">**Pillole di Analisi Dati**</mark>

Questo tipo di Analisi Dati si concentra sull'**individuare l'istante preciso** in cui un **valore supera o scende al di sotto di una soglia specifica**.
{% endhint %}

Utilizzare questo tipo di Avviso è più adatto quando si sa *esattamente che è necessario monitorare come si comporta un valore specifico di un Topic rispetto a un valore di soglia specifico:* in particolare, per capire se e quando scende al di sotto o al di sopra di esso.

Quando imposti questo tipo di Avviso, sei in grado di decidere la direzione dell'analisi e il valore della soglia.

## Attiva un Monitoraggio di Soglia

Puoi impostare un Monitoraggio di Soglia chiedendolo a Crystal tramite la Conversazion&#x65;**.**

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

Quando imposti un Avviso di Monitoraggio della Soglia, questo verrà conteggiato come un Rilevamento di Anomalia.&#x20;

Attualmente, il numero massimo di Avvisi di Rilevamento di Anomalie che puoi impostare è 10.
{% endhint %}

### Chiedi in Conversazione

Puoi impostare un Monitoraggio di Soglia chiedendo direttamente a Crystal attraverso la conversazione, sia tramite testo che a voce.

Basta chiedere:

1. *"Mandami una notifica / avvisami / fammi sapere etc"* + *"quando"*
2. specifica il Topic di interesse
3. specifica, se vuoi, dei Filtri&#x20;
4. specifica la direzione del confronto: *"supera"* o *"scende sotto"*
5. indica il valore della soglia: può essere un *valore assoluto* o una *percentuale*

<details>

<summary>Raccomandazioni</summary>

Considera le seguenti raccomandazioni per scrivere il *valore assoluto* della soglia correttamente:

* il valore numerico deve essere specificato per intero: non è possibile includere virgole o punti
  * questi simboli devono essere usati solo per indicare un valore decimale
* non è possibile abbreviare il numero
* non è possibile includere il simbolo di valuta

Ad esempio, non è possibile specificare un numero come *"3,4K* €*",* deve essere indicato come "3400".

</details>

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

* Gli Avvisi sono sensibili ai filtri, il che significa che se al Topic monitorato sono stati applicati dei Filtri Dinamici, esso verrà aggiunto all'Avviso (tuttavia, questo non vale per i Filtri Temporali)&#x20;
* Non è necessario chiedere il Topic di interesse in Advisor perché questa richiesta funzioni, in quanto Crystal capirà il Topic richiesto in base alla domanda
  {% endhint %}

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

* *"Avvisami quando le vendite settimanali superano gli 80 milioni"*&#x20;
* *"Avvisami quando le vendite settimanali in Spagna superano gli 80 milioni"*&#x20;
* *"Fammi sapere quando il tasso di crescita delle vendite totali scende sotto al 10%"*
  {% endhint %}

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2Fps84AxycfGWEXV5RtwaR%2Fimage.png?alt=media&#x26;token=2f23c182-f66d-4478-9ddc-4b5cabca8f4c" alt=""><figcaption><p>Chiedi un Monitoraggio di Soglia</p></figcaption></figure>

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

Questa funzionalità è *disponibile solo per i Topic Configurati*, cioè quelli [creati manualmente dall'Admin](https://docs.igenius.ai/italiano/crystal-console/topics), mentre per i [Topic Auto-generati](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/richiedi-i-topic/conversazione-basata-su-entita) non è supportata.
{% endhint %}

## Controlla l'Attivazione

A questo punto, Crystal ti darà un feedback sull'esito della richiesta.

<details>

<summary>Feedback sulla Richiesta</summary>

Questi sono gli scenari possibili:&#x20;

* Avviso impostato correttamente
* Avviso già attivo&#x20;
* Limite di Avvisi raggiunto
* Soglia già raggiunta
* Errori tecnici (dati insufficienti, non applicabili, rete assente, ecc.)
* [Disambiguazione](https://docs.igenius.ai/italiano/crystal-advisor/parla-con-i-tuoi-dati/conversazione/disambiguazione): scegli il Topic corretto per continuare

</details>

Per assicurarti che l'Avviso sia stato impostato correttamente, puoi controllare anche nella Sezione [Avvisi](https://docs.igenius.ai/italiano/crystal-advisor/analizza-i-tuoi-dati/avvisi) del tuo Account: dovrebbe essere presente tra gli altri Avvisi attivi.

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FtYM5su9Jn6a7ruhwAO8C%2Fimage.png?alt=media&#x26;token=2edfc2e8-ffd0-46e3-be1e-6ae43a3face3" alt="" width="563"><figcaption><p>Controlla l'Attivazione dell'Avviso</p></figcaption></figure>

Una volta che il Monitoraggio della Soglia è attivo, basta attendere che la soglia venga effettivamente raggiunta.

## Ricevi una Notifica di Raggiungimento di Soglia

Se la soglia viene effettivamente raggiunta, riceverai una notifica nel Centro Notifiche.&#x20;

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

A volte potresti non ricevere alcuna notifica di Monitoraggio Soglia: non preoccuparti, significa solo che i tuoi dati non hanno subito modifiche rilevanti (e questa può essere una buona notizia!).
{% endhint %}

Vediamo cosa succede in questo caso:&#x20;

1. quando arriva la notifica, apri il Centro Notifiche e leggi la notifica: questa notifica ti segnala che è stata rilevata una variazione nei dati legati alla soglia

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FPZPKg3Bzrca14umg2iCn%2Fimage.png?alt=media&#x26;token=b2f7bdb5-9ef4-4d61-b706-f6780211b6ec" alt="" width="393"><figcaption><p>Soglia Raggiunta</p></figcaption></figure>

2. per saperne di più, apri la notifica: in questo modo, sarai reindirizzato all'Advisor&#x20;
3. ora vedrai il Topic monitorato con un messaggio introduttivo che descrive *quando e come i valori hanno raggiunto la soglia*: leggi il testo ed esplora l'analisi!

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FEpkuVXcW6UrPtsrpVIku%2Fimage.png?alt=media&#x26;token=16880d07-8ae6-45e1-bfad-58d06b5836ad" alt=""><figcaption><p>Soglia Raggiunta</p></figcaption></figure>

Ecco fatto: ora sei in grado di prendere decisioni migliori, **adattandoti rapidamente ai cambiamenti degli eventi**!

## Come Funziona?

Una volta impostato un Avviso di Monitoraggio della Soglia, Crystal tiene semplicemente in memoria le condizioni da monitorare ed è in grado di cogliere il momento esatto in cui i valori raggiungono la soglia.&#x20;

#### Regole&#x20;

* Il Monitoraggio della Soglia è disponibile per gli obiettivi **Overtime Single Line** e **Highlight**

#### Limitazioni&#x20;

* Limite di **10** Avvisi di Rilevamento di Anomalie in corso alla volta (il Monitoraggio Soglie viene conteggiato come un Rilevamento di Anomalie)
* Il Monitoraggio Soglie può essere richiesto solo per **un Topic** alla volta
* Al momento non è ancora possibile **modificare** gli Avvisi: se hai bisogno di modificare i dettagli del tuo Monitoraggio Soglie, è consigliabile cancellare prima l'Avviso e crearne uno nuovo
* **Fai attenzione** a modificare o cancellare un Topic su cui è attivo un Monitoraggio Soglie perché questo potrebbe avere un impatto sull'esito del monitoraggio di Crystal

Rimani aggiornato sui tuoi Topic!

***