View a markdown version of this page

Buat dasbor dengan AWS CLI - AWS IoT SiteWise

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

Buat dasbor dengan AWS CLI

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 Mem SiteWise antau perubahan ketersediaan.

Saat Anda menentukan visualisasi (atau widget) di dasbor menggunakan AWS CLI, Anda harus menentukan informasi berikut dalam dokumen dashboardDefinition JSON. Definisi ini adalah parameter UpdateDashboard operasi CreateDashboard dan.

displaySettings

Pengaturan tampilan dengan parameter berikut:

  • numRows— Jumlah baris dalam tata letak dasbor. Setiap baris memiliki lebar CellSize.

  • numColumbs— Jumlah kolom dalam tata letak dasbor. Setiap kolom memiliki lebar CellSize.

  • cellSize— (Opsional) Ukuran sel dalam tata letak dalam piksel. Itu harus angka positif. Defaultnya adalah 10.

  • significantDigits— (Opsional) Jumlah digit signifikan untuk ditampilkan di dasbor. Defaultnya adalah 4.

querySettings

Informasi kueri dengan parameter berikut:

  • refreshRate— (Opsional) Tingkat penyegaran data dalam milidetik. Menerima nilai-nilai berikut - 1000, 5000, 10000, 60000, 300000.

defaultViewport

Jika tidak disediakan, default ke lima menit terakhir. Berisi parameter berikut:

  • duration— (Opsional) Menentukan seberapa jauh ke masa lalu untuk menanyakan data mulai dari saat ini.

  • start— (Opsional) Ini adalah tipe Tanggal. Rentang waktu mulai untuk menanyakan data. Membutuhkan end tanggal yang ditentukan.

  • end— (Opsional) Ini adalah tipe Tanggal. Rentang waktu akhir untuk menanyakan data. Membutuhkan start tanggal yang ditentukan.

widgets

Daftar struktur definisi widget yang berisi informasi berikut:

type

Jenis widget. AWS IoT SiteWise menyediakan jenis widget berikut:

  • xy-plot— Bagan garis atau plot pencar tergantung pada konfigurasi.

  • bar-chart— Diagram batang.

  • kpi-chart— Bagan indikator kinerja utama.

  • status-timeline- Widget status yang memvisualisasikan dan menavigasi data deret waktu dari satu atau lebih sumber data.

  • text— Widget teks.

  • table— Widget tabel.

id

Pengidentifikasi unik untuk widget.

x

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

y

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

z

Urutan relatif widget. Widget nilai Z yang lebih besar ditampilkan di depan widget nilai Z yang lebih rendah, jika tumpang tindih.

width

Lebar widget, dinyatakan dalam jumlah sel di dasbor.

height

Ketinggian widget, dinyatakan dalam jumlah sel di dasbor.

properties

Daftar properti widget. Ini bervariasi berdasarkan jenis widget. Lihat IoT App Kit untuk detailnya.

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 "Example Dashboard" \
  --dashboard-definition file://dashboard-definition.json

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


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