Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Aggrega i dati provenienti da proprietà e altre risorse (metriche) Dati aggregati (metriche) Le metriche sono espressioni matematiche che utilizzano funzioni di aggregazione per elaborare tutti i punti dati di input e generare un singolo punto dati per intervallo di tempo specificato. Un parametro, ad esempio, può calcolare la temperatura oraria media da un flusso di dati di temperatura. I parametri possono immettere dati dai parametri degli asset associati, in modo da poter calcolare le statistiche che forniscono informazioni dettagliate sull'operazione o su un sottoinsieme dell'operazione. Un parametro, ad esempio, può calcolare la temperatura oraria media di tutte le turbine eoliche di una centrale eolica. Per ulteriori informazioni su come definire le associazioni tra asset, consulta [Definite le gerarchie dei modelli di asset](define-asset-hierarchies.md). Le metriche possono anche inserire dati da altre proprietà senza aggregare i dati su ogni intervallo di tempo. Se specifichi un [attributo](attributes.md) in una formula, AWS IoT SiteWise utilizza il valore [più recente](expression-temporal-functions.md#latest-definition) per quell'attributo quando calcola la formula. Se specifichi una metrica in una formula, AWS IoT SiteWise utilizza l'[ultimo](expression-temporal-functions.md#last-definition) valore per l'intervallo di tempo in cui calcola la formula. Ciò significa che puoi definire metriche come `OEE = Availability * Quality * Performance` `Availability``Quality`, dove e `Performance` sono tutte le altre metriche sullo stesso modello di asset. AWS IoT SiteWise inoltre, calcola automaticamente un set di metriche di aggregazione di base per tutte le proprietà degli asset. Per ridurre i costi di calcolo, puoi utilizzare questi aggregati anziché definire parametri personalizzati per i calcoli di base. Per ulteriori informazioni, consulta [Interroga gli aggregati delle proprietà degli asset in AWS IoT SiteWise](aggregates.md). **Topics** + [ ## Definisci le metriche (console) ](#define-metrics-console) + [ ## Definisci le metriche ()AWS CLI ](#define-metrics-cli) ## Definisci le metriche (console) Quando definisci una metrica per un modello di asset nella AWS IoT SiteWise console, specifichi i seguenti parametri: + **Nome**: il nome della proprietà. + **Tipo di dati**: il tipo di dati della trasformazione, che può essere **Double** o **String**. + **ID esterno**: (Facoltativo) Si tratta di un ID definito dall'utente. Per ulteriori informazioni, consulta [Oggetti di riferimento con oggetti esterni IDs](object-ids.md#external-id-references) nella *Guida per l'utente di AWS IoT SiteWise *. + **Formula**: l'espressione metrica. Le espressioni metriche possono utilizzare [funzioni di aggregazione](expression-aggregation-functions.md) per inserire dati da una proprietà per tutte le risorse associate in una gerarchia. Inizia a digitare o premi il tasto freccia giù per aprire la funzione di completamento automatico. Per ulteriori informazioni, consulta [Usa espressioni di formule](formula-expressions.md). **Importante** Le metriche possono essere solo proprietà di tipo intero, doppio, booleano o stringa. I valori booleani vengono convertiti in `0` (false) e (true). `1` Le variabili di input in una espressione parametrica devono presentare lo stesso intervallo di tempo del parametro di output. Le espressioni delle formule possono generare solo valori doppi o stringhe. Le espressioni annidate possono generare altri tipi di dati, ad esempio stringhe, ma la formula nel suo insieme deve restituire un numero o una stringa. È possibile utilizzare la [funzione jp](expression-string-functions.md#jp-definition) per convertire una stringa in un numero. Il valore booleano deve essere 1 (vero) o 0 (falso). Per ulteriori informazioni, consulta [Valori indefiniti, infiniti e di overflow](expression-tutorials.md#undefined-values). + **Intervallo di tempo: l'intervallo** di tempo metrico. AWS IoT SiteWise supporta i seguenti intervalli di tempo a finestra rotante, in cui ogni intervallo inizia alla fine di quello precedente: + da **1 minuto a** 1 minuto, calcolato alla fine di ogni minuto (00:00:00, 00:01:00, 12:02:00 e così via). + Da **5 minuti** a 5 minuti, calcolati alla fine di ogni cinque minuti a partire dall'ora (00:00:00, 12:05:00, 00:10:00 e così via). + da **15 minuti** a 15 minuti, calcolati alla fine di ogni quindici minuti a partire dall'ora (00:00:00, 12:15:00, 00:30:00 e così via). + da **1 ora** a 1 ora (60 minuti), calcolata alla fine di ogni ora in formato UTC (00:00:00, 01:00:00, 02:00:00 e così via). + **1 giorno** — 1 giorno (24 ore), calcolato alla fine di ogni giornata in UTC (00:00 di lunedì, 00:00 di martedì e così via). + da **1 settimana a** 1 settimana (7 giorni), calcolata alla fine di ogni domenica in UTC (ogni lunedì alle 00:00). + **Intervallo personalizzato: puoi inserire qualsiasi intervallo** di tempo compreso tra un minuto e una settimana. + **Data di offset**: (Facoltativa) La data di riferimento a partire dalla quale aggregare i dati. + **Tempo di offset**: (Facoltativo) L'ora di riferimento a partire dalla quale aggregare i dati. L'ora di offset deve essere compresa tra 00:00:00 e 23:59:59. + Fuso orario di **offset - (Facoltativo) Il fuso orario** per l'offset. Se non è specificato, il fuso orario di offset predefinito è l'Universal Coordinated Time (UTC). Vedi i seguenti fusi orari supportati. ### Fusi orari supportati + (UTC\$1 00:00) Ora coordinata universale + (UTC\$1 01:00) Ora centrale europea + (UTC\$1 02:00) Europa orientale + (UTC03\$1:00) Ora dell'Africa orientale + (UTC\$1 04:00) Ora del Vicino Oriente + (UTC\$1 05:00) Ora del Pakistan di Lahore + (UTC\$1 05:30) Ora solare dell'India + (UTC\$1 06:00) Ora solare del Bangladesh + (UTC\$1 07:00) Ora solare del Vietnam + + (UTC\$1 09:00) Ora solare del Giappone + (UTC\$1 09:30) Ora centrale dell'Australia + (UTC\$1 10:00) Ora orientale dell'Australia + (UTC\$1 11:00) Ora solare delle Salomone + (UTC\$1 12:00) Ora solare della Nuova Zelanda + (UTC- 11:00) Ora delle Isole Midway + (UTC- 10:00) Ora solare delle Hawaii + (UTC- 09:00) Ora solare dell'Alaska + (UTC- 08:00) Ora solare del Pacifico + (UTC- 07:00) Ora solare di Phoenix + (UTC- 06:00) Ora solare centrale + (UTC- 05:00) Ora solare orientale + (UTC- 04:00) Ora di Porto Rico e Isole Vergini Americane + (UTC- 03:00) Ora solare dell'Argentina + (UTC- 02:00) Ora della Georgia del Sud + (UTC- 01:00) Ora dell'Africa centrale **Example intervallo di tempo personalizzato con un offset (console)** L'esempio seguente mostra come definire un intervallo di tempo di 12 ore con un offset il 20 febbraio 2021 alle 18:30:30 (PST). **Per definire un intervallo personalizzato con un offset** 1. **Per **Intervallo di tempo, scegliete Intervallo** personalizzato.** 1. Per **Intervallo di tempo**, effettuate una delle seguenti operazioni: + Immettete**12**, quindi scegliete le **ore.** + Inserisci**720**, quindi scegli **minuti**. + Inserisci**43200**, quindi scegli **secondi**. **Importante** L'**intervallo di tempo** deve essere un numero intero indipendentemente dall'unità. 1. **Per la **data di offset**, scegli 20/02/2021.** 1. **Per Tempo di offset, immettete.** **18:30:30** 1. Per il **fuso orario di Offset, scegliete** **(UTC- 08:00**) Pacific Standard Time. Se crei la metrica il 1° luglio 2021, prima o alle 18:30:30 (PST), otterrai il primo risultato di aggregazione il 1° luglio 2021 alle 18:30:30 (PST). Il secondo risultato di aggregazione è il 2 luglio 2021 alle 06:30:30 (PST) e così via. ## Definisci le metriche ()AWS CLI Quando definite una metrica per un modello di asset con l' AWS IoT SiteWise API, specificate i seguenti parametri: + `name`— Il nome della proprietà. + `dataType`— Il tipo di dati della metrica, che può essere `DOUBLE` o`STRING`. + `externalId`— (Facoltativo) Si tratta di un ID definito dall'utente. Per ulteriori informazioni, consulta [Oggetti di riferimento con oggetti esterni IDs](object-ids.md#external-id-references) nella *Guida per l'utente di AWS IoT SiteWise *. + `expression`— L'espressione metrica. Le espressioni metriche possono utilizzare [funzioni di aggregazione](expression-aggregation-functions.md) per immettere dati da una proprietà per tutte le risorse associate in una gerarchia. Per ulteriori informazioni, consulta [Usa espressioni di formule](formula-expressions.md). + `window`— L'intervallo di tempo e l'offset della finestra di rotazione della metrica, in cui ogni intervallo inizia quando termina quello precedente: + `interval`— L'intervallo di tempo per la finestra di rotazione. L'intervallo di tempo deve essere compreso tra un minuto e una settimana. + `offsets`— L'offset della finestra ribaltabile. Per ulteriori informazioni, consulta [TumblingWindow](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_TumblingWindow.html) nella *documentazione di riferimento dell’API AWS IoT SiteWise *. **Example intervallo di tempo personalizzato con un offset ()AWS CLI** L'esempio seguente mostra come definire un intervallo di tempo di 12 ore con un offset il 20 febbraio 2021 alle 18:30:30 (PST). ``` { "window": { "tumbling": { "interval": "12h", "offset": " 2021-07-23T18:30:30-08" } } } ``` Se crei la metrica il 1° luglio 2021, prima o alle 18:30:30 (PST), otterrai il primo risultato di aggregazione il 1° luglio 2021 alle 18:30:30 (PST). Il secondo risultato di aggregazione è il 2 luglio 2021 alle 06:30:30 (PST) e così via. + `variables`— L'elenco di variabili che definisce le altre proprietà della risorsa o delle risorse secondarie da utilizzare nell'espressione. Ogni struttura di variabile contiene un nome semplice da utilizzare nell'espressione e una struttura `value` che specifica la proprietà da collegare alla variabile stessa. La struttura `value` contiene le seguenti informazioni: + `propertyId`— L'ID della proprietà da cui estrarre i valori. È possibile utilizzare il nome della proprietà anziché il relativo ID se la proprietà è definita nel modello corrente (anziché definita in un modello da una gerarchia). + `hierarchyId`— (Facoltativo) L'ID della gerarchia da cui interrogare gli asset secondari per la proprietà. È possibile utilizzare il nome della definizione della gerarchia anziché il relativo ID. Se omettete questo valore, AWS IoT SiteWise trova la proprietà nel modello corrente. **Importante** Le metriche possono essere solo proprietà di tipo intero, doppio, booleano o stringa. I valori booleani vengono convertiti in `0` (false) e (true). `1` Le variabili di input in una espressione parametrica devono presentare lo stesso intervallo di tempo del parametro di output. Le espressioni delle formule possono generare solo valori doppi o stringhe. Le espressioni annidate possono generare altri tipi di dati, ad esempio stringhe, ma la formula nel suo insieme deve restituire un numero o una stringa. È possibile utilizzare la [funzione jp](expression-string-functions.md#jp-definition) per convertire una stringa in un numero. Il valore booleano deve essere 1 (vero) o 0 (falso). Per ulteriori informazioni, consulta [Valori indefiniti, infiniti e di overflow](expression-tutorials.md#undefined-values). + `unit`— (Facoltativo) L'unità scientifica della proprietà, ad esempio mm o Celsius. **Example Definizione del parametro di esempio** Nell'esempio seguente viene illustrata una proprietà parametro che aggrega i dati di misurazione della temperatura di un asset per calcolare la temperatura oraria massima in Fahrenheit. Questo oggetto è un esempio di un [AssetModelProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetModelProperty.html)che contiene una [metrica](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Metric.html). Puoi specificare questo oggetto come parte del payload della richiesta [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) per creare una proprietà di parametro. Per ulteriori informazioni, consulta [Crea un modello di asset (AWS CLI)](create-asset-models.md#create-asset-model-cli). ``` { ... "assetModelProperties": [ ... { "name": "Max temperature", "dataType": "DOUBLE", "type": { "metric": { "expression": "max(temp_f)", "variables": [ { "name": "temp_f", "value": { "propertyId": "Temperature F" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Fahrenheit" } ], ... } ``` **Example Esempio di definizione della metrica che inserisce dati dalle risorse associate** L'esempio seguente mostra una proprietà metrica che aggrega i dati sulla potenza media di più turbine eoliche per calcolare la potenza media totale di un parco eolico. [Questo oggetto è un esempio di un oggetto che contiene una metrica [AssetModelProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetModelProperty.html).](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Metric.html) Puoi specificare questo oggetto come parte del payload della richiesta [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html) per creare una proprietà di parametro. ``` { ... "assetModelProperties": [ ... { "name": "Total Average Power", "dataType": "DOUBLE", "type": { "metric": { "expression": "avg(power)", "variables": [ { "name": "power", "value": { "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "hierarchyId": "Turbine Asset Model" } } ], "window": { "tumbling": { "interval": "5m" } } } }, "unit": "kWh" } ], ... } ```