Definisci le metriche (console)Definisci le metriche ()AWS CLI

Aggrega i dati provenienti da proprietà e altre risorse (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.

Le metriche possono anche inserire dati da altre proprietà senza aggregare i dati su ogni intervallo di tempo. Se specifichi un attributo in una formula, AWS IoT SiteWise utilizza il valore più recente per quell'attributo quando calcola la formula. Se specifichi una metrica in una formula, AWS IoT SiteWise utilizza l'ultimo valore per l'intervallo di tempo in cui calcola la formula. Ciò significa che puoi definire metriche come OEE = Availability * Quality * Performance AvailabilityQuality, 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.

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 nella Guida per l'utente di AWS IoT SiteWise .
Formula: l'espressione metrica. Le espressioni metriche possono utilizzare funzioni di aggregazione per immettere 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.

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 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.
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 UTC (00:00:00, 01:00:00, 02:00:00 e così via).
- da 1 giorno a 1 giorno (24 ore), calcolato alla fine di ogni giornata nelle seguenti ore UTC (00:00:00 di lunedì, 00:00:00 di martedì e così via).
- da 1 settimana a 1 settimana (7 giorni), calcolato alla fine di ogni domenica 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
- (UTC+ 00:00) Tempo coordinato universale
- (UTC+ 01:00) Ora centrale europea
- (UTC+ 02:00) Europa orientale
- (UTC03+:00) Ora dell'Africa orientale
- (UTC+ 04:00) Ora del Vicino Oriente
- (UTC+ 05:00) Ora del Pakistan di Lahore
- (UTC+ 05:30) Ora solare dell'India
- (UTC+ 06:00) Ora solare del Bangladesh
- (UTC+ 07:00) Ora solare del Vietnam
- (UTC+ 09:00) Ora solare del Giappone
- (UTC+ 09:30) Ora centrale dell'Australia
- (UTC+ 10:00) Ora orientale dell'Australia
- (UTC+ 11:00) Ora solare delle Salomone
- (UTC+ 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 standard 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

Esempio 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

Per Intervallo di tempo, scegliete Intervallo personalizzato.
Per Intervallo di tempo, effettuate una delle seguenti operazioni:
- Immettete12, quindi scegliete le ore.
- Inserisci720, quindi scegli minuti.
- Inserisci43200, quindi scegli secondi.
Importante
L'intervallo di tempo deve essere un numero intero indipendentemente dall'unità.
Per la data di offset, scegli 20/02/2021.
Per Tempo di offset, immettete. 18:30:30
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 () e così via. PST

Definisci le metriche ()AWS CLI

Quando definite una metrica per un modello di asset con AWS IoT SiteWise API, specificate i seguenti parametri:

name— Il nome della proprietà.
dataType— Il tipo di dati della metrica, che può essere DOUBLE oSTRING.
externalId— (Facoltativo) Si tratta di un ID definito dall'utente. Per ulteriori informazioni, consulta Oggetti di riferimento con oggetti esterni IDs nella Guida per l'utente di AWS IoT SiteWise .
expression— L'espressione metrica. Le espressioni metriche possono utilizzare funzioni di aggregazione per immettere dati da una proprietà per tutte le risorse associate in una gerarchia. Per ulteriori informazioni, consulta Usa espressioni di formule.
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, vedere TumblingWindownel Reference.AWS IoT SiteWise API
Esempio 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 () e così via. PST
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 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.
unit— (Facoltativo) L'unità scientifica della proprietà, ad esempio mm o Celsius.

Esempio 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 AssetModelPropertyche contiene una metrica. È possibile specificare questo oggetto come parte del payload della CreateAssetModelrichiesta per creare una proprietà metrica. Per ulteriori informazioni, consulta Crea un modello di asset (AWS 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"
      }
    ],
    ...
}

Esempio di definizione della metrica che immette i dati dagli asset associati

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. È possibile specificare questo oggetto come parte del payload della CreateAssetModelrichiesta per creare una proprietà metrica.


{
      ...
      "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"
      }
    ],
    ...
}

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Trasforma i dati (trasformazioni)

Usa espressioni di formule

Aggrega i dati provenienti da proprietà e altre risorse (metriche)

Argomenti

Definisci le metriche (console)

Importante

Esempio intervallo di tempo personalizzato con un offset (console)

Per definire un intervallo personalizzato con un offset

Importante

Definisci le metriche ()AWS CLI

Esempio intervallo di tempo personalizzato con un offset ()AWS CLI

Importante

Esempio Definizione del parametro di esempio

Esempio di definizione della metrica che immette i dati dagli asset associati