Membuat model aset (konsol)Membuat model aset (AWS CLI)Contoh model aset

Membuat model aset

AWS IoT SiteWise model aset mendorong standardisasi data industri Anda. Model aset berisi nama, deskripsi, properti aset, dan definisi hierarki aset. Misalnya, Anda dapat menentukan model turbin angin dengan suhu, rotasi per menit (RPM), dan sifat daya. Kemudian, Anda dapat menentukan model ladang angin dengan properti output daya bersih dan definisi hierarki turbin angin.

catatan

Kami menyarankan Anda memodelkan operasi Anda dimulai dengan node tingkat terendah. Misalnya, buat model turbin angin Anda sebelum Anda membuat model ladang angin Anda. Definisi hierarki aset berisi referensi ke model aset yang ada. Dengan pendekatan ini, Anda dapat menentukan hierarki aset saat membuat model.
Model aset tidak dapat berisi model aset lainnya. Jika Anda harus mendefinisikan model yang dapat Anda referensikan sebagai subassembly dalam model lain, Anda harus membuat komponen -> model sebagai gantinya. Untuk informasi selengkapnya, lihat Membuat model komponen.

Bagian berikut menjelaskan cara menggunakan AWS IoT SiteWise konsol atau API untuk membuat model aset. Bagian berikut juga menjelaskan berbagai jenis properti aset dan hierarki aset yang dapat Anda gunakan untuk membuat model.

Topik

Membuat model aset (konsol)
Membuat model aset (AWS CLI)
Contoh model aset
Mendefinisikan hierarki model aset

Membuat model aset (konsol)

Anda dapat menggunakan AWS IoT SiteWise konsol untuk membuat model aset. AWS IoT SiteWise Konsol menyediakan berbagai fitur, seperti formula auto completion, yang dapat membantu Anda menentukan model aset yang valid.

Untuk membuat model aset (konsol)

Navigasikan ke konsol AWS IoT SiteWise tersebut.
Di panel navigasi, pilih Model.
Pilih Buat model.
Pada halaman Create model, lakukan hal berikut:
1. Masukkan Nama untuk model aset, seperti Wind Turbine atauWind Turbine Model. Nama ini harus unik di semua model di akun Anda di Wilayah ini.
2. (Opsional) Tambahkan ID Eksternal untuk model. Ini adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Mereferensikan objek dengan ID eksternal di AWS IoT SiteWise Panduan Pengguna.
3. (Opsional) Tambahkan definisi Pengukuran untuk model. Pengukuran mewakili aliran data dari peralatan Anda. Untuk informasi selengkapnya, lihat Mendefinisikan aliran data dari peralatan (pengukuran).
4. (Opsional) Tambahkan definisi Transform untuk model. Transformasi adalah rumus yang memetakan data dari satu bentuk ke bentuk lainnya. Untuk informasi selengkapnya, lihat Mengubah data (transformasi).
5. (Opsional) Tambahkan definisi Metrik untuk model. Metrik adalah rumus yang mengumpulkan data dari interval waktu. Metrik dapat memasukkan data dari aset terkait, sehingga Anda dapat menghitung nilai yang mewakili operasi Anda atau bagian dari operasi Anda. Untuk informasi selengkapnya, lihat Menggabungkan data dari properti dan aset lainnya (metrik).
6. (Opsional) Tambahkan definisi Hierarki untuk model. Hierarki adalah hubungan antar aset. Untuk informasi selengkapnya, lihat Mendefinisikan hierarki model aset.
7. (Opsional) Tambahkan tag untuk model aset. Untuk informasi selengkapnya, lihat Menandai sumber daya Anda AWS IoT SiteWise.
8. Pilih Buat model.
Saat Anda membuat model aset, AWS IoT SiteWise konsol akan menavigasi ke halaman model baru. Pada halaman ini, Anda dapat melihat Status model, yang awalnya MENCIPTAKAN. Halaman ini diperbarui secara otomatis, sehingga Anda dapat menunggu status model diperbarui.

catatan
Proses pembuatan model aset dapat memakan waktu hingga beberapa menit untuk model yang kompleks. Setelah status model aset AKTIF, Anda dapat menggunakan model aset untuk membuat aset. Untuk informasi selengkapnya, lihat Status aset dan model.
(Opsional) Setelah membuat model aset, Anda dapat mengonfigurasi model aset untuk edge. Untuk informasi lebih lanjut tentang SiteWise Edge, lihatMengaktifkan pemrosesan data tepi.
1. Pada halaman model, pilih Configure for Edge.
2. Pada halaman konfigurasi model, pilih konfigurasi tepi untuk model Anda. Ini mengontrol tempat AWS IoT SiteWise dapat menghitung dan menyimpan properti yang terkait dengan model aset ini. Untuk informasi selengkapnya tentang mengonfigurasi model Anda untuk edge, lihatMenyiapkan kemampuan tepi.
3. Untuk konfigurasi Custom edge, pilih lokasi yang AWS IoT SiteWise ingin Anda hitung dan simpan setiap properti model aset Anda.
  
  catatan
  Transformasi dan metrik yang terkait harus dikonfigurasi untuk lokasi yang sama. Untuk informasi selengkapnya tentang mengonfigurasi model Anda untuk edge, lihatMenyiapkan kemampuan tepi.
