View a markdown version of this page

Crea dashboard con AWS CLI - 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à.

Crea dashboard con AWS CLI

Nota

La funzione SiteWise Monitor non è più disponibile per i nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta SiteWise Monitora la modifica della disponibilità.

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

displaySettings

Le impostazioni del display con i seguenti parametri:

  • numRows— Numero di righe nel layout della dashboard. Ogni riga è larga CellSize.

  • numColumbs— Numero di colonne nel layout del pannello di controllo. Ogni colonna è larga CellSize.

  • cellSize— (Facoltativo) La dimensione di una cella nel layout in pixel. Deve essere un numero positivo. L'impostazione predefinita è 10.

  • significantDigits— (Facoltativo) Numero di cifre significative da visualizzare nel pannello di controllo. L'impostazione predefinita è 4.

querySettings

Le informazioni sulla query con il seguente parametro:

  • refreshRate— (Facoltativo) La velocità di aggiornamento dei dati in millisecondi. Accetta i seguenti valori: 1000, 5000, 10000, 60000, 300000.

defaultViewport

Se non viene fornito, il valore predefinito sono gli ultimi cinque minuti. Contiene i seguenti parametri:

  • duration— (Facoltativo) Determina fino a che punto nel passato è possibile interrogare i dati a partire dal momento presente.

  • start— (Facoltativo) È di tipo Date. L'intervallo di tempo di inizio per l'interrogazione dei dati. È necessario specificare una end data.

  • end— (Facoltativo) È di tipo Date. L'intervallo di tempo di fine per l'interrogazione dei dati. Richiede una start data specificata.

widgets

Un elenco di strutture di definizione dei widget che contengono le seguenti informazioni:

type

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

  • xy-plot— Un grafico a linee o un grafico a dispersione a seconda della configurazione.

  • bar-chart— Un grafico a barre.

  • kpi-chart— Un grafico degli indicatori chiave delle prestazioni.

  • status-timeline— Un widget di stato che visualizza e naviga tra i dati delle serie temporali da una o più fonti di dati.

  • text— Un widget di testo.

  • table— Un widget per la tabella.

id

Un identificatore univoco per il widget.

x

La posizione orizzontale del widget, a partire dalla parte sinistra del pannello di controllo. 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 dashboard. Questo valore si riferisce alla posizione del widget nella griglia del pannello di controllo.

z

L'ordine relativo dei widget. Un widget con valore Z più grande viene visualizzato davanti al widget con valore Z inferiore, se si sovrappongono.

width

La larghezza del widget, espressa in numero di celle sul pannello di controllo.

height

L'altezza del widget, espressa in numero di celle sul pannello di controllo.

properties

Un elenco di proprietà del widget. Varia in base al tipo di widget. Vedi IoT App Kit per i dettagli.

Esempio 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 "Example 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:

{ "displaySettings": { "numColumns": 200, "numRows": 1000, "cellSize": 20, "significantDigits": 4 }, "widgets": [{ "id": "Ot73JcxUoc6oEXAMPLE", "type": "xy-plot", "width": 33, "height": 20, "x": 0, "y": 0, "z": 0, "properties": { "aggregationType": "AVERAGE", "queryConfig": { "source": "iotsitewise", "query": { "assets": [{ "assetId": "97c97abf-e883-47bb-a3f4-EXAMPLE", "properties": [{ "propertyId": "97cc61f4-57a4-4c5f-a82c-EXAMPLE", "refId": "692ce941-f3d9-4074-a297-EXAMPLE", "aggregationType": "AVERAGE", "color": "#7d2105", "resolution": "1m" }] }], "properties": [], "assetModels": [], "alarms": [], "alarmModels": [] } }, "line": { "connectionStyle": "linear", "style": "solid" }, "symbol": { "style": "filled-circle" }, "axis": { "yVisible": true, "xVisible": true }, "legend": { "visible": true, "position": "right", "width": "30%", "height": "30%", "visibleContent": { "unit": true, "asset": true, "latestValue": true, "latestAlarmStateValue": true, "maxValue": false, "minValue": false } } } }, { "id": "fto7rF40Ny1EXAMPLE-G", "type": "bar-chart", "width": 33, "height": 20, "x": 0, "y": 20, "z": 0, "properties": { "aggregationType": "AVERAGE", "queryConfig": { "source": "iotsitewise", "query": { "assets": [{ "assetId": "97c97abf-e883-47bb-a3f4-EXAMPLE", "properties": [{ "propertyId": "c84ca8f3-3dea-478a-afec-EXAMPLE", "aggregationType": "AVERAGE", "refId": "2960b958-2034-4d6e-bcc2-EXAMPLE" }] }], "properties": [], "assetModels": [], "alarms": [], "alarmModels": [], "requestSettings": { "aggregation": "AVERAGE" } } }, "axis": { "showX": true, "showY": true }, "styleSettings": { "2960b958-2034-4d6e-bcc2-360f1f02e505": { "color": "#7d2105" } } } }], "querySettings": { "refreshRate": 5000 } }