Dashboards erstellen ()AWS Command Line Interface

Wenn Sie Visualisierungen (oder Widgets) in Dashboards mithilfe von definieren AWS CLI, müssen Sie die folgenden Informationen im Dokument angeben. dashboardDefinition JSON Diese Definition ist ein Parameter der CreateDashboardOperationen und. UpdateDashboard

widgets

Eine Liste von Widget-Definitionsstrukturen, die jeweils die folgenden Informationen enthalten:

type

Der Typ des Widgets. AWS IoT SiteWise bietet die folgenden Widget-Typen:

• sc-line-chart— Ein Liniendiagramm. Weitere Informationen finden Sie unter Liniendiagramme im AWS IoT SiteWise Monitor Anwendungshandbuch.

• sc-scatter-chart— Ein Punktdiagramm. Weitere Informationen finden Sie unter Streudiagramme im AWS IoT SiteWise Monitor Anwendungsleitfaden.

• sc-bar-chart— Ein Balkendiagramm. Weitere Informationen finden Sie unter Balkendiagramme im AWS IoT SiteWise Monitor Anwendungshandbuch.

• sc-status-grid— Ein Status-Widget, das den aktuellen Wert von Asset-Eigenschaften als Raster anzeigt. Weitere Informationen finden Sie unter Status-Widgets im AWS IoT SiteWise Monitor Anwendungsleitfaden.

• sc-status-timeline— Ein Status-Widget, das die historischen Werte von Asset-Eigenschaften als Zeitleiste anzeigt. Weitere Informationen finden Sie unter Status-Widgets im AWS IoT SiteWise Monitor Anwendungsleitfaden.

• sc-kpi— Eine Visualisierung wichtiger Leistungsindikatoren (KPI). Weitere Informationen finden Sie unter KPIWidgets im AWS IoT SiteWise Monitor Anwendungsleitfaden.

• sc-table— Ein Tabellen-Widget. Weitere Informationen finden Sie unter Tabellen-Widgets im AWS IoT SiteWise Monitor Anwendungshandbuch.

title

Der Titel des Widgets.

x

Die horizontale Position des Widgets ausgehend von der linken Seite des Rasters. Dieser Wert bezieht sich auf die Position des Widgets im Raster des Dashboards.

y

Die vertikale Position des Widgets ausgehend vom oberen Rand des Rasters. Dieser Wert bezieht sich auf die Position des Widgets im Raster des Dashboards.

width

Die Breite des Widgets ausgedrückt als Anzahl der Leerzeichen im Raster des Dashboards.

height

Die Höhe des Widgets ausgedrückt als Anzahl der Leerzeichen im Raster des Dashboards.

metrics

Eine Liste von Metrikstrukturen, die jeweils einen Datenstrom für dieses Widget definieren. Jede Struktur in der Liste muss folgende Informationen enthalten:

label

Eine Beschriftung, die für diese Metrik angezeigt werden soll.

type

Der Typ der Datenquelle für diese Metrik. AWS IoT SiteWise stellt die folgenden Metriktypen bereit:

• iotsitewise— Das Dashboard ruft Daten für eine Anlageeigenschaft in AWS IoT SiteWise ab. Bei Auswahl dieser Option müssen Sie assetId und propertyId für diese Metrik definieren.

assetId

(Optional) Die ID einer Komponente in AWS IoT SiteWise.

Dieses Feld ist erforderlich, wenn Sie iotsitewise für type in dieser Metrik auswählen.

propertyId

(Optional) Die ID einer Komponenteneigenschaft in AWS IoT SiteWise.

Dieses Feld ist erforderlich, wenn Sie iotsitewise für type in dieser Metrik auswählen.

analysis

(Optional) Eine Struktur, die die Analyse definiert, z. B. Trendlinien, die für das Widget angezeigt werden sollen. Weitere Informationen finden Sie im AWS IoT SiteWise Monitor Anwendungsleitfaden unter Konfiguration von Trendlinien. Sie können pro Eigenschaft im Widget eine von jedem Trendlinientyp hinzufügen. Die Analysestruktur enthält die folgenden Informationen:

trends

(Optional) Eine Liste von Trendstrukturen, die jeweils eine Trendanalyse für dieses Widget definieren. Jede Struktur in der Liste enthält die folgenden Informationen:

type