4. Pilih Simpan. Pada halaman model, konfigurasi Edge Anda sekarang harus Dikonfigurasi.

Membuat model aset (AWS CLI)

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk membuat model aset.

Gunakan operasi CreateAssetModel untuk membuat model aset dengan properti dan hierarki. Operasi ini mengharapkan muatan dengan struktur berikut.


{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
  "assetModelHierarchies": Array of AssetModelHierarchyDefinition
}

Untuk membuat model aset (AWS CLI)

Buat file bernama asset-model-payload.json dan kemudian salin objek JSON berikut ke dalam file.


{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "",
  "assetModelDescription": "",
  "assetModelProperties": [

  ],
  "assetModelHierarchies": [

  ],
  "assetModelCompositeModels": [

  ]
}

Gunakan editor teks JSON pilihan Anda untuk mengedit asset-model-payload.json file sebagai berikut:
1. Masukkan name (assetModelName) untuk model aset, seperti Wind Turbine atauWind Turbine Model. Nama ini harus unik di semua model aset dan model komponen di akun Anda dalam hal ini Wilayah AWS.
2. (Opsional) Masukkan ID eksternal (assetModelExternalId) untuk model aset. Ini adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Mereferensikan objek dengan ID eksternal di AWS IoT SiteWise Panduan Pengguna.
3. (Opsional) Masukkan deskripsi (assetModelDescription) untuk model aset, atau hapus pasangan assetModelDescription nilai kunci.
4. (Opsional) Tentukan properti aset (assetModelProperties) untuk model. Untuk informasi selengkapnya, lihat Mendefinisikan properti data.
5. (Opsional) Tentukan hierarki aset (assetModelHierarchies) untuk model. Untuk informasi selengkapnya, lihat Mendefinisikan hierarki model aset.
6. (Opsional) Tentukan alarm untuk model. Alarm memantau properti lain sehingga Anda dapat mengidentifikasi kapan peralatan atau proses memerlukan perhatian. Setiap definisi alarm adalah model komposit (assetModelCompositeModels) yang menstandarisasi serangkaian properti yang digunakan alarm. Untuk informasi selengkapnya, lihat Memantau data dengan alarm dan Mendefinisikan alarm pada model aset.
7. (Opsional) Tambahkan tag (tags) untuk model aset. Untuk informasi selengkapnya, lihat Menandai sumber daya Anda AWS IoT SiteWise.
Jalankan perintah berikut untuk membuat model aset dari definisi dalam file JSON.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
Operasi mengembalikan respons yang berisi assetModelId yang Anda rujuk saat membuat aset. Respons juga berisi status model (assetModelStatus.state), yang awalnyaCREATING. Status model aset adalah CREATING sampai perubahan menyebar.

catatan
Proses pembuatan model aset dapat memakan waktu hingga beberapa menit untuk model yang kompleks. Untuk memeriksa status model aset Anda saat ini, gunakan operasi DescribeAssetModel dengan menentukan. assetModelId Setelah status model asetACTIVE, Anda dapat menggunakan model aset untuk membuat aset. Untuk informasi selengkapnya, lihat Status aset dan model.
(Opsional) Buat model komposit khusus untuk model aset Anda. Dengan model komposit khusus, Anda dapat mengelompokkan properti dalam model, atau menyertakan subassembly dengan mereferensikan model komponen. Untuk informasi selengkapnya, lihat Membuat model komposit khusus (Komponen).

Contoh model aset

Bagian ini berisi contoh definisi model aset yang dapat Anda gunakan untuk membuat model aset dengan AWS CLI dan AWS IoT SiteWise SDK. Model aset ini mewakili turbin angin dan ladang angin. Aset turbin angin menelan data sensor mentah dan menghitung nilai seperti daya dan kecepatan angin rata-rata. Aset ladang angin menghitung nilai seperti daya total untuk semua turbin angin di ladang angin.

Model aset turbin angin

Model aset berikut mewakili turbin di ladang angin. Turbin angin menelan data sensor untuk menghitung nilai seperti daya dan kecepatan angin rata-rata.

catatan

Model contoh ini menyerupai model turbin angin dari AWS IoT SiteWise demo. Untuk informasi selengkapnya, lihat Menggunakan AWS IoT SiteWise demo.


{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "Wind Turbine Asset Model",
  "assetModelDescription": "Represents a turbine in a wind farm.",
  "assetModelProperties": [
    {
      "name": "Location",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Renton"
        }
      }
    },
    {
      "name": "Make",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Amazon"
        }
      }
    },
    {
      "name": "Model",
      "dataType": "INTEGER",
      "type": {
        "attribute": {
          "defaultValue": "500"
        }
      }
    },
    {
      "name": "Torque (KiloNewton Meter)",
      "dataType": "DOUBLE",
      "unit": "kNm",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "Wind Direction",
      "dataType": "DOUBLE",
      "unit": "Degrees",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "RotationsPerMinute",
      "dataType": "DOUBLE",
      "unit": "RPM",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "Wind Speed",
      "dataType": "DOUBLE",
      "unit": "m/s",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "RotationsPerSecond",
      "dataType": "DOUBLE",
      "unit": "RPS",
      "type": {
        "transform": {
          "expression": "rpm / 60",
          "variables": [
            {
              "name": "rpm",
              "value": {
                "propertyId": "RotationsPerMinute"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Overdrive State",
      "dataType": "DOUBLE",
      "type": {
        "transform": {
          "expression": "gte(torque, 3)",
          "variables": [
            {
              "name": "torque",
              "value": {
                "propertyId": "Torque (KiloNewton Meter)"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Average Power",
      "dataType": "DOUBLE",
      "unit": "Watts",
      "type": {
        "metric": {
          "expression": "avg(torque) * avg(rps) * 2 * 3.14",
          "variables": [
            {
              "name": "torque",
              "value": {
                "propertyId": "Torque (Newton Meter)"
              }
            },
            {
              "name": "rps",
              "value": {
                "propertyId": "RotationsPerSecond"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Average Wind Speed",
      "dataType": "DOUBLE",
      "unit": "m/s",
      "type": {
        "metric": {
          "expression": "avg(windspeed)",
          "variables": [
            {
              "name": "windspeed",
              "value": {
                "propertyId": "Wind Speed"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Torque (Newton Meter)",
      "dataType": "DOUBLE",
      "unit": "Nm",
      "type": {
        "transform": {
          "expression": "knm * 1000",
          "variables": [
            {
              "name": "knm",
              "value": {
                "propertyId": "Torque (KiloNewton Meter)"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Overdrive State Time",
      "dataType": "DOUBLE",
      "unit": "Seconds",
      "type": {
        "metric": {
          "expression": "statetime(overdrive_state)",
          "variables": [
            {
              "name": "overdrive_state",
              "value": {
                "propertyId": "Overdrive State"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    }
  ],
  "assetModelHierarchies": []
}

Model aset peternakan angin

Model aset berikut mewakili ladang angin yang terdiri dari beberapa turbin angin. Model aset ini mendefinisikan hierarki model turbin angin. Hal ini memungkinkan ladang angin menghitung nilai (seperti daya rata-rata) dari data untuk semua turbin angin di ladang angin.

catatan

Model contoh ini menyerupai model ladang angin dari AWS IoT SiteWise demo. Untuk informasi selengkapnya, lihat Menggunakan AWS IoT SiteWise demo.

Model aset ini tergantung padaModel aset turbin angin. Ganti propertyId dan childAssetModelId nilai dengan yang berasal dari model aset turbin angin yang ada.


{
  "assetModelName": "Wind Farm Asset Model",
  "assetModelDescription": "Represents a wind farm.",
  "assetModelProperties": [
    {
      "name": "Code",
      "dataType": "INTEGER",
      "type": {
        "attribute": {
          "defaultValue": "300"
        }
      }
    },
    {
      "name": "Location",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Renton"
        }
      }
    },
    {
      "name": "Reliability Manager",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Mary Major"
        }
      }
    },
    {
      "name": "Total Overdrive State Time",
      "dataType": "DOUBLE",
      "unit": "seconds",
      "type": {
        "metric": {
          "expression": "sum(overdrive_state_time)",
          "variables": [
            {
              "name": "overdrive_state_time",
              "value": {
                "propertyId": "ID of Overdrive State Time property in Wind Turbine Asset Model",
                "hierarchyId": "Turbine Asset Model"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Total Average Power",
      "dataType": "DOUBLE",
      "unit": "Watts",
      "type": {
        "metric": {
          "expression": "sum(turbine_avg_power)",
          "variables": [
            {
              "name": "turbine_avg_power",
              "value": {
                "propertyId": "ID of Average Power property in Wind Turbine Asset Model",
                "hierarchyId": "Turbine Asset Model"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    }
  ],
  "assetModelHierarchies": [
    {
      "name": "Turbine Asset Model",
      "childAssetModelId": "ID of Wind Turbine Asset Model"
    }
  ]
}

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Membuat model aset dan model komponen

Mendefinisikan hierarki model aset