Interroga gli aggregati delle proprietà degli asset

AWS IoT SiteWise calcola automaticamente i valori aggregati delle proprietà degli asset, che sono un insieme di metriche di base calcolate su più intervalli di tempo. AWS IoT SiteWise calcola i seguenti aggregati ogni minuto, ora e giorno per le proprietà degli asset:

• media: la media (media) dei valori di una proprietà in un intervallo di tempo.

• count: il numero di punti dati per una proprietà in un intervallo di tempo.

• maximum — Il massimo dei valori di una proprietà in un intervallo di tempo.

• minimo — Il minimo dei valori di una proprietà in un intervallo di tempo.

• deviazione standard: la deviazione standard dei valori di una proprietà in un intervallo di tempo.

• sum — La somma dei valori di una proprietà in un intervallo di tempo.

Per le proprietà non numeriche, come stringhe e valori booleani, calcola solo l'aggregato di conteggio. AWS IoT SiteWise

Puoi anche calcolare parametri personalizzati per i dati di asset. Con le proprietà metriche, definisci aggregazioni specifiche per la tua operazione. Le proprietà metriche offrono funzioni di aggregazione e intervalli di tempo aggiuntivi che non sono precalcolati per. AWS IoT SiteWise API Per ulteriori informazioni, consulta Aggrega i dati provenienti da proprietà e altre risorse (metriche).

Aggregati per una proprietà di asset () API

Puoi utilizzare il AWS IoT SiteWise API per ottenere gli aggregati per una proprietà dell'asset.

Utilizzate l'GetAssetPropertyAggregatesoperazione per interrogare gli aggregati di una proprietà di un asset.

Per identificare la proprietà di un asset, specificate una delle seguenti opzioni:

• La proprietà assetId e propertyId della risorsa a cui vengono inviati i dati.

• IlpropertyAlias, che è un alias del flusso di dati (ad esempio,/company/windfarm/3/turbine/7/temperature). Per utilizzare questa opzione, è necessario prima impostare l'alias della proprietà dell'asset. Per impostare gli alias delle proprietà, vedere. Mappa i flussi di dati industriali sulle proprietà degli asset

È inoltre necessario passare i seguenti parametri obbligatori:

• aggregateTypes— L'elenco degli aggregati da recuperare. Puoi specificare uno qualsiasi di AVERAGE, COUNT, MAXIMUM, MINIMUM, STANDARD_DEVIATION e SUM.

• resolution— L'intervallo di tempo per il quale recuperare la metrica: 1m (1 minuto), (1 ora) o 1h 1d (1 giorno).

• startDate— L'inizio esclusivo dell'intervallo da cui interrogare i dati storici, espresso in secondi nell'epoca Unix.

• endDate— La fine inclusiva dell'intervallo da cui interrogare i dati storici, espressa in secondi nell'epoca Unix.

È anche possibile passare uno dei seguenti parametri per perfezionare i risultati:

• maxResults— Il numero massimo di risultati da restituire in una richiesta. I valori predefiniti sono i risultati. 20

• nextToken— Un token di impaginazione restituito da una precedente chiamata di questa operazione.

• timeOrdering— L'ordine da applicare ai valori restituiti: ASCENDING o. DESCENDING

• qualities— La qualità per filtrare i risultati in base a: GOODBAD, oUNCERTAIN.

Nota

L'GetAssetPropertyAggregatesoperazione restituisce un TQV messaggio con un formato diverso rispetto alle altre operazioni descritte in questa sezione. La struttura di value annovera un campo per ogni aggregateTypes incluso nella richiesta. timestamp contiene l'orario in cui si è verificata l'aggregazione, in secondi nel formato epoca (Unix epoch).

Aggregati per una proprietà di asset ()AWS CLI

Per interrogare gli aggregati per una proprietà di un asset ()AWS CLI

1. Esegui il comando seguente per ottenere aggregati per la proprietà di asset. Questo comando esegue la query per la media e la somma con una risoluzione di 1 ora per uno specifico intervallo di 1 ora. Replace (Sostituisci) asset-id con l'ID della risorsa e property-id con l'ID della proprietà. Sostituisci i parametri con gli aggregati e l'intervallo per la query.

   aws iotsitewise get-asset-property-aggregates \
     --asset-id asset-id \
     --property-id property-id \
     --start-date 1575216000 \
     --end-date 1575219600 \
     --aggregate-types AVERAGE SUM \
     --resolution 1h

   L'operazione restituisce una risposta che contiene lo storico TQVs della proprietà nel formato seguente. La risposta include solo gli aggregati richiesti.

   {
     "aggregatedValues": [
       {
         "timestamp": Number,
         "quality": "String",
         "value": {
           "average": Number,
           "count": Number,
           "maximum": Number,
           "minimum": Number,
           "standardDeviation": Number,
           "sum": Number
         }
       }
     ],
     "nextToken": "String"
   }

2. Se esistono più valori, è possibile passare il token di impaginazione dal nextToken campo a una successiva chiamata all'GetAssetPropertyAggregatesoperazione.