Creare dashboard ()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à.

Creare dashboard ()AWS Command Line Interface

Quando si definiscono visualizzazioni (o widget) nei dashboard utilizzando il AWS CLI, è necessario specificare le seguenti informazioni nel documento. dashboardDefinition JSON Questa definizione è un parametro delle operazioni and. CreateDashboardUpdateDashboard

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 Monitor applicazione.

  • 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 Monitor applicazione.

  • 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 Monitor applicazione.

  • sc-kpi— Visualizzazione di un indicatore chiave di prestazione (KPI). Per ulteriori informazioni, consultate i KPIwidget nella Guida all'AWS IoT SiteWise Monitor applicazione.

  • sc-table— Un widget da tabella. Per ulteriori informazioni, consultate Table widgets nella Guida all'AWS IoT SiteWise Monitor applicazione.

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 questa metrica. AWS IoT SiteWise fornisce i seguenti tipi di metriche:

  • iotsitewise— La dashboard 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 Monitor applicazione. È 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, ciascuna delle quali definisce 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 SiteWise fornisce 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 una dashboard a partire da un payload memorizzato in un JSON file.

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

L'JSONesempio seguente dashboard-definition.json definisce una dashboard 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"
        }
      ]
    }
  ]
}