Diagnostica API
Una verifica di servizio dello scambio dati tra AI Analytics e la piattaforma dei dispositivi di misura, che sonda ogni richiesta su cui si basano gli altri report.
Una verifica di servizio dello scambio dati tra AI Analytics e la piattaforma dei dispositivi di misura. Il report interroga, una alla volta, tutte le richieste della piattaforma utilizzate dagli altri report e mostra quali di esse rispondono normalmente e quali restituiscono un errore. Il pubblico è l’amministratore e il supporto tecnico: eseguilo quando sospetti un guasto dell’integrazione e individua immediatamente dove si è interrotto il collegamento al dispositivo o al server.
Cosa mostra
Per ogni tipo di richiesta alla piattaforma — una riga con il risultato: quale endpoint è stato chiamato, se il server ha risposto correttamente, quante righe di dati ha restituito e quali campi erano presenti nella prima riga (per confermare che il formato dei dati non sia cambiato).
| Elemento della riga | Cosa significa |
|---|---|
| Endpoint della richiesta | quale tipo di dati è stato verificato (login, elenco del parco, directory, sessioni di collegamento, archivi delle letture, passaporto del dispositivo) |
| Stato | se il server ha risposto correttamente o ha restituito un errore |
| Numero di righe | quanti record sono arrivati nella risposta |
| Campioni di campi | nomi dei campi del primo record — un segnale che il formato non è cambiato |
Il colore della riga è determinato dal codice di risposta del server:
| Colore | Cosa significa |
|---|---|
| Verde («200») | la richiesta funziona normalmente |
| Giallo (errore di autorizzazione, eccetto «not found») | i diritti di accesso devono essere verificati |
| Rosso (errore del server o nessuna risposta tempestiva) | un problema lato server |
| Grigio («404» — not found) | non esiste questa richiesta in questa versione della piattaforma |
Come viene calcolato
Il report interroga, una alla volta, tutte le richieste della piattaforma utilizzate dagli altri report: login, elenco del parco, directory (tipi di dispositivo, aziende di servizi, clienti), sessioni di collegamento (in quattro varianti di parametri), archivi delle letture (orari, giornalieri, mensili, impostazioni), archivi delle situazioni anomale e registri eventi, nonché il passaporto del dispositivo. Per ogni chiamata vengono registrati l’endpoint, la risposta del server, il numero di righe e un campione dei campi. Se viene impostato un nodo specifico, gli archivi delle situazioni anomale vengono inoltre verificati per quel nodo.
Parametri di esecuzione
| Parametro | Valore predefinito | Significato |
|---|---|---|
| ID del nodo per la verifica dell’archivio anomalie (opzionale) | dedotto dal contesto | se impostato — la verifica viene eseguita su questo nodo; se vuoto — viene preso il primo nodo dall’elenco del parco |
Come leggerlo
Osserva i colori delle righe. Tutte verdi — lo scambio dati è in buono stato. Le righe gialle indicano che il server è presente ma non restituisce dati senza i diritti necessari — un motivo per verificare l’accesso. Le righe rosse sono un guasto lato server e vanno affrontate per prime. Le righe grigie («not found») sono spesso normali: non tutti i dispositivi supportano tutti i tipi di archivio, quindi l’assenza di archivi delle anomalie su un dispositivo specifico non è un errore.
Nota una particolarità del login: la piattaforma riutilizza un pass ottenuto in precedenza per circa due settimane, quindi la verifica del login ha solitamente esito positivo anche senza un effettivo nuovo login sul server.
Report correlati
Questo report è autonomo e non dipende da nulla. Tutti gli altri report del parco utilizzano le stesse richieste alla piattaforma che esso verifica — quindi, quando falliscono, è da qui che iniziare la diagnostica.
Questa pagina è stata utile?
Grazie per il tuo feedback!