---
title: 'Atlante dei guasti dei correttori'
description: Atlante delle situazioni anomale dell'intera flotta per tipo di correttore — categorie di eventi per modello con drill-down per nodo.
section: AI Analytics
weight: 6
related:
  - ai-analytics/fleet-reports/events-explorer
---

Una mappa consolidata delle situazioni anomale e dei registri di eventi dell'intera flotta di correttori gas, suddivisa per modello di dispositivo. Il report è destinato ai team di esercizio e metrologia: risponde a quali tipi di correttore presentano quali guasti, con quale frequenza e quali registri di eventi ciascun modello effettivamente riporta alla Piattaforma IIoT. È un "atlante": non classifica i singoli punti, ma mostra il quadro complessivo per tipo di dispositivo.

## Cosa mostra

La schermata principale è una matrice "modello di correttore × categoria di evento": le righe sono i tipi di dispositivo, le colonne sono le categorie di guasto e le celle contengono il conteggio degli eventi. Ogni cella è cliccabile ed espande i punti principali di quel modello con eventi della categoria indicata.

| Categoria                | Cosa significa                                                                               |
| ------------------------ | -------------------------------------------------------------------------------------------- |
| Metrologia               | Sensori (pressione, temperatura) fuori dall'intervallo operativo, sostituzione delle letture |
| Alimentazione / batteria | Scarica della batteria, problemi con l'alimentazione del dispositivo                         |
| Comunicazioni            | Errori di sessione e di connessione, anomalie nello scambio dati                             |
| Configurazione           | Modifiche alle impostazioni del dispositivo, variazioni dei parametri                        |

Inoltre, il report mostra una mappa di copertura dei registri: quali modelli hanno effettivamente funzionanti quali registri e quali non dispongono di archivio per la natura stessa del dispositivo (ad esempio, unità di telemetria anziché correttori).

## Come funziona

Per ciascun tipo di correttore viene prelevato un campione di punti e, per ogni punto, vengono caricati i registri di eventi disponibili nella finestra di analisi. Modelli diversi denominano i propri registri in modo diverso, quindi il report sa quale registro richiedere a quale modello:

| Tipo di archivio              | Cos'è questo registro                                                                                                            |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `nesht` / `nesht_svod`        | Registro degli ingressi in situazioni anomale                                                                                    |
| `changes` / `settings_update` | Registro delle modifiche di impostazioni e parametri                                                                             |
| `alarm` / `fault`             | Registri di allarme e guasto (alcuni modelli)                                                                                    |
| `seance`                      | Registro delle sessioni di comunicazione; gli errori di comunicazione vengono rilevati tramite il codice di stato della sessione |

Ogni evento viene riconosciuto dalla coppia "modello di dispositivo + codice evento" e classificato in una delle quattro categorie (metrologia, alimentazione/batteria, comunicazioni, configurazione). Tutto viene poi consolidato in una matrice "modello × categoria" e in una tabella dei codici più frequenti. La corrispondenza tra i modelli e i relativi registri è stata confermata da un controllo effettivo sulla flotta, non semplicemente dalla documentazione dichiarata dei dispositivi.

## Parametri di esecuzione

| Parametro                              | Predefinito  | Cosa significa                                                |
| -------------------------------------- | ------------ | ------------------------------------------------------------- |
| Finestra eventi, giorni                | 30           | Finestra di raccolta eventi, in giorni                        |
| Nodi per tipo di correttore (campione) | 50           | Quanti punti campionare per tipo di correttore (per velocità) |
| Worker di fetch parallelo              | 8            | Numero di thread di download paralleli                        |
| Società di servizi (filtro flotta)     | dal contesto | Filtro per organizzazione (utility / DSO)                     |

## Come leggere il risultato

Confronta i modelli tra loro: se un tipo di correttore presenta nettamente più eventi nella categoria "metrologia" o "comunicazioni" rispetto agli altri, è motivo per esaminare più da vicino il modello nel suo complesso. Cliccando una cella vengono mostrati i punti specifici su cui approfondire ulteriormente.

Cosa tenere a mente:

- Il report è costruito su un campione, non sull'intera flotta. Per un modello con un migliaio di punti viene prelevato un campione (50 per impostazione predefinita), quindi i numeri indicano la portata del fenomeno anziché un conteggio esatto su tutti i punti.
- Non tutti i dispositivi riportano i registri delle situazioni anomale. Se la matrice di un modello è vuota, ciò può significare sia l'assenza di guasti sia che il dispositivo non dispone di tale registro per la sua natura — la mappa di copertura dei registri lo spiega.
