Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Buat AWS IoT SiteWise dasbor ()AWS CLI
<a name="create-dashboards-using-aws-cli"></a>

**catatan**  
Fitur SiteWise Monitor tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [SiteWise Memantau perubahan ketersediaan](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

Saat Anda menentukan visualisasi (atau widget) di dasbor menggunakan AWS CLI, Anda harus menentukan informasi berikut dalam dokumen JSON. `dashboardDefinition` Definisi ini adalah parameter dari [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html)dan [UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html)operasi.

`widgets`  
Daftar struktur definisi widget yang masing-masing berisi informasi berikut:    
`type`  
Jenis widget. AWS IoT SiteWise menyediakan jenis widget berikut:  
+ <a name="monitor-line-chart"></a>`sc-line-chart`— Bagan garis. Untuk informasi selengkapnya, lihat [Bagan garis](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#line-charts) di *Panduan AWS IoT SiteWise Monitor Aplikasi*.
+ <a name="monitor-scatter-chart"></a>`sc-scatter-chart`— Bagan pencar. Untuk informasi selengkapnya, lihat [Bagan pencar](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#scatter-charts) di *Panduan AWS IoT SiteWise Monitor Aplikasi*.
+ <a name="monitor-bar-chart"></a>`sc-bar-chart`— Bagan batang. Untuk informasi selengkapnya, lihat [Bagan batang](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#bar-charts) di *Panduan AWS IoT SiteWise Monitor Aplikasi*.
+ <a name="monitor-status-grid"></a>`sc-status-grid`- Widget status yang menunjukkan nilai terbaru properti aset sebagai kisi. Untuk informasi selengkapnya, lihat [Widget status](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#status-widgets) di *Panduan AWS IoT SiteWise Monitor Aplikasi*.
+ <a name="monitor-status-timeline"></a>`sc-status-timeline`— Widget status yang menunjukkan nilai historis properti aset sebagai garis waktu. Untuk informasi selengkapnya, lihat [Widget status](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#status-widgets) di *Panduan AWS IoT SiteWise Monitor Aplikasi*.
+ `sc-kpi`— Visualisasi indikator kinerja utama (KPI). Untuk informasi selengkapnya, lihat [widget KPI](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#kpi-charts) di Panduan *AWS IoT SiteWise Monitor Aplikasi*.
+ `sc-table`- Widget tabel. Untuk informasi selengkapnya, lihat [Widget tabel](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/choose-visualization-types.html#table-widgets) 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 SiteWise menyediakan jenis metrik berikut:  
+ `iotsitewise`— Dasbor mengambil data untuk properti aset di AWS IoT SiteWise. Jika Anda memilih opsi ini, Anda harus menentukan `assetId` dan `propertyId` untuk metrik ini.  
`assetId`  
(Opsional) ID aset di AWS IoT SiteWise.  
Bidang ini diperlukan jika Anda memilih `iotsitewise` untuk `type` dalam metrik ini.  
`propertyId`  
(Opsional) ID properti aset di AWS 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](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/configure-trend-lines.html) 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](https://en.wikipedia.org/wiki/Least_squares) untuk menghitung regresi linier.  
`annotations`  
(Opsional) Struktur anotasi yang mendefinisikan ambang batas untuk widget. *Untuk informasi selengkapnya, lihat [Mengonfigurasi ambang batas dalam Panduan](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/configure-thresholds.html) 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 dari`value`.
+ `GT`— Sorot properti yang memiliki setidaknya satu titik data lebih besar dari`value`.
+ `LTE`— Sorot properti yang memiliki setidaknya satu titik data kurang dari atau sama dengan`value`.
+ `GTE`— Sorot properti yang memiliki setidaknya satu titik data lebih besar dari atau sama dengan`value`.
+ `EQ`— Sorot properti yang memiliki setidaknya satu titik data yang sama dengan`value`.  
`value`  
Nilai ambang batas untuk membandingkan titik data dengan`comparisonOperator`.  
`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 SiteWise menyediakan widget berikut yang menggunakan`properties`:  
+ [Bagan garis](#monitor-line-chart), [bagan sebar](#monitor-scatter-chart)[, dan bagan batang](#monitor-bar-chart) 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](#monitor-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`.

**Example 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.
Contoh ini mewakili visualisasi diagram garis dan batang di dasbor. Dasbor ini mirip dengan [contoh dasbor ladang angin](monitor-data.md).

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