Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat model aset di AWS IoT SiteWise
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 [Buat model komponen](create-component-models.md).
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.
**Topics**
+ [
## Buat model aset (konsol)
](#create-asset-model-console)
+ [
## Buat model aset (AWS CLI)
](#create-asset-model-cli)
+ [
## Contoh model aset
](#asset-model-examples)
+ [
# Tentukan hierarki model aset
](define-asset-hierarchies.md)
## Buat 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)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Model**.
1. Pilih **Buat model aset**.
1. Pada halaman **Create model**, lakukan hal berikut:
1. Masukkan **Nama** untuk model aset, seperti **Wind Turbine** atau**Wind Turbine Model**. Nama ini harus unik di semua model di akun Anda di Wilayah ini.
1. (Opsional) Tambahkan **ID Eksternal** untuk model. Ini adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat [Referensi objek dengan eksternal IDs](object-ids.md#external-id-references) di *AWS IoT SiteWise Panduan Pengguna*.
1. (Opsional) Tambahkan **definisi Pengukuran** untuk model. Pengukuran mewakili aliran data dari peralatan Anda. Untuk informasi selengkapnya, lihat [Tentukan aliran data dari peralatan (pengukuran)](measurements.md).
1. (Opsional) Tambahkan **definisi Transform** untuk model. Transformasi adalah rumus yang memetakan data dari satu bentuk ke bentuk lainnya. Untuk informasi selengkapnya, lihat [Mengubah data (mengubah)](transforms.md).
1. (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 subset operasi Anda. Untuk informasi selengkapnya, lihat [Data agregat dari properti dan aset lainnya (metrik)](metrics.md).
1. (Opsional) Tambahkan **definisi Hierarki** untuk model. Hierarki adalah hubungan antar aset. Untuk informasi selengkapnya, lihat [Tentukan hierarki model aset](define-asset-hierarchies.md).
1. (Opsional) Tambahkan tag untuk model aset. Untuk informasi selengkapnya, lihat [Tandai AWS IoT SiteWise sumber daya Anda](tag-resources.md).
1. 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](asset-and-model-states.md).
1. (Opsional) Setelah membuat model aset, Anda dapat mengonfigurasi model aset untuk edge. Untuk informasi lebih lanjut tentang SiteWise Edge, lihat[Konfigurasikan kemampuan tepi di AWS IoT SiteWise Edge](edge-data-collection-and-processing.md).
1. Pada halaman model, pilih **Configure for Edge**.
**catatan**
Fitur paket pemrosesan data (DPP) tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [Perubahan ketersediaan paket pemrosesan data](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html).
1. 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, lihat[Siapkan sumber OPC UA di SiteWise Edge](configure-opcua-source.md).
1. 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, lihat[Siapkan sumber OPC UA di SiteWise Edge](configure-opcua-source.md).
1. Pilih **Simpan**. Pada halaman model, **konfigurasi Edge** Anda sekarang harus **Dikonfigurasi**.
## Buat model aset (AWS CLI)
Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk membuat model aset.
Gunakan [CreateAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModel.html)operasi 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)**
1. Buat file bernama `asset-model-payload.json` dan kemudian salin objek JSON berikut ke dalam file.
```
{
"assetModelType": "ASSET_MODEL",
"assetModelName": "",
"assetModelDescription": "",
"assetModelProperties": [
],
"assetModelHierarchies": [
],
"assetModelCompositeModels": [
]
}
```
1. 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** atau**Wind Turbine Model**. Nama ini harus unik di semua model aset dan model komponen di akun Anda dalam hal ini Wilayah AWS.
1. (Opsional) Masukkan ID eksternal (`assetModelExternalId`) untuk model aset. Ini adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat [Referensi objek dengan eksternal IDs](object-ids.md#external-id-references) di *AWS IoT SiteWise Panduan Pengguna*.
1. (Opsional) Masukkan deskripsi (`assetModelDescription`) untuk model aset, atau hapus pasangan `assetModelDescription` nilai kunci.
1. (Opsional) Tentukan properti aset (`assetModelProperties`) untuk model. Untuk informasi selengkapnya, lihat [Tentukan properti data](asset-properties.md).
1. (Opsional) Tentukan hierarki aset (`assetModelHierarchies`) untuk model. Untuk informasi selengkapnya, lihat [Tentukan hierarki model aset](define-asset-hierarchies.md).
1. (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 [Pantau data dengan alarm di AWS IoT SiteWise](industrial-alarms.md) dan [Tentukan alarm pada model aset di AWS IoT SiteWise](define-alarms.md).
1. (Opsional) Tambahkan tag (`tags`) untuk model aset. Untuk informasi selengkapnya, lihat [Tandai AWS IoT SiteWise sumber daya Anda](tag-resources.md).
1. 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 awalnya`CREATING`. 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 [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operasi dengan menentukan. `assetModelId` Setelah status model aset`ACTIVE`, Anda dapat menggunakan model aset untuk membuat aset. Untuk informasi selengkapnya, lihat [Status aset dan model](asset-and-model-states.md).
1. (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 [Buat model komposit khusus (komponen)](create-custom-composite-models.md).
## 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 SDKs. 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.
**Topics**
+ [
### Model aset turbin angin
](#example-wind-turbine)
+ [
### Model aset peternakan angin
](#example-wind-farm)
### 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 [Gunakan AWS IoT SiteWise demo](getting-started-demo.md).
```
{
"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](define-asset-hierarchies.md) 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 [Gunakan AWS IoT SiteWise demo](getting-started-demo.md).
Model aset ini tergantung pada[Model aset turbin angin](#example-wind-turbine). 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"
}
]
}
```
# Tentukan hierarki model aset
Anda dapat menentukan hierarki model aset untuk membuat asosiasi logis antara model aset dalam operasi industri Anda. Misalnya, Anda dapat mendefinisikan ladang angin yang terdiri dari ladang angin darat dan lepas pantai. Sebuah ladang angin darat berisi turbin dan lokasi darat. Sebuah ladang angin lepas pantai berisi turbin dan lokasi lepas pantai.
![\[AWS IoT SiteWise hierarki ladang angin antara model aset.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/asset-model-hierarchies.png)
Saat Anda mengaitkan model aset anak ke model aset induk melalui hierarki, metrik model aset induk dapat memasukkan data dari metrik model aset anak. Anda dapat menggunakan hierarki dan metrik model aset untuk menghitung statistik yang memberikan wawasan tentang operasi Anda atau subset operasi Anda. Untuk informasi selengkapnya, lihat [Data agregat dari properti dan aset lainnya (metrik)](metrics.md).
Setiap hierarki mendefinisikan hubungan antara model aset induk dan model aset anak. Dalam model aset induk, Anda dapat menentukan beberapa hierarki ke model aset anak yang sama. Misalnya, jika Anda memiliki dua jenis turbin angin yang berbeda di ladang angin Anda, di mana semua turbin angin diwakili oleh model aset yang sama, Anda dapat menentukan hierarki untuk setiap jenis. Kemudian, Anda dapat menentukan metrik dalam model ladang angin untuk menghitung statistik independen dan gabungan untuk setiap jenis turbin angin.
Model aset induk dapat dikaitkan dengan beberapa model aset anak. Misalnya, jika Anda memiliki ladang angin darat dan ladang angin lepas pantai yang diwakili oleh dua model aset yang berbeda, Anda dapat mengaitkan model aset ini dengan model aset ladang angin induk yang sama.
Model aset anak juga dapat dikaitkan dengan beberapa model aset induk. Misalnya, jika Anda memiliki dua jenis ladang angin yang berbeda, di mana semua turbin angin diwakili oleh model aset yang sama, Anda dapat mengaitkan model aset turbin angin dengan model aset ladang angin yang berbeda.
**catatan**
Saat Anda menentukan hierarki model aset, model aset anak harus `ACTIVE` atau memiliki `ACTIVE` versi sebelumnya. Untuk informasi selengkapnya, lihat [Status aset dan model](asset-and-model-states.md).
Setelah menentukan model aset hierarkis dan membuat aset, Anda dapat mengaitkan aset untuk menyelesaikan hubungan induk-anak. Untuk informasi selengkapnya, lihat [Buat aset untuk model aset di AWS IoT SiteWise](create-assets.md) dan [Mengasosiasikan dan memisahkan aset](add-associated-assets.md).
**Topics**
+ [
## Tentukan hierarki model aset (konsol)
](#define-asset-hierarchies-console)
+ [
## Tentukan hierarki aset ()AWS CLI
](#define-asset-hierarchies-cli)
## Tentukan hierarki model aset (konsol)
Saat Anda menentukan hierarki untuk model aset di AWS IoT SiteWise konsol, Anda menentukan parameter berikut:
+ **Nama hierarki — Nama** hierarki, seperti. **Wind Turbines**
+ **Model hierarki — Model** aset anak.
+ **Hierarki ID Eksternal** (Opsional) - Ini adalah ID yang ditentukan pengguna. Untuk informasi selengkapnya, lihat [Referensi objek dengan eksternal IDs](object-ids.md#external-id-references) di *AWS IoT SiteWise Panduan Pengguna*.
Untuk informasi selengkapnya, lihat [Buat model aset (konsol)](create-asset-models.md#create-asset-model-console).
## Tentukan hierarki aset ()AWS CLI
Saat menentukan hierarki untuk model aset dengan AWS IoT SiteWise API, Anda menentukan parameter berikut:
+ `name`— Nama hierarki, seperti**Wind Turbines**.
+ `childAssetModelId`— ID atau ID eksternal model aset anak untuk hierarki. Anda dapat menggunakan [ListAssetModels](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssetModels.html)operasi untuk menemukan ID model aset yang ada.
**Example Contoh definisi hierarki**
Contoh berikut menunjukkan hierarki model aset yang mewakili hubungan ladang angin dengan turbin angin. Objek ini adalah contoh dari sebuah [AssetModelHierarchy](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetModelHierarchy.html). Untuk informasi selengkapnya, lihat [Buat model aset (AWS CLI)](create-asset-models.md#create-asset-model-cli).
```
{
...
"assetModelHierarchies": [
{
"name": "Wind Turbines",
"childAssetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
},
]
}
```