---
title: 'Diagnostica API'
description: '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.'
section: AI Analytics
weight: 9
---

import Alert from '@/components/docs/Alert.astro';

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.

<Alert type="info">
  Questo è uno strumento di servizio per l'amministratore. È disponibile tramite un collegamento
  diretto e non dall'elenco generale dei report mostrato agli operatori.
</Alert>

## 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 |

<Alert type="note">
  Endpoint come `/api/v1/stations` e nomi di campi come `archive_type` sono identificatori tecnici
  delle richieste e dei campi della piattaforma, non impostazioni per l'operatore.
</Alert>

## 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.