Membuat dasbor () AWS Command Line Interface

Saat Anda menentukan visualisasi (atau widget) di dasbor menggunakanAWS CLI, Anda harus menentukan informasi berikut dalam dokumen JSON. dashboardDefinition Definisi ini adalah parameter dari CreateDashboarddan UpdateDashboardoperasi.

widgets

Daftar struktur definisi widget yang masing-masing berisi informasi berikut:

type

Jenis widget. AWS IoT SiteWisemenyediakan jenis widget berikut:

• sc-line-chart— Bagan garis. Untuk informasi selengkapnya, lihat Bagan garis di Panduan AWS IoT SiteWise Monitor Aplikasi.

• sc-scatter-chart— Bagan pencar. Untuk informasi selengkapnya, lihat Bagan pencar di Panduan AWS IoT SiteWise Monitor Aplikasi.

• sc-bar-chart— Bagan batang. Untuk informasi selengkapnya, lihat Bagan batang di Panduan AWS IoT SiteWise Monitor Aplikasi.

• sc-status-grid- Widget status yang menunjukkan nilai terbaru properti aset sebagai kisi. Untuk informasi selengkapnya, lihat Widget status di Panduan AWS IoT SiteWise Monitor Aplikasi.

• sc-status-timeline— Widget status yang menunjukkan nilai historis properti aset sebagai garis waktu. Untuk informasi selengkapnya, lihat Widget status di Panduan AWS IoT SiteWise Monitor Aplikasi.

• sc-kpi— Visualisasi indikator kinerja utama (KPI). Untuk informasi selengkapnya, lihat widget KPI di Panduan AWS IoT SiteWise MonitorAplikasi.

• sc-table— Sebuah widget tabel. Untuk informasi selengkapnya, lihat Widget tabel di Panduan AWS IoT SiteWise Monitor Aplikasi.

title

Judul widget.

x

Posisi horizontal widget, mulai dari kiri grid. Nilai ini mengacu pada posisi widget di grid dashboard.

y

Posisi vertikal widget, mulai dari bagian atas grid. Nilai ini mengacu pada posisi widget di grid dashboard.

width

Lebar widget, dinyatakan dalam jumlah spasi pada grid dashboard.

height

Ketinggian widget, dinyatakan dalam jumlah spasi pada grid dashboard.

metrics

Daftar struktur metrik yang masing-masing menentukan aliran data untuk widget ini. Setiap struktur dalam daftar harus berisi informasi berikut:

label

Label untuk ditampilkan untuk metrik ini.

type

Jenis sumber data untuk metrik ini. AWS IoT SiteWisemenyediakan jenis metrik berikut:

• iotsitewise— Dasbor mengambil data untuk properti aset diAWS IoT SiteWise. Jika Anda memilih opsi ini, Anda harus menentukan assetId dan propertyId untuk metrik ini.

assetId

(Opsional) ID aset diAWS IoT SiteWise.

Bidang ini diperlukan jika Anda memilih iotsitewise untuk type dalam metrik ini.

propertyId

(Opsional) ID properti aset diAWS IoT SiteWise.

Bidang ini diperlukan jika Anda memilih iotsitewise untuk type dalam metrik ini.

analysis

(Opsional) Struktur yang mendefinisikan analisis, seperti garis tren, untuk ditampilkan untuk widget. Untuk informasi selengkapnya, lihat Mengonfigurasi garis tren di Panduan AWS IoT SiteWise Monitor Aplikasi. Anda dapat menambahkan salah satu dari setiap jenis garis tren per properti di widget. Struktur analisis berisi informasi berikut:

trends

(Opsional) Daftar struktur tren yang masing-masing menentukan analisis tren untuk widget ini. Setiap struktur dalam daftar berisi informasi berikut:

type

Jenis garis tren. Pilih opsi berikut:

• linear-regression— Menampilkan garis regresi linier. SiteWise Monitor menggunakan metode kuadrat terkecil untuk menghitung regresi linier.

annotations

(Opsional) Struktur anotasi yang mendefinisikan ambang batas untuk widget. Untuk informasi selengkapnya, lihat Mengonfigurasi ambang batas dalam Panduan Aplikasi. AWS IoT SiteWise Monitor Anda dapat menambahkan hingga enam anotasi per widget. Struktur anotasi berisi informasi berikut:

y

(Opsional) Daftar struktur anotasi yang masing-masing menentukan ambang horizontal untuk widget ini. Setiap struktur dalam daftar berisi informasi berikut:

comparisonOperator

Operator perbandingan untuk ambang batas. Pilih salah satu cara berikut:

• LT— Sorot properti yang memiliki setidaknya satu titik data kurang darivalue.

• GT— Sorot properti yang memiliki setidaknya satu titik data lebih besar darivalue.

• LTE— Sorot properti yang memiliki setidaknya satu titik data kurang dari atau sama denganvalue.

• GTE— Sorot properti yang memiliki setidaknya satu titik data lebih besar dari atau sama denganvalue.

• EQ— Sorot properti yang memiliki setidaknya satu titik data yang sama denganvalue.

value

Nilai ambang batas untuk membandingkan titik data dengancomparisonOperator.

color

(Opsional) Kode heksadesimal 6 digit dari warna ambang batas. Visualisasi menampilkan legenda properti dalam warna ini untuk properti dengan setidaknya satu titik data yang memenuhi aturan ambang batas. Default ke black (). #000000

showValue

(Opsional) Apakah atau tidak untuk menunjukkan nilai ambang batas di margin widget. Default ke true.

properties

(Opsional) Kamus datar properti untuk widget. Anggota struktur ini bergantung pada konteks. AWS IoT SiteWisemenyediakan widget berikut yang menggunakanproperties:

• Bagan garis, bagan sebar, dan bagan batang memiliki properti berikut:

  colorDataAcrossThresholds

  (Opsional) Apakah atau tidak untuk mengubah warna data yang melintasi ambang batas dalam widget ini. Saat Anda mengaktifkan opsi ini, data yang melewati ambang batas muncul dalam warna yang Anda pilih. Default ke true.

• Status grid memiliki properti berikut:

  labels

  (Opsional) Struktur yang mendefinisikan label untuk ditampilkan pada grid status. Struktur label berisi informasi berikut:

  showValue

  (Opsional) Apakah akan menampilkan unit dan nilai untuk setiap properti aset dalam widget ini atau tidak. Default ke true.

contoh Contoh definisi dasbor

Contoh berikut mendefinisikan dasbor dari payload yang disimpan dalam file JSON.

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

Contoh JSON berikut untuk dashboard-definition.json mendefinisikan dasbor dengan widget visualisasi berikut:

• Bagan garis yang memvisualisasikan total tenaga ladang angin di kiri atas dasbor. Bagan garis ini mencakup ambang batas yang menunjukkan kapan ladang angin menghasilkan daya yang lebih kecil daripada output minimum yang diharapkan. Grafik garis ini juga mencakup garis tren regresi linier.

• Diagram batang yang memvisualisasikan kecepatan angin untuk empat turbin di kanan atas dasbor.

catatan

Contoh ini mewakili visualisasi diagram garis dan batang di dasbor. Dasbor ini mirip dengan contoh dasbor ladang angin.

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