Dati di Telemetria
Le suites Telemetry
e KPIs
consentono di sfruttare più chiamate per recuperare i dati di telemetria di interesse, sia a livello di impianto che/o di singolo dispositivo.
Le APIs all’interno di queste suite sono suddivise, in base alla modellazione e presentazione dei dati, in due tipi principali:
AGGREGATED
: permette di richiamare il tipo di dati desiderato (dataType
) con un criterio di aggregazione (valueType
) all’interno di una finestra temporale (startDate
&endDate
). Chiamate di questo tipo restituiscono sempre un unico valore, aggregato secondo iqueryParameters
definiti;TIMESERIES
: permette di richiamare il tipo di dati desiderato (dataType
) con un criterio di aggregazione (valueType
) within a all’interno di una finestra temporale (startDate
&endDate
) e secondo una frequenza di campionamento definita (sampleTime
). chiamate di questo tipo restituiscono sempre un array di valori, la cui lunghezza varia in base aiqueryParameters
definiti.
Per lo sviluppo di una business logic di terze parti trasparente e completamente integrata, è importante tenere conto di alcuni principi chiave sulla manipolazione e presentazione dei dati di Aurora Vision:
Sampling
Time
Aurora Vision esegue un salvataggio dei dati inviati al minimo ogni 5 minuti, non è quindi possibile richiedere dati al di sotto di una frequenza di campionamento di 5 minuti.
Power
Data
Tutte le telemetrie di potenza (per qualsiasi dispositivo compatibile) sono fornite come valore on-time, che cambia da un istante di campionamento ad un altro.
Energy
Data
Tutte le telemetrie di energia (per qualsiasi dispositivo compatibile) sono fornite come cumulative nel tempo, dal primo momento in cui il dispositivo compatibile ha iniziato effettivamente a funzionare.
Con questi concetti in mente, è possibile analizzare in dettaglio le due principali tipologie di chiamate di telemetria:
- A Pagina 2 si può trovare un’analisi dettagliata delle
Aggregated
APIs; - A Pagina 3 si può trovare un’analisi dettagliata delle
Timeseries
APIs.
Considerando che le suites Telemetry
ed KPIs
forniscono molti dataTypes
da poter chiamare, una tabella completa con la descrizione di ciascuno di essi è disponibile a Pagina 4.