View a markdown version of this page

Comprendi la relazione tra interfaccia e modello di asset - AWS IoT SiteWise

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à.

Comprendi la relazione tra interfaccia e modello di asset

Le interfacce e i modelli di asset lavorano insieme in una relazione complementare:

Interfacce e modelli di asset
Aspetto Interfacce Modelli di asset
Scopo Definisci gli standard e applica la coerenza Rappresentano risorse fisiche o logiche
Creazione di risorse Impossibile creare risorse direttamente Utilizzato per creare risorse
Properties Definire le proprietà standard che devono essere implementate nei modelli Può avere proprietà uniche e applicate all'interfaccia
Metriche Definire calcoli standard Implementa le metriche dell'interfaccia e può avere metriche aggiuntive
Gerarchie Definire le relazioni gerarchiche di calcolo dei dati per le metriche di rollup Definisci le relazioni gerarchiche fisiche per le associazioni di asset

Quando applichi un'interfaccia a un modello di asset:

  • Il modello di asset deve mappare tutte le proprietà definite nell'interfaccia.

  • Le mappature delle proprietà definiscono in che modo le proprietà dell'interfaccia corrispondono alle proprietà del modello di asset.

  • Le proprietà del modello di asset mappato devono rimanere sincronizzate con le proprietà di interfaccia corrispondenti e non possono essere modificate in modo da causare incoerenze tra le due.

  • Le proprietà dell'interfaccia non mappate vengono create automaticamente nel modello di asset.

  • Il modello di asset può avere proprietà aggiuntive oltre a quelle definite nell'interfaccia.

  • Il modello di asset implementa le metriche dell'interfaccia. Le modifiche alle metriche dell'interfaccia si propagano a tutti i modelli di asset utilizzando l'interfaccia.

  • Le gerarchie di interfaccia vengono utilizzate per il calcolo delle metriche di rollup. Le gerarchie dei modelli di asset possono essere definite indipendentemente e il servizio le mapperà automaticamente durante il calcolo delle metriche di rollup.

Questa relazione garantisce la standardizzazione pur consentendo la flessibilità necessaria per rappresentare diversi tipi di apparecchiature.

Standardizza i modelli di asset esistenti

Le interfacce sono utili per la progettazione di nuovi modelli di asset partendo da zero, ma sono altrettanto potenti per standardizzare i modelli di asset esistenti che potrebbero essersi evoluti indipendentemente nel tempo.

Quando lavorate con modelli di asset esistenti, potete applicare interfacce per standardizzare metriche e proprietà:

  1. Identifica metriche e proprietà comuni tra i tuoi modelli di asset esistenti

  2. Create un'interfaccia che definisca queste proprietà e metriche standard

  3. Applica l'interfaccia ai tuoi modelli di asset esistenti utilizzando la mappatura delle proprietà

  4. Utilizza le metriche di rollup per aggregare i dati nella gerarchia degli asset

Ad esempio, se disponi di modelli di asset di macchine CNC esistenti con nomi di proprietà diversi ma dati simili, come,,machine_temp) temp_celsiustemperature_c, puoi:

  1. Create un CNC-INTERFACE con una proprietà standardizzata Temperature-in-C

  2. Applica questa interfaccia a ciascun modello di asset CNC, mappando le proprietà di temperatura esistenti con le proprietà dell'interfaccia Temperature-in-C

  3. Definisci le metriche di rollup nell'interfaccia che calcolano le statistiche su tutte le macchine (ad esempio, la temperatura media)

Questo approccio consente di mantenere i modelli di asset esistenti ottenendo al contempo i vantaggi della standardizzazione e del calcolo semplificato delle metriche.

Relazioni gerarchiche

Gerarchia delle interfacce