Der Typ der Trendlinie. Wählen Sie die folgende Option:

• linear-regression— Zeigt eine lineare Regressionslinie an. SiteWise Monitor verwendet die Methode der kleinsten Quadrate zur Berechnung der linearen Regression.

annotations

(Optional) Eine Annotationsstruktur, die Schwellenwerte für das Widget definiert. Weitere Informationen finden Sie unter Konfiguration von Schwellenwerten im Anwendungshandbuch.AWS IoT SiteWise Monitor Sie können bis zu sechs Anmerkungen pro Widget hinzufügen. Die Struktur der Anmerkungen enthält die folgenden Informationen:

y

(Optional) Eine Liste von Annotationsstrukturen, die jeweils einen horizontalen Schwellenwert für dieses Widget definieren. Jede Struktur in der Liste enthält die folgenden Informationen:

comparisonOperator

Der Vergleichsoperator für den Schwellenwert. Wählen Sie eine der folgenden Optionen aus:

• LT— Hebt Eigenschaften hervor, bei denen mindestens ein Datenpunkt unter dem liegtvalue.

• GT— Hebt Eigenschaften hervor, bei denen mindestens ein Datenpunkt größer als der istvalue.

• LTE— Hebt Eigenschaften hervor, bei denen mindestens ein Datenpunkt kleiner oder gleich dem istvalue.

• GTE— Hebt Eigenschaften hervor, bei denen mindestens ein Datenpunkt größer oder gleich dem istvalue.

• EQ— Hebt Eigenschaften hervor, bei denen mindestens ein Datenpunkt gleich dem istvalue.

value

Der Schwellenwert für den Vergleich von Datenpunkten mit demcomparisonOperator.

color

(Optional) Der sechsstellige Hexadezimalcode der Schwellenfarbe. In der Visualisierung werden Eigenschaftslegenden in dieser Farbe für Eigenschaften angezeigt, bei denen mindestens ein Datenpunkt die Schwellenwertregel erfüllt. Die Standardeinstellung ist schwarz (#000000).

showValue

(Optional) Ob der Wert des Schwellenwerts an den Rändern des Widgets angezeigt werden soll oder nicht. Standardeinstellung: true.

properties

(Optional) Ein einfaches Eigenschaftswörterbuch für das Widget. Die Mitglieder dieser Struktur sind kontextabhängig. AWS IoT SiteWise bietet die folgenden Widgets, die Folgendes verwenden: properties

• Liniendiagramme, Punktdiagramme und Balkendiagramme haben die folgenden Eigenschaften:

  colorDataAcrossThresholds

  (Optional) Ob die Farbe der Daten, die die Schwellenwerte überschreiten, in diesem Widget geändert werden soll oder nicht. Wenn Sie diese Option aktivieren, werden die Daten, die einen Schwellenwert überschreiten, in der von Ihnen ausgewählten Farbe angezeigt. Standardeinstellung: true.

• Statusraster haben die folgenden Eigenschaften:

  labels

  (Optional) Eine Struktur, die die Beschriftungen definiert, die in der Statusleiste angezeigt werden sollen. Die Labelstruktur enthält die folgenden Informationen:

  showValue

  (Optional) Ob die Einheit und der Wert für jede Anlageneigenschaft in diesem Widget angezeigt werden sollen oder nicht. Standardeinstellung: true.

Beispiel Dashboard-Beispieldefinition

Das folgende Beispiel definiert ein Dashboard aus einer Payload, die in einer JSON Datei gespeichert ist.

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

Das folgende JSON Beispiel für dashboard-definition.json definiert ein Dashboard mit den folgenden Visualisierungs-Widgets:

• Ein Liniendiagramm, das die Gesamtleistung des Windparks oben links im Dashboards visualisiert. Dieses Liniendiagramm enthält einen Schwellenwert, der angibt, wann der Windpark weniger Leistung abgibt als die erwartete Mindestleistung. Dieses Liniendiagramm enthält auch eine lineare Regressionstrendlinie.

• Ein Balkendiagramm, das die Windgeschwindigkeit für vier Turbinen oben rechts im Dashboard visualisiert.

Anmerkung

Dieses Beispiel stellt Visualisierungen von Linien- und Balkendiagrammen in einem Dashboard dar. Dieses Dashboard ist dem Beispiel-Dashboard für einen Windpark ähnlich.

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