# Rilevamento di Anomalia

Il Rilevamento di Anomalia è 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.&#x20;

Vediamo come funziona!

## Cos'é il Rilevamento di Anomalia&#x20;

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

Il Rilevamento di Anomalia è una tecnica di Analisi Dati utilizzata per **identificare pattern o eventi che si discostano** significativamente dal comportamento abituale o previsto del dataset fornito.&#x20;

Alcuni esempio di anomalie possono essere **errori, valori anomali o pattern insoliti.**
{% endhint %}

Puoi utilizzare questo tipo di Avviso quando non hai in mente quale cambiamento specifico aspettarti dai tuoi dati, ma sei interessato a *tenere d'occhio* un determinato Topic.&#x20;

Dopo aver impostato questo tipo di Avviso, sarà Crystal a determinare quale tipo di Anomalia riportare, fra le varie possibili, in base alla sua capacità di analisi.

## Attiva un Rilevamento di Anomalia

Per impostare un Rilevamento di Anomalia, hai due metodi alternativi:

* chiedendolo a Crystal tramite la [**Conversazione**](#chiedi-in-conversazione) (testuale o vocale)&#x20;
* impostandolo dalla [**Topic Card di interesse**](#attiva-dalla-topic-card) (cliccando sull'icona relativa)&#x20;

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

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

### Chiedi in Conversazione

Puoi impostare un Rilevamento di Anomalia chiedendo direttamente a Crystal attraverso la conversazione, via testo o a voce.&#x20;

Basta chiedere:&#x20;

1. *"Mandami una notifica / avvisami / fammi sapere etc"* + *"su", "riguardo a", etc.*
2. specifica il Topic di interesse
3. opzionalmente, specifica dei Filtri se vuoi

{% 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 sull'andamento settimanale delle vendite"*
* *"Tienimi aggiornato sull'andamento settimanale delle vendite per l'Italia"*
  {% endhint %}

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FenLazvIFQJyq5GD6YJ5f%2Fimage.png?alt=media&#x26;token=e8d8cb02-7445-4b71-b7e6-75c274976243" alt=""><figcaption><p>Chiedi un Rilevamento di Anomalia</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 %}

### Attiva dalla Topic Card

Puoi impostare un Rilevamento di Anomalia anche dalla Topic Card, in questo modo:&#x20;

1. chiedi il Topic che desideri monitorare&#x20;
2. una volta che il Topic richiesto viene visualizzato nell'Advisor, naviga nella Topic Card e clicca sull'icona *"Avvisa"* in basso&#x20;
3. scegli il tipo di Avviso corretto - quello *"Anomalia rilevata"*&#x20;
4. clicca su *"Seleziona"* per avviare il Rilevamento anomalie sul Topic scelto

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FEr1qC9z4LQKCcdAYr0mX%2Fimage.png?alt=media&#x26;token=32fcc3ba-bea7-43a9-8d6b-036a45daabcc" alt=""><figcaption><p>Attiva un Rilevamento di Anomalia dalla Topic Card</p></figcaption></figure>

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

Questa funzionalità è *disponibile sia per i* [*Topic Configurati*](https://docs.igenius.ai/italiano/crystal-console/topics), che 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).
{% endhint %}

## Controlla l'Attivazione

In entrambi i casi, indipendentemente dal metodo di attivazione scelto, 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&#x20;
* 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 (se richiesto in Conversazione)

</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 Rilevamento di Anomalie è attivo, basta attendere che venga effettivamente rilevata un'anomalia.

## Ricevi una Notifica di Anomalia Rilevata

Se viene effettivamente rilevata un'anomalia, 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 Rilevamento Anomalie: 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 (di qualsiasi tipo)

<figure><img src="https://242936509-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnKpOPNK55hq8nWnuDD%2Fuploads%2FVUaxvAU9sw4gM09RlZga%2Fimage.png?alt=media&#x26;token=f90a2dab-56ea-42f5-a347-5b7a8ae1f03c" alt="" width="381"><figcaption><p>Anomalia Rilevata</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 *quale tipo di anomalia è stata rilevata*: 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%2Fctnau4YIAwjtClzq5bh9%2Fimage.png?alt=media&#x26;token=1579652e-0753-41f1-ac4f-eeb3bb9d1ad2" alt=""><figcaption><p>Descrizione dell'Anomalia</p></figcaption></figure>

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

## Come Funziona?

Vediamo brevemente come Crystal rileva le anomalie.&#x20;

Una volta impostato un Avviso di Rilevamento Anomalie, Crystal acquisisce immediatamente una prima **istantanea dei dati (Data Snapshot)**, ossia una fotografia dello stato del dataset alla base del Topic.&#x20;

Questo primo Data Snapshot rappresenta il punto di partenza da cui Crystal **controllerà tutte le modifiche storiche** all'interno di tutte le Entità del Topic.&#x20;

Per verificare le modifiche storiche, Crystal applica una strategia che **modula la frequenza dei controlli** in base alla frequenza delle modifiche osservate.&#x20;

Ad esempio, se si osservano modifiche frequenti dei dati, Crystal continuerà a controllare con una certa frequenza, mentre se i dati non cambiano molto, la frequenza diminuirà.

#### Regole

* Il Rilevamento delle Anomalie è disponibile per **tutti gli Obiettivi di Topic esistenti**
* Per ogni Obiettivo, Crystal è in grado di rilevare un'**ampia gamma di possibili anomalie**
* Se Crystal rileva **più di un'anomalia nei dati**, riceverai una sola notifica di Avviso, relativa all'anomalia che ha riportato la maggiore variazione nei dati
* Nel caso degli **Obiettivi Lista e Classifica**, gli Avvisi continueranno a cercare le anomalie all'intero set di dati, anche se ci sono più di 1000 righe
* Se viene richiesto un Rilevamento Anomalie su un Topic a cui sono stati applicati uno o più **Filtri Dinamici**, Crystal *considererà solo la versione filtrata del Topic* nel tempo e non la sua forma originale, non filtrata
* Se viene richiesto un Rilevamento di Anomalie su un Topic a cui sono stati applicati **Filtri Temporali**, Crystal considererà tutte le modifiche storiche dell'Argomento nella *sua forma originale, non filtrata*

#### Limitazioni

* Limite di **10** Avvisi di Rilevamento Anomalie in corso alla volta&#x20;
* I Rilevamenti di Anomalie possono essere richiesti solo su **un Topic** alla volta
* **Fai attenzione** a modificare o cancellare un Topic su cui è attiva un Rilevamento Anomalie, in quanto potrebbero verificarsi i seguenti scenari eccezionali:&#x20;
  * se il Topic viene **modificato e ripubblicato**, questo può generare un'anomalia, generare un errore o non avere alcun impatto, in base alle specifiche modifiche applicate&#x20;
  * se il Topic viene **cancellato**, il Rilevamento Anomalie può generare un errore e non verrà inviata alcuna notifica

### Catalogo delle Anomalie

Di seguito è riportato l'elenco completo delle anomalie che Crystal è in grado di rilevare.

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

Qui trovi l'elenco generale delle anomalie insieme alla loro descrizione.&#x20;

In pratica, però, i tipi di anomalie che si possono trovare per ogni Topic dipendono strettamente dall'Obiettivo del Topic stesso.
{% endhint %}

<table><thead><tr><th width="72">N.</th><th width="248">Anomalia</th><th>Descrizione</th></tr></thead><tbody><tr><td><strong>1</strong></td><td><strong>Nuovi inserimenti nel gruppo</strong></td><td>In una data specifica, si è verificato un <em>cambiamento in un elenco</em>, con un <em>aumento</em> del numero di valori unici in una categoria chiave.</td></tr><tr><td><strong>2</strong></td><td><strong>Nuove rimozioni nel gruppo</strong></td><td>In una data specifica, si è verificato un <em>cambiamento in un elenco</em>, con una <del>diminuzione</del> del numero di valori unici in una categoria chiave.</td></tr><tr><td><strong>3</strong></td><td><strong>Nuovi aggiornamenti nel gruppo</strong></td><td>In una data specifica, un <em>elenco ha subito uno spostamento</em> con l'aggiunta di un certo numero di valori unici in una categoria chiave, mentre un numero diverso è stato <em>rimosso</em>.</td></tr><tr><td><strong>4</strong></td><td><strong>Variazione della percentuale media</strong></td><td>In una data specifica, una metrica chiave ha registrato una <em>variazione percentuale senza precedenti</em>, segnando un cambiamento notevole dall'inizio del monitoraggio.</td></tr><tr><td><strong>5</strong></td><td><strong>Nuovo valore alto o basso nella media</strong></td><td>In una data specifica, una metrica chiave ha raggiunto un <em>valore storico</em>, un livello mai osservato dall'inizio del monitoraggio.</td></tr><tr><td><strong>6</strong></td><td><strong>Aggiornamento dei Migliori 3</strong></td><td>In una data specifica, si sono verificati notevoli <em>spostamenti in una classifica</em> basata su una metrica chiave, evidenziando un significativo <em>movimento verso l'alto</em> di una particolare entità e il <em>declino</em> di un'altra entità precedentemente classificata più in alto.</td></tr><tr><td><strong>7</strong></td><td><strong>Aggiornamento dei Migliori 3 Positivi</strong></td><td>In una data specifica, si sono verificati notevoli <em>spostamenti in una classifica</em> basata su una metrica chiave, evidenziando il <em>movimento di valori specifici</em> all'interno dell'elenco.</td></tr><tr><td><strong>8</strong></td><td><strong>Aggiornamento dei Migliori 3 nel tempo</strong></td><td>In una data specifica, si sono verificati notevoli <em>spostamenti in una classifica</em> basata su una metrica chiave, evidenziando un significativo <em>movimento verso l'alto</em> di una particolare entità e il <em>declino</em> di un'altra entità precedentemente classificata più in alto.</td></tr><tr><td><strong>9</strong></td><td><strong>Cambio di proporzione</strong></td><td>In una data specifica, una metrica chiave per una categoria designata ha subito un <em>cambiamento notevole</em>, sottolineando le <em>variazioni sia assolute che proporzionali</em>.</td></tr><tr><td><strong>10</strong></td><td><strong>Cambio di proporzione clusterizzata</strong></td><td>In una data specifica, una metrica per una categoria designata ha subito un <em>cambiamento significativo</em>, catturando sia le <em>variazioni assolute che quelle relative</em>.</td></tr><tr><td><strong>11</strong></td><td><strong>Modifica della classifica</strong></td><td>In una data specifica, una metrica ha <em>superato un'altra</em> in classifica, sottolineando lo spostamento dei valori e delle posizioni di entrambe le metriche.</td></tr><tr><td><strong>12</strong></td><td><strong>Modifica della classifica di categoria</strong></td><td>In una data specifica, all'interno di una particolare categoria, una metrica che in precedenza aveva un valore inferiore ne <em>ha superata un'altra</em>, segnando una notevole <em>inversione di posizione</em>.</td></tr><tr><td><strong>13</strong></td><td><strong>Modifica della correlazione</strong></td><td>In una data specifica, si è verificato un <em>cambiamento notevole nella correlazione</em> tra due metriche di Topic.</td></tr><tr><td><strong>14</strong></td><td><strong>Evento interessante</strong></td><td>In una data specifica, una metrica ha <em>mostrato un valore al di fuori dell'intervallo previsto</em>, superando il limite superiore previsto.</td></tr></tbody></table>

Rimani aggiornato sui tuoi Topic!

***