Definisce le relazioni per il calcolo e l'aggregazione dei dati tra diverse interfacce. Ad esempio, in un'impostazione di fabbrica, una gerarchia di interfacce potrebbe collegare interfacce di monitoraggio della temperatura a diversi livelli per calcolare le temperature medie. Ad esempio: macchina, linea di produzione e impianto. Quando si definisce una metrica di rollup, ad esempioAverageTemperature, la gerarchia dell'interfaccia determina il modo in cui tale metrica aggrega i dati dai livelli inferiori a quelli superiori.

Gerarchia del modello di asset

Rappresenta l'effettiva struttura fisica o logica degli asset. Ad esempio, un modello di asset di una macchina CNC potrebbe far parte di un modello di asset di una linea di produzione, che a sua volta appartiene a un modello di asset di fabbrica. Questa gerarchia riflette le relazioni del mondo reale e aiuta a organizzare le risorse in modo che corrispondano alla loro disposizione fisica o alla struttura aziendale. Se combinate con le gerarchie di interfaccia, le gerarchie dei modelli di asset aiutano il sistema a capire quali risorse devono essere incluse nei calcoli cumulativi.

Questi due tipi di gerarchia funzionano insieme: le gerarchie di interfaccia definiscono come calcolare le metriche aggregate, mentre le gerarchie dei modelli di asset definiscono quali asset specifici devono essere inclusi in tali calcoli.

Metriche di interfaccia e calcoli cumulativi

Le interfacce sono eccellenti nella definizione di metriche standardizzate che possono essere applicate a diversi modelli di asset. Ciò è particolarmente utile per le metriche di rollup che aggregano i dati provenienti da più risorse.

Quando definisci le metriche in un'interfaccia, vengono applicate automaticamente a tutti i modelli di asset che implementano l'interfaccia. Le metriche possono fare riferimento alle proprietà definite nell'interfaccia, utilizzare funzioni di aggregazione per calcolare le statistiche tra gli asset e garantire calcoli coerenti in tutti i modelli di asset in implementazione. Ad esempio, puoi definire una metrica di disponibilità in un'interfaccia che calcola il rapporto tra tempo di esecuzione e tempo totale:

{ "name": "Availability", "dataType": "DOUBLE", "type": { "metric": { "expression": "Running-time / (Running-time + Down-time) * 100", "variables": [ { "name": "Running-time", "value": { "propertyId": "${Running-time}" } }, { "name": "Down-time", "value": { "propertyId": "${Down-time}" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Percent" }

Quando questa interfaccia viene applicata a più modelli di asset, la metrica di disponibilità viene calcolata in modo coerente per tutti, anche se i nomi delle proprietà sottostanti sono diversi (grazie alla mappatura delle proprietà).

Per ulteriori informazioni sulla definizione delle metriche e sull'utilizzo delle funzioni di aggregazione, vedere. Aggrega i dati provenienti da proprietà e altre risorse (metriche)

Metriche di rollup con interfacce

Le interfacce possono anche definire metriche di rollup che aggregano i dati tra le risorse in una gerarchia. Quando definisci una gerarchia in un'interfaccia e la applichi a un modello di asset, puoi creare metriche che aggregano i dati dagli asset secondari.

Ad esempio, è possibile definire una metrica che calcola la temperatura media di tutte le macchine CNC di una fabbrica:

{ "name": "AverageTemperature", "dataType": "DOUBLE", "type": { "metric": { "expression": "avg(Temperature-in-C)", "variables": [ { "name": "Temperature-in-C", "value": { "propertyId": "${Temperature-in-C}", "hierarchyId": "${CNC-machines}" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Celsius" }

Questa metrica utilizza la funzione di avg() aggregazione per calcolare la temperatura media su tutte le macchine CNC della gerarchia. Il hierarchyId parametro specifica quale gerarchia utilizzare per l'aggregazione.

Quando questa interfaccia viene applicata a un modello di asset, la metrica di rollup aggrega automaticamente i dati di tutte le risorse secondarie che corrispondono alla mappatura della gerarchia.