Creazione di pannelli di controllo (AWS Command Line Interface) - 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à.

Creazione di pannelli di controllo (AWS Command Line Interface)

Quando definisci visualizzazioni (o widget) nei pannelli di controllo mediante AWS CLI, devi specificare le seguenti informazioni nel documento JSON dashboardDefinition. Questa definizione è un parametro delle UpdateDashboardoperazioni CreateDashboardand.

widgets

Un elenco delle strutture di definizione di widget ciascuna contenente le seguenti informazioni:

type

Il tipo di widget. AWS IoT SiteWise fornisce i seguenti tipi di widget:

  • sc-line-chart— Un grafico a linee. Per ulteriori informazioni, vedere Grafici a linee nella Guida AWS IoT SiteWise Monitor all'applicazione.

  • sc-scatter-chart— Un grafico a dispersione. Per ulteriori informazioni, vedere Grafici a dispersione nella Guida dell'AWS IoT SiteWise Monitorapplicazione.

  • sc-bar-chart— Un grafico a barre. Per ulteriori informazioni, vedere Grafici a barre nella Guida AWS IoT SiteWise Monitor all'applicazione.

  • sc-status-grid— Un widget di stato che mostra il valore più recente delle proprietà degli asset sotto forma di griglia. Per ulteriori informazioni, consultate Status widgets nella Guida all'AWS IoT SiteWise Monitorapplicazione.

  • sc-status-timeline— Un widget di stato che mostra i valori storici delle proprietà degli asset sotto forma di sequenza temporale. Per ulteriori informazioni, consultate Status widgets nella Guida all'AWS IoT SiteWise Monitorapplicazione.

  • sc-kpi— Una visualizzazione degli indicatori chiave di prestazione (KPI). Per ulteriori informazioni, consulta i widget KPI nella Guida all'applicazione. AWS IoT SiteWise Monitor

  • sc-table— Un widget per tabelle. Per ulteriori informazioni, consultate Table widgets nella Guida all'AWS IoT SiteWise Monitorapplicazione.

title

Il titolo del widget.

x

La posizione orizzontale del widget, a partire dal lato sinistro della griglia. Questo valore si riferisce alla posizione del widget nella griglia del pannello di controllo.

y

La posizione verticale del widget, a partire dalla parte superiore della griglia. Questo valore si riferisce alla posizione del widget nella griglia del pannello di controllo.

width

La larghezza del widget, espressa in numero di spazi sulla griglia del pannello di controllo.

height

L'altezza del widget, espressa in numero di spazi sulla griglia del pannello di controllo.

metrics

Un elenco di strutture di parametri ciascuna delle quali definisce un flusso di dati per questo widget. Ogni struttura dell'elenco deve contenere le seguenti informazioni:

label

Un'etichetta da visualizzare per questo parametro.

type

Il tipo di origine dati per questo parametro. AWS IoT SiteWise fornisce i seguenti tipi di parametri:

  • iotsitewise— Il pannello di controllo recupera i dati relativi alla proprietà di un asset in. AWS IoT SiteWise Se scegli questa opzione, devi definire assetId e propertyId per questo parametro.

assetId

(Facoltativo) L'ID di un asset in AWS IoT SiteWise.

Questo campo è obbligatorio se scegli iotsitewise per type in questo parametro.

propertyId

(Facoltativo) L'ID di una proprietà di asset in AWS IoT SiteWise.

Questo campo è obbligatorio se scegli iotsitewise per type in questo parametro.

analysis

(Facoltativo) Una struttura che definisce l'analisi, ad esempio le linee di tendenza, da visualizzare per il widget. Per ulteriori informazioni, consulta Configurazione delle linee di tendenza nella Guida all'AWS IoT SiteWise Monitorapplicazione. È possibile aggiungere una linea di tendenza per ogni proprietà nel widget. La struttura di analisi contiene le seguenti informazioni:

trends

(Facoltativo) Un elenco di strutture di tendenza, ciascuna delle quali definisce un'analisi delle tendenze per questo widget. Ogni struttura dell'elenco contiene le seguenti informazioni:

type

Il tipo di linea di tendenza. Scegliete la seguente opzione:

  • linear-regression— Visualizza una linea di regressione lineare. SiteWise Monitor utilizza il metodo dei minimi quadrati per calcolare la regressione lineare.

annotations

(Facoltativo) Una struttura di annotazioni che definisce le soglie per il widget. Per ulteriori informazioni, consulta Configurazione delle soglie nella Guida all'applicazione. AWS IoT SiteWise Monitor È possibile aggiungere fino a sei annotazioni per widget. La struttura delle annotazioni contiene le seguenti informazioni:

y

(Facoltativo) Un elenco di strutture di annotazioni che definiscono ciascuna una soglia orizzontale per questo widget. Ogni struttura dell'elenco contiene le seguenti informazioni:

comparisonOperator

L'operatore di confronto per la soglia. Seleziona una delle seguenti opzioni:

  • LT— Evidenzia le proprietà che hanno almeno un punto dati inferiore avalue.

  • GT— Evidenzia le proprietà che hanno almeno un punto dati maggiore divalue.

  • LTE— Evidenzia le proprietà che hanno almeno un punto dati inferiore o uguale avalue.

  • GTE— Evidenzia le proprietà che hanno almeno un punto dati maggiore o uguale avalue.

  • EQ— Evidenzia le proprietà che hanno almeno un punto dati uguale avalue.

value

Il valore di soglia per confrontare i punti dati concomparisonOperator.

color

(Facoltativo) Il codice esadecimale a 6 cifre del colore di soglia. La visualizzazione mostra le legende delle proprietà in questo colore per le proprietà con almeno un punto dati che soddisfa la regola della soglia. Il valore predefinito è black (). #000000

showValue

(Facoltativo) Se mostrare o meno il valore della soglia nei margini del widget. L'impostazione predefinita è true.

properties

(Facoltativo) Un dizionario semplice di proprietà per il widget. I membri di questa struttura dipendono dal contesto. AWS IoT SiteWisefornisce i seguenti widget che utilizzano: properties

  • I grafici a linee, i grafici a dispersione e i grafici a barre hanno le seguenti proprietà:

    colorDataAcrossThresholds

    (Facoltativo) Se modificare o meno il colore dei dati che superano le soglie in questo widget. Quando abiliti questa opzione, i dati che superano una soglia vengono visualizzati nel colore che scegli. L'impostazione predefinita è true.

  • Le griglie di stato hanno le seguenti proprietà:

    labels

    (Facoltativo) Una struttura che definisce le etichette da visualizzare nella griglia di stato. La struttura delle etichette contiene le seguenti informazioni:

    showValue

    (Facoltativo) Se visualizzare o meno l'unità e il valore per ogni proprietà dell'asset in questo widget. L'impostazione predefinita è true.

Esempio di definizione del pannello di controllo

L'esempio seguente definisce un pannello di controllo da un payload archiviato in un file JSON.

aws iotsitewise create-dashboard \
  --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
  --dashboard-name "Wind Farm Dashboard" \
  --dashboard-definition file://dashboard-definition.json

L’esempio JSON seguente per dashboard-definition.json definisce il pannello di controllo con i seguenti widget di visualizzazione:

  • Un grafico a linee che visualizza la potenza totale del parco eolico in alto a sinistra del pannello di controllo. Questo grafico a linee include una soglia che indica quando il parco eolico produce meno energia della potenza minima prevista. Questo grafico a linee include anche una linea di tendenza alla regressione lineare.

  • Un grafico a barre che visualizza la velocità del vento per quattro turbine in alto a destra del pannello di controllo.

Nota

Questo esempio rappresenta le visualizzazioni di grafici a linee e a barre su un pannello di controllo. Questo pannello di controllo è simile al pannello di controllo del parco eolico di esempio.

{
  "widgets": [
    {
      "type": "sc-line-chart",
      "title": "Total Average Power",
      "x": 0,
      "y": 0,
      "height": 3,
      "width": 3,
      "metrics": [
        {
          "label": "Power",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
          "analysis": {
            "trends": [
              {
                "type": "linear-regression"
              }
            ]
          }
        }
      ],
      "annotations": {
        "y": [
          {
            "comparisonOperator": "LT",
            "value": 20000,
            "color": "#D13212",
            "showValue": true
          }
        ]
      }
    },
    {
      "type": "sc-bar-chart",
      "title": "Wind Speed",
      "x": 3,
      "y": 3,
      "height": 3,
      "width": 3,
      "metrics": [
        {
          "label": "Turbine 1",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-2a2a2EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
        },
        {
          "label": "Turbine 2",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-2b2b2EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
        },
        {
          "label": "Turbine 3",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-2c2c2EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
        },
        {
          "label": "Turbine 4",
          "type": "iotsitewise",
          "assetId": "a1b2c3d4-5678-90ab-cdef-2d2d2EXAMPLE",
          "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE"
        }
      ]
    }
  ]
}