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 i queryParameters 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 ai queryParameters 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.