Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pantau data dengan alarm di AWS IoT SiteWise
Anda dapat mengonfigurasi alarm untuk data Anda untuk mengingatkan tim Anda saat peralatan atau proses berjalan secara sub-optimal. Kinerja optimal mesin atau proses berarti bahwa nilai untuk metrik tertentu harus berada dalam kisaran batas tinggi dan rendah. Ketika metrik ini berada di luar jangkauan operasinya, operator peralatan harus diberi tahu sehingga mereka dapat memperbaiki masalah. Gunakan alarm untuk mengidentifikasi masalah dengan cepat dan memberi tahu operator untuk memaksimalkan kinerja peralatan dan proses Anda.
**Topics**
+ [Jenis alarm](#alarm-types)
+ [Status alarm](#alarm-states)
+ [Properti status alarm](#alarm-state-properties)
+ [Tentukan alarm pada model aset di AWS IoT SiteWise](define-alarms.md)
+ [Konfigurasikan alarm pada aset di AWS IoT SiteWise](configure-alarms.md)
+ [Menanggapi alarm di AWS IoT SiteWise](respond-to-alarms.md)
+ [Menelan status alarm eksternal di AWS IoT SiteWise](ingest-external-alarm-state.md)
## Jenis alarm
Anda dapat menentukan alarm yang mendeteksi di AWS Cloud dan alarm yang Anda deteksi dengan proses eksternal. AWS IoT SiteWise mendukung jenis alarm berikut:
+ **AWS IoT Events alarm**
**catatan**
Pemberitahuan akhir dukungan: AWS mengakhiri dukungan untuk AWS IoT Events. Untuk informasi lebih lanjut, lihat [AWS IoT Events akhir dukungan](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
AWS IoT Events Alarm adalah alarm yang mendeteksi. AWS IoT Events AWS IoT SiteWise mengirimkan nilai properti aset ke model alarm di AWS IoT Events. Kemudian, AWS IoT Events kirim status alarm ke AWS IoT SiteWise. Anda dapat mengonfigurasi opsi seperti saat alarm mendeteksi dan siapa yang harus diberi tahu saat status alarm berubah. Anda juga dapat menentukan [AWS IoT Events tindakan](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-supported-actions.html) yang terjadi ketika status alarm berubah.
Alarm AWS IoT Events dalam contoh model alarm. Model alarm menentukan ambang batas dan tingkat keparahan alarm, apa yang harus dilakukan ketika status alarm berubah, dan banyak lagi. Saat mengonfigurasi setiap sifat model alarm, Anda menentukan properti atribut dari model aset yang dipantau alarm. Semua aset berdasarkan model aset menggunakan nilai atribut saat AWS IoT Events mengevaluasi sifat alarm tersebut. Untuk informasi selengkapnya, lihat [Menggunakan alarm](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-alarms.html) di *Panduan AWS IoT Events Pengembang*.
Anda dapat merespons AWS IoT Events alarm saat berubah status. Misalnya, Anda dapat mengenali atau menunda alarm saat alarm menjadi aktif. Anda juga dapat mengaktifkan, menonaktifkan, dan mengatur ulang alarm.
SiteWise Pengguna monitor dapat memvisualisasikan, mengonfigurasi, dan merespons AWS IoT Events alarm di portal SiteWise Monitor. Untuk informasi selengkapnya, lihat [Memantau dengan alarm](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/monitor-alarms.html) di *Panduan AWS IoT SiteWise Monitor Aplikasi*.
**catatan**
AWS IoT Events biaya berlaku untuk mengevaluasi alarm ini dan mentransfer data antara AWS IoT SiteWise dan AWS IoT Events. Untuk informasi selengkapnya, lihat [harga AWS IoT Events](https://aws.amazon.com/iot-events/pricing/).
+ **Alarm eksternal**
Alarm eksternal adalah alarm yang Anda evaluasi di luar. AWS IoT SiteWise Gunakan alarm eksternal jika Anda memiliki sumber data yang melaporkan status alarm. Alarm eksternal berisi properti pengukuran tempat Anda menelan data status alarm.
Anda tidak dapat mengakui atau menunda alarm eksternal saat berubah status.
SiteWise Pengguna monitor dapat melihat status alarm eksternal di portal SiteWise Monitor, tetapi mereka tidak dapat mengonfigurasi atau merespons alarm ini.
AWS IoT SiteWise tidak mengevaluasi keadaan alarm eksternal.
## Status alarm
Alarm industri mencakup informasi tentang keadaan peralatan atau proses yang mereka pantau dan (opsional) informasi tentang respons operator terhadap status alarm.
Saat Anda menentukan AWS IoT Events alarm, Anda menentukan apakah akan mengaktifkan *alur pengakuan* atau tidak. Alur pengakuan diaktifkan secara default. Saat Anda mengaktifkan opsi ini, operator dapat mengenali alarm dan meninggalkan catatan dengan detail tentang alarm atau tindakan yang mereka ambil untuk mengatasinya. Jika operator tidak mengakui alarm aktif sebelum menjadi tidak aktif, alarm menjadi terkunci. Status terkunci menunjukkan bahwa alarm menjadi aktif dan tidak dikenali, sehingga operator perlu memeriksa peralatan atau proses dan mengakui alarm yang terkunci.
Alarm memiliki status berikut:
+ **Normal** (`Normal`) - Alarm diaktifkan tetapi tidak aktif. Proses atau peralatan industri beroperasi seperti yang diharapkan.
+ **Aktif** (`Active`) — Alarm aktif. Proses atau peralatan industri berada di luar jangkauan operasinya dan perlu diperhatikan.
+ **Diakui** (`Acknowledged`) — Operator mengakui status alarm.
Status ini hanya berlaku untuk alarm tempat Anda mengaktifkan aliran pengakuan.
+ **Latched** (`Latched`) — Alarm kembali normal tetapi aktif dan tidak ada operator yang mengakuinya. Proses atau peralatan industri membutuhkan perhatian dari operator untuk mengatur ulang alarm ke normal.
Status ini hanya berlaku untuk alarm tempat Anda mengaktifkan aliran pengakuan.
+ **Snoozed** (`SnoozeDisabled`) — Alarm dinonaktifkan karena operator menunda alarm. Operator menentukan durasi alarm tunda. Setelah durasi itu, alarm kembali ke keadaan normal.
+ **Disabled** (`Disabled`) - Alarm dinonaktifkan dan tidak akan mendeteksi.
## Properti status alarm
AWS IoT SiteWise menyimpan data status alarm sebagai objek JSON yang diserialisasikan ke string. Objek ini berisi status dan informasi tambahan tentang alarm, seperti tindakan respons operator dan aturan yang dievaluasi alarm.
Anda mengidentifikasi properti status alarm dengan nama dan jenis strukturnya,`AWS/ALARM_STATE`. Untuk informasi selengkapnya, lihat [Tentukan alarm pada model aset di AWS IoT SiteWise](define-alarms.md).
Objek data status alarm berisi informasi berikut:
`stateName`
Status alarm. Untuk informasi selengkapnya, lihat [Status alarm](#alarm-states).
Tipe data: `STRING`
`customerAction`
(Opsional) Objek yang berisi informasi tentang respons operator terhadap alarm. Operator dapat mengaktifkan, menonaktifkan, mengakui, dan menunda alarm. Ketika mereka melakukannya, data status alarm mencakup respons mereka dan catatan yang dapat mereka tinggalkan saat mereka merespons. Objek ini berisi informasi berikut:
`actionName`
Nama tindakan yang diambil operator untuk menanggapi alarm. Nilai ini berisi salah satu string berikut:
+ `ENABLE`
+ `DISABLE`
+ `SNOOZE`
+ `ACKNOWLEDGE`
+ `RESET`
Tipe data: `STRING`
`enable`
(Opsional) Objek yang ada `customerAction` saat operator mengaktifkan alarm. Saat operator mengaktifkan alarm, status alarm berubah menjadi`Normal`. Objek ini berisi informasi berikut:
`note`
(Opsional) Catatan bahwa pelanggan pergi ketika mereka mengaktifkan alarm.
Tipe data: `STRING`
Panjang maksimal: 128 karakter
`disable`
(Opsional) Objek yang ada `customerAction` saat operator menonaktifkan alarm. Saat operator mengaktifkan alarm, status alarm berubah menjadi`Disabled`. Objek ini berisi informasi berikut:
`note`
(Opsional) Catatan bahwa pelanggan pergi ketika mereka menonaktifkan alarm.
Tipe data: `STRING`
Panjang maksimal: 128 karakter
`acknowledge`
(Opsional) Objek yang ada di `customerAction` saat operator mengakui alarm. Saat operator mengaktifkan alarm, status alarm berubah menjadi`Acknowledged`. Objek ini berisi informasi berikut:
`note`
(Opsional) Catatan bahwa pelanggan meninggalkan ketika mereka mengakui alarm.
Tipe data: `STRING`
Panjang maksimal: 128 karakter
`snooze`
(Opsional) Objek yang ada `customerAction` saat operator menunda alarm. Saat operator mengaktifkan alarm, status alarm berubah menjadi`SnoozeDisabled`. Objek ini berisi informasi berikut:
`snoozeDuration`
Durasi dalam hitungan detik operator menunda alarm. Alarm berubah menjadi `Normal` status setelah durasi ini.
Tipe data: `INTEGER`
`note`
(Opsional) Catatan bahwa pelanggan pergi ketika mereka menunda alarm.
Tipe data: `STRING`
Panjang maksimal: 128 karakter
`ruleEvaluation`
(Opsional) Objek yang berisi informasi tentang aturan yang mengevaluasi alarm. Objek ini berisi informasi berikut:
`simpleRule`
Objek yang berisi informasi tentang aturan sederhana, yang membandingkan nilai properti dengan nilai ambang batas dengan operator perbandingan. Objek ini berisi informasi berikut:
`inputProperty`
Nilai properti yang dievaluasi alarm ini.
Tipe data: `DOUBLE`
`operator`
Operator perbandingan yang digunakan alarm ini untuk membandingkan properti dengan ambang batas. Nilai ini berisi salah satu string berikut:
+ `<`- Kurang dari
+ `<=`- Kurang dari atau sama
+ `==`— Sama
+ `!=`- Tidak sama
+ `>=`Lebih besar dari atau sama
+ `>`Lebih besar dari
Tipe data: `STRING`
`threshold`
Nilai ambang batas yang dibandingkan dengan nilai properti alarm ini.
Tipe data: `DOUBLE`
# Tentukan alarm pada model aset di AWS IoT SiteWise
Model aset mendorong standardisasi data industri dan alarm Anda. Anda dapat menentukan definisi alarm pada model aset untuk membakukan alarm untuk semua aset berdasarkan model aset.
Anda menggunakan *model aset komposit* untuk menentukan alarm pada model aset. Model aset komposit adalah model aset yang menstandarisasi serangkaian properti tertentu pada model aset lain. Model aset komposit memastikan bahwa properti tertentu hadir pada model aset. Alarm memiliki tipe, status, dan properti sumber (opsional), sehingga model komposit alarm memberlakukan bahwa properti ini ada.
Setiap model aset komposit memiliki tipe yang mendefinisikan properti untuk model komposit tersebut. Model komposit alarm menentukan properti untuk jenis alarm, status alarm, dan sumber alarm (opsional). Saat Anda membuat aset dari model aset dengan model komposit, aset tersebut menyertakan properti dari model komposit bersama properti yang Anda tentukan dalam model aset.
Setiap properti dalam model komposit harus memiliki nama yang mengidentifikasinya untuk jenis model komposit. Properti model komposit mendukung properti dengan tipe data yang kompleks. Properti ini memiliki tipe `STRUCT` data dan `dataTypeSpec` sifat yang menentukan tipe data kompleks properti. Properti tipe data yang kompleks berisi data JSON yang diserialkan sebagai string.
Model komposit alarm memiliki sifat berikut. Setiap properti harus memiliki nama yang mengidentifikasinya untuk jenis model komposit ini.
**Jenis alarm**
Jenis alarm. Tentukan satu dari yang berikut ini:
+ `IOT_EVENTS`— AWS IoT Events Alarm. AWS IoT SiteWise mengirimkan data AWS IoT Events untuk mengevaluasi keadaan alarm ini. Anda harus menentukan properti sumber alarm untuk menentukan model AWS IoT Events alarm untuk definisi alarm ini.
**catatan**
Pemberitahuan akhir dukungan: AWS mengakhiri dukungan untuk AWS IoT Events. Untuk informasi lebih lanjut, lihat [AWS IoT Events akhir dukungan](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
+ `EXTERNAL`— Alarm eksternal. Anda menelan keadaan alarm sebagai pengukuran.
Nama properti: `AWS/ALARM_TYPE`
Jenis properti: [atribut](attributes.md)
Tipe data: `STRING`
**Status alarm**
Data deret waktu untuk keadaan alarm. Ini adalah objek yang diserialkan sebagai string yang berisi status dan informasi lain tentang alarm. Untuk informasi selengkapnya, lihat [Properti status alarm](industrial-alarms.md#alarm-state-properties).
Nama properti: `AWS/ALARM_STATE`
Jenis properti: [pengukuran](measurements.md)
Tipe data: `STRUCT`
Jenis struktur data: `AWS/ALARM_STATE`
**Sumber alarm**
(Opsional) Nama Sumber Daya Amazon (ARN) dari sumber daya yang mengevaluasi status alarm. Untuk AWS IoT Events alarm, ini adalah ARN dari model alarm.
Nama properti: `AWS/ALARM_SOURCE`
Jenis properti: [atribut](attributes.md)
Tipe data: `STRING`
**Example Contoh model komposit alarm**
Model aset berikut mewakili boiler yang memiliki alarm untuk memantau suhunya. AWS IoT SiteWise mengirimkan data suhu AWS IoT Events untuk mendeteksi alarm.
```
{
"assetModelName": "Boiler",
"assetModelDescription": "A boiler that alarms when its temperature exceeds its limit.",
"assetModelProperties": [
{
"name": "Temperature",
"dataType": "DOUBLE",
"unit": "Celsius",
"type": {
"measurement": {}
}
},
{
"name": "High Temperature",
"dataType": "DOUBLE",
"unit": "Celsius",
"type": {
"attribute": {
"defaultValue": "105.0"
}
}
}
],
"assetModelCompositeModels": [
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "IOT_EVENTS"
}
}
},
{
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
},
{
"name": "AWS/ALARM_SOURCE",
"dataType": "STRING",
"type": {
"attribute": {}
}
}
]
}
]
}
```
**Topics**
+ [Persyaratan untuk pemberitahuan alarm di AWS IoT SiteWise](iot-events-alarm-notification-requirements.md)
+ [Tentukan AWS IoT Events alarm untuk AWS IoT SiteWise](define-iot-events-alarms.md)
+ [Tentukan alarm eksternal di AWS IoT SiteWise](define-external-alarms.md)
# Persyaratan untuk pemberitahuan alarm di AWS IoT SiteWise
AWS IoT Events menggunakan AWS Lambda fungsi di AWS akun Anda untuk mengirim pemberitahuan alarm. Anda harus membuat fungsi Lambda ini di AWS Wilayah yang sama dengan alarm Anda untuk mengaktifkan pemberitahuan alarm. Fungsi Lambda ini menggunakan [Amazon Simple Notification Service (Amazon](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) SNS) untuk mengirim notifikasi teks dan [Amazon Simple Email Service (Amazon SES) untuk mengirim pemberitahuan email](https://docs.aws.amazon.com/ses/latest/dg/Welcome.html). Saat Anda membuat AWS IoT Events alarm, Anda mengonfigurasi protokol dan pengaturan yang digunakan alarm untuk mengirim pemberitahuan.
**catatan**
Pemberitahuan akhir dukungan: AWS mengakhiri dukungan untuk AWS IoT Events. Untuk informasi lebih lanjut, lihat [AWS IoT Events akhir dukungan](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
AWS IoT Events menyediakan template AWS CloudFormation tumpukan yang dapat Anda gunakan untuk membuat fungsi Lambda ini di akun Anda. Untuk informasi selengkapnya, lihat [Fungsi Lambda pemberitahuan alarm](https://docs.aws.amazon.com/iotevents/latest/developerguide/lambda-support.html) di Panduan *AWS IoT Events Pengembang*.
# Tentukan AWS IoT Events alarm untuk AWS IoT SiteWise
**catatan**
Pemberitahuan akhir dukungan: AWS mengakhiri dukungan untuk AWS IoT Events. Untuk informasi lebih lanjut, lihat [AWS IoT Events akhir dukungan](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).
Saat Anda membuat AWS IoT Events alarm, AWS IoT SiteWise kirimkan nilai properti aset AWS IoT Events ke untuk mengevaluasi status alarm. AWS IoT Events definisi alarm bergantung pada model alarm yang Anda tentukan AWS IoT Events. Untuk menentukan AWS IoT Events alarm pada model aset, Anda menentukan model komposit alarm yang menentukan model AWS IoT Events alarm sebagai properti sumber alarmnya.
AWS IoT Events alarm tergantung pada input seperti ambang alarm dan pengaturan pemberitahuan alarm. Anda mendefinisikan input ini sebagai atribut pada model aset. Anda kemudian dapat menyesuaikan input ini pada setiap aset berdasarkan model. AWS IoT SiteWise Konsol dapat membuat atribut ini untuk Anda. Jika Anda mendefinisikan alarm dengan API AWS CLI atau, Anda harus menentukan atribut ini secara manual pada model aset.
Anda juga dapat menentukan tindakan lain yang terjadi ketika alarm Anda mendeteksi, seperti tindakan pemberitahuan alarm khusus. Misalnya, Anda dapat mengonfigurasi tindakan yang mengirimkan pemberitahuan push ke topik Amazon SNS. Untuk informasi selengkapnya tentang tindakan yang dapat Anda tentukan, lihat [Bekerja dengan AWS layanan lain](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-other-aws-services.html) di *Panduan AWS IoT Events Pengembang*.
Saat Anda memperbarui atau menghapus model aset, AWS IoT SiteWise dapat memeriksa apakah model alarm di AWS IoT Events memantau properti aset yang terkait dengan model aset ini. Ini mencegah Anda menghapus properti aset yang saat ini digunakan AWS IoT Events alarm. Untuk mengaktifkan fitur ini AWS IoT SiteWise, Anda harus memiliki `iotevents:ListInputRoutings` izin. Izin ini memungkinkan AWS IoT SiteWise untuk melakukan panggilan ke operasi [ListInputRoutings](https://docs.aws.amazon.com/iotevents/latest/apireference/API_ListInputRoutings.html)API yang didukung oleh AWS IoT Events. Untuk informasi selengkapnya, lihat [ListInputRoutings Izin (Opsional)](alarms-iam-permissions.md#alarms-listInputRoutings-permissions).
**catatan**
Fitur pemberitahuan alarm tidak tersedia di Wilayah Tiongkok (Beijing).
**Topics**
+ [Tentukan AWS IoT Events alarm (AWS IoT SiteWise konsol)](#define-iot-events-alarm-console)
+ [Tentukan AWS IoT Events alarm (AWS IoT Events konsol)](#define-iot-events-alarm-console-ite-console)
+ [Tentukan AWS IoT Events alarm (AWS CLI)](#define-iot-events-alarm-cli)
## Tentukan AWS IoT Events alarm (AWS IoT SiteWise konsol)
Anda dapat menggunakan AWS IoT SiteWise konsol untuk menentukan AWS IoT Events alarm pada model aset yang ada. Untuk menentukan AWS IoT Events alarm pada model aset baru, buat model aset, lalu selesaikan langkah-langkah ini. Untuk informasi selengkapnya, lihat [Buat model aset di AWS IoT SiteWise](create-asset-models.md).
**penting**
Setiap alarm memerlukan atribut yang menentukan nilai ambang untuk dibandingkan dengan alarm. Anda harus menentukan atribut nilai ambang pada model aset sebelum Anda dapat menentukan alarm.
Pertimbangkan contoh di mana Anda ingin menentukan alarm yang mendeteksi ketika turbin angin melebihi peringkat kecepatan angin maksimum 50 mph. Sebelum Anda menentukan alarm, Anda harus menentukan atribut (**Kecepatan angin maksimum**) dengan nilai default`50`.
**Untuk menentukan AWS IoT Events alarm pada model aset**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Model**.
1. Pilih model aset untuk menentukan alarm.
1. Pilih tab **Alarm**.
1. Pilih **Tambahkan alarm**.
1. Di bagian **Opsi jenis alarm**, pilih **AWS IoT Events alarm**.
1. Di bagian **Detail alarm**, lakukan hal berikut:
1. Masukkan nama untuk alarm Anda.
1. (Opsional) Masukkan deskripsi untuk alarm Anda.
1. Di bagian **Definisi ambang batas**, Anda menentukan kapan alarm mendeteksi dan tingkat keparahan alarm. Lakukan hal-hal berikut:
1. Pilih **Properti** tempat alarm mendeteksi. Setiap kali properti ini menerima nilai baru, AWS IoT SiteWise mengirimkan nilai AWS IoT Events ke untuk mengevaluasi keadaan alarm.
1. Pilih **Operator** yang akan digunakan untuk membandingkan properti dengan nilai ambang batas. Pilih dari salah satu pilihan berikut:
+ **< kurang dari**
+ **<= kurang dari atau sama**
+ **== sama**
+ **\$1 = tidak sama**
+ **>= lebih besar dari atau sama**
+ **> lebih besar dari**
1. Untuk **Nilai**, pilih properti atribut yang akan digunakan sebagai nilai ambang batas. AWS IoT Events membandingkan nilai properti dengan nilai atribut ini.
1. Masukkan **tingkat keparahan** alarm. Gunakan nomor yang dipahami tim Anda untuk mencerminkan tingkat keparahan alarm ini.
1. (Opsional) Di **pengaturan Pemberitahuan - bagian *opsional***, lakukan hal berikut:
1. Pilih **Aktif**.
**catatan**
Jika Anda memilih **Tidak Aktif**, Anda dan tim Anda tidak akan menerima pemberitahuan alarm apa pun.
1. Untuk **Penerima**, pilih penerima.
**penting**
Anda dapat mengirim pemberitahuan alarm ke AWS IAM Identity Center pengguna. Untuk menggunakan fitur ini, Anda harus mengaktifkan IAM Identity Center. Anda hanya dapat mengaktifkan Pusat Identitas IAM di satu AWS Wilayah pada satu waktu. Ini berarti Anda dapat menentukan pemberitahuan alarm hanya di Wilayah tempat Anda mengaktifkan Pusat Identitas IAM. Untuk informasi selengkapnya, lihat [Memulai](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) di *Panduan AWS IAM Identity Center Pengguna*.
1. Untuk **Protokol**, pilih dari opsi berikut:
+ **Email & teks** - Alarm memberi tahu pengguna IAM Identity Center dengan pesan SMS dan pesan email.
+ **Email** — Alarm memberi tahu pengguna IAM Identity Center dengan pesan email.
+ **Teks** — Alarm memberi tahu pengguna IAM Identity Center dengan pesan SMS.
1. Untuk **Pengirim**, pilih pengirim.
**penting**
Anda harus memverifikasi alamat email pengirim di Amazon Simple Email Service (Amazon SES). Untuk informasi selengkapnya, lihat [Memverifikasi identitas alamat email](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-email-proc), di *Panduan Pengembang Layanan Email Sederhana Amazon*.
1. Di bagian **Status aset default**, Anda dapat mengatur status default untuk alarm yang dibuat dari model aset ini.
**catatan**
Anda mengaktifkan atau menonaktifkan alarm ini untuk aset yang Anda buat dari model aset ini di langkah selanjutnya.
1. Di bagian **Pengaturan lanjutan**, Anda dapat mengonfigurasi izin, pengaturan pemberitahuan tambahan, tindakan status alarm, model alarm di SiteWise Monitor, dan aliran pengakuan.
**catatan**
AWS IoT Events alarm memerlukan peran layanan berikut:
Peran yang AWS IoT Events mengasumsikan untuk mengirim nilai status alarm ke AWS IoT SiteWise.
Peran yang AWS IoT Events mengasumsikan untuk mengirim data ke Lambda. Anda hanya perlu peran ini jika alarm Anda mengirimkan notifikasi.
Di bagian **Izin**, lakukan hal berikut:
1. Untuk **AWS IoT Events peran**, gunakan peran yang ada atau buat peran dengan izin yang diperlukan. Peran ini membutuhkan `iotsitewise:BatchPutAssetPropertyValue` izin dan hubungan kepercayaan yang memungkinkan iotevents.amazonaws.com untuk mengambil peran tersebut.
1. Untuk peran **AWS IoT Events Lambda, gunakan peran** yang ada atau buat peran dengan izin yang diperlukan. Peran ini membutuhkan `lambda:InvokeFunction` dan `sso-directory:DescribeUser` izin dan hubungan kepercayaan yang memungkinkan `iotevents.amazonaws.com` untuk mengambil peran.
1. (Opsional) Di bagian **Pengaturan pemberitahuan tambahan**, lakukan hal berikut:
1. Untuk **atribut Penerima**, Anda menentukan atribut yang nilainya menentukan penerima pemberitahuan. Anda dapat memilih pengguna IAM Identity Center sebagai penerima.
Anda dapat membuat atribut atau menggunakan atribut yang ada pada model aset.
+ Jika Anda memilih **Buat atribut penerima baru**, tentukan **nama atribut Penerima** dan **nilai default Penerima - **opsional**** untuk atribut.
+ Jika Anda memilih **Gunakan atribut penerima yang ada**, pilih atribut di **Nama atribut Penerima**. Alarm menggunakan nilai default atribut yang Anda pilih.
Anda dapat mengganti nilai default pada setiap aset yang Anda buat dari model aset ini.
1. Untuk **atribut pesan kustom**, Anda menentukan atribut yang nilainya menentukan pesan kustom yang akan dikirim selain pesan perubahan status default. Misalnya, Anda dapat menentukan pesan yang membantu tim Anda memahami cara mengatasi alarm ini.
Anda dapat memilih untuk membuat atribut atau menggunakan atribut yang ada pada model aset.
+ Jika Anda memilih untuk **Membuat atribut pesan kustom baru**, tentukan **nama atribut pesan kustom** **dan Nilai default pesan kustom - *opsional*** untuk atribut.
+ Jika Anda memilih **Gunakan atribut pesan kustom yang ada**, pilih atribut di **Nama atribut pesan kustom**. Alarm menggunakan nilai default atribut yang Anda pilih.
Anda dapat mengganti nilai default pada setiap aset yang Anda buat dari model aset ini.
1. Untuk **Kelola fungsi Lambda Anda**, lakukan salah satu hal berikut:
+ Untuk AWS IoT SiteWise membuat fungsi Lambda baru, pilih **Buat lambda baru dari templat yang dikelola AWS**.
+ Untuk menggunakan fungsi Lambda yang ada, pilih **Gunakan lambda yang ada** dan pilih nama fungsi.
Untuk informasi selengkapnya, lihat [Mengelola notifikasi alarm](https://docs.aws.amazon.com/iotevents/latest/developerguide/lambda-support.html) di *Panduan AWS IoT Events Pengembang*.
1. (Opsional) Di bagian **Set state action**, lakukan hal berikut:
1. Pilih **Edit tindakan**.
1. **Di bawah **Tambahkan tindakan status alarm**, tambahkan tindakan. dan pilih Simpan.**
Anda dapat menambahkan hingga 10 tindakan.
AWS IoT Events dapat melakukan tindakan saat alarm aktif. Anda dapat menentukan tindakan bawaan untuk menggunakan timer atau mengatur variabel, atau mengirim data ke AWS sumber daya lain. Untuk informasi selengkapnya, lihat [Tindakan yang didukung](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-supported-actions.html) di *Panduan AWS IoT Events Pengembang*.
1. (Opsional) Di bawah **Kelola model alarm di SiteWise Monitor - *opsional***, pilih **Aktif** atau **Tidak Aktif**.
Gunakan opsi ini sehingga Anda dapat memperbarui model alarm di SiteWise Monitorss. Pengaturan ini diaktifkan secara default.
1. Di bawah **Akui aliran**, pilih **Aktif atau **Tidak** Aktif**. Untuk informasi lebih lanjut tentang aliran pengakuan, lihat[Status alarm](industrial-alarms.md#alarm-states).
1. Pilih **Tambahkan alarm**.
**catatan**
AWS IoT SiteWise Konsol membuat beberapa permintaan API untuk menambahkan alarm ke model aset. Saat Anda memilih **Tambah alarm**, konsol akan membuka kotak dialog yang menunjukkan kemajuan permintaan API ini. Tetap di halaman ini sampai setiap permintaan API berhasil atau sampai permintaan API gagal. Jika permintaan gagal, tutup kotak dialog, perbaiki masalah, dan pilih **Tambahkan alarm** untuk mencoba lagi.
## Tentukan AWS IoT Events alarm (AWS IoT Events konsol)
Anda dapat menggunakan AWS IoT Events konsol untuk menentukan AWS IoT Events alarm pada model aset yang ada. Untuk menentukan AWS IoT Events alarm pada model aset baru, buat model aset, lalu selesaikan langkah-langkah ini. Untuk informasi selengkapnya, lihat [Buat model aset di AWS IoT SiteWise](create-asset-models.md).
**penting**
Setiap alarm memerlukan atribut yang menentukan nilai ambang untuk dibandingkan dengan alarm. Anda harus menentukan atribut nilai ambang pada model aset sebelum Anda dapat menentukan alarm.
Pertimbangkan contoh di mana Anda ingin menentukan alarm yang mendeteksi ketika turbin angin melebihi peringkat kecepatan angin maksimum 50 mph. Sebelum Anda menentukan alarm, Anda harus menentukan atribut (**Kecepatan angin maksimum**) dengan nilai default`50`.
**Untuk menentukan AWS IoT Events alarm pada model aset**
1. Navigasikan ke [konsol AWS IoT Events](https://console.aws.amazon.com/iotevents/) tersebut.
1. Di panel navigasi, pilih **Model alarm**.
1. Pilih **Buat model alarm**.
1. Masukkan nama untuk alarm Anda.
1. (Opsional) Masukkan deskripsi untuk alarm Anda.
1. Di bagian **Target alarm**, lakukan hal berikut:
1. Untuk **opsi Target**, pilih **properti AWS IoT SiteWise aset**.
1. Pilih model aset yang ingin Anda tambahkan alarmnya.
1. Di bagian **Definisi ambang batas**, Anda menentukan kapan alarm mendeteksi dan tingkat keparahan alarm. Lakukan hal-hal berikut:
1. Pilih **Properti** tempat alarm mendeteksi. Setiap kali properti ini menerima nilai baru, AWS IoT SiteWise mengirimkan nilai AWS IoT Events ke untuk mengevaluasi keadaan alarm.
1. Pilih **Operator** yang akan digunakan untuk membandingkan properti dengan nilai ambang batas. Pilih dari salah satu pilihan berikut:
+ **< kurang dari**
+ **<= kurang dari atau sama**
+ **== sama**
+ **\$1 = tidak sama**
+ **>= lebih besar dari atau sama**
+ **> lebih besar dari**
1. Untuk **Nilai**, pilih properti atribut yang akan digunakan sebagai nilai ambang batas. AWS IoT Events membandingkan nilai properti dengan nilai atribut ini.
1. Masukkan **tingkat keparahan** alarm. Gunakan nomor yang dipahami tim Anda untuk mencerminkan tingkat keparahan alarm ini.
1. (Opsional) Di **pengaturan Pemberitahuan - bagian *opsional***, lakukan hal berikut:
1. Untuk **Protokol**, pilih dari opsi berikut:
+ **Email & teks** - Alarm memberi tahu pengguna IAM Identity Center dengan pesan SMS dan pesan email.
+ **Email** — Alarm memberi tahu pengguna IAM Identity Center dengan pesan email.
+ **Teks** — Alarm memberi tahu pengguna IAM Identity Center dengan pesan SMS.
1. Untuk **Pengirim**, pilih pengirim.
**penting**
Anda harus memverifikasi alamat email pengirim di Amazon Simple Email Service (Amazon SES). Untuk informasi selengkapnya, lihat [Memverifikasi alamat email di Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html), di *Panduan Pengembang Layanan Email Sederhana Amazon*.
1. Pilih atribut di **atribut Penerima - *opsional***. Alarm menggunakan nilai default atribut yang Anda pilih.
1. Pilih atribut di **atribut pesan kustom - *opsional***. Alarm menggunakan nilai default atribut yang Anda pilih.
1. Di bagian **Instance**, tentukan **status Default** untuk alarm ini. Anda dapat mengaktifkan atau menonaktifkan alarm ini untuk semua aset yang Anda buat dari model aset ini di langkah selanjutnya.
1. Dalam **pengaturan Pengaturan lanjutan**, Anda dapat mengonfigurasi izin, pengaturan pemberitahuan tambahan, tindakan status alarm, model alarm di SiteWise Monitor, dan aliran pengakuan.
**catatan**
AWS IoT Events alarm memerlukan peran layanan berikut:
Peran yang AWS IoT Events mengasumsikan untuk mengirim nilai status alarm ke AWS IoT SiteWise.
Peran yang AWS IoT Events mengasumsikan untuk mengirim data ke Lambda. Anda hanya perlu peran ini jika alarm Anda mengirimkan notifikasi.
1. Di bagian **Akui alur**, pilih **Diaktifkan** atau **Dinonaktifkan**. Untuk informasi lebih lanjut tentang aliran pengakuan, lihat[Status alarm](industrial-alarms.md#alarm-states).
1. Di bagian **Izin**, lakukan hal berikut:
1. Untuk **AWS IoT Events peran**, gunakan peran yang ada atau buat peran dengan izin yang diperlukan. Peran ini membutuhkan `iotsitewise:BatchPutAssetPropertyValue` izin dan hubungan kepercayaan yang memungkinkan iotevents.amazonaws.com untuk mengambil peran tersebut.
1. Untuk peran **Lambda, gunakan peran** yang ada atau buat peran dengan izin yang diperlukan. Peran ini membutuhkan `lambda:InvokeFunction` dan `sso-directory:DescribeUser` izin dan hubungan kepercayaan yang memungkinkan `iotevents.amazonaws.com` untuk mengambil peran.
1. (Opsional) Di panel **Pengaturan pemberitahuan tambahan**, lakukan hal berikut:
1. Untuk **Kelola fungsi Lambda Anda**, lakukan salah satu hal berikut:
+ Untuk AWS IoT Events membuat fungsi Lambda baru, pilih **Buat fungsi Lambda** baru.
+ Untuk menggunakan fungsi Lambda yang ada, pilih **Gunakan fungsi Lambda yang ada dan pilih nama fungsi** tersebut.
Untuk informasi selengkapnya, lihat [Mengelola notifikasi alarm](https://docs.aws.amazon.com/iotevents/latest/developerguide/lambda-support.html) di *Panduan AWS IoT Events Pengembang*.
1. (Opsional) Di **bagian Set state action - *opsional***, lakukan hal berikut:
1. **Di bawah **Tindakan status alarm**, tambahkan tindakan. dan pilih Simpan.**
Anda dapat menambahkan hingga 10 tindakan.
AWS IoT Events dapat melakukan tindakan saat alarm aktif. Anda dapat menentukan tindakan bawaan untuk menggunakan timer atau mengatur variabel, atau mengirim data ke AWS sumber daya lain. Untuk informasi selengkapnya, lihat [Tindakan yang didukung](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-supported-actions.html) di *Panduan AWS IoT Events Pengembang*.
1. Pilih **Buat**.
**catatan**
AWS IoT Events Konsol membuat beberapa permintaan API untuk menambahkan alarm ke model aset. Saat Anda memilih **Tambah alarm**, konsol akan membuka kotak dialog yang menunjukkan kemajuan permintaan API ini. Tetap di halaman ini sampai setiap permintaan API berhasil atau sampai permintaan API gagal. Jika permintaan gagal, tutup kotak dialog, perbaiki masalah, dan pilih **Tambahkan alarm** untuk mencoba lagi.
## Tentukan AWS IoT Events alarm (AWS CLI)
Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk menentukan AWS IoT Events alarm yang memantau properti aset. Anda dapat menentukan alarm pada model aset baru atau yang sudah ada. Setelah Anda menentukan alarm pada model aset, Anda membuat alarm AWS IoT Events dan menghubungkannya ke model aset. Dalam proses ini, Anda melakukan hal berikut:
**Topics**
+ [Langkah 1: Tentukan alarm pada model aset](#define-iot-events-alarm-definition-cli)
+ [Langkah 2: Tentukan model AWS IoT Events alarm](#define-iot-events-alarm-model-cli)
+ [Langkah 3: Aktifkan aliran data antara AWS IoT SiteWise dan AWS IoT Events](#define-iot-events-alarm-data-flow-cli)
### Langkah 1: Tentukan alarm pada model aset
Tambahkan definisi alarm dan properti terkait ke model aset baru atau yang sudah ada.
**Untuk menentukan alarm pada model aset (CLI)**
1. Buat file bernama `asset-model-payload.json`. Ikuti langkah-langkah di bagian lain ini untuk menambahkan detail model aset Anda ke file, tetapi jangan kirimkan permintaan untuk membuat atau memperbarui model aset. Di bagian ini, Anda menambahkan definisi alarm ke detail model aset dalam `asset-model-payload.json` file.
+ Untuk informasi selengkapnya tentang cara membuat model aset, lihat[Buat model aset (AWS CLI)](create-asset-models.md#create-asset-model-cli).
+ Untuk informasi selengkapnya tentang cara memperbarui model aset yang ada, lihat[Memperbarui model aset, model komponen, atau antarmuka (AWS CLI)](update-asset-models.md#update-asset-model-cli).
**catatan**
Model aset Anda harus menentukan setidaknya satu properti aset, termasuk properti aset untuk dipantau dengan alarm.
1. Tambahkan model komposit alarm (`assetModelCompositeModels`) ke model aset. Model komposit AWS IoT Events alarm menentukan `IOT_EVENTS` jenis dan menentukan properti sumber alarm. Anda menambahkan properti sumber alarm setelah Anda membuat model alarm di AWS IoT Events.
**penting**
Model komposit alarm harus memiliki nama yang sama dengan model AWS IoT Events alarm yang Anda buat nanti. Nama model alarm hanya dapat berisi karakter alfanumerik. Tentukan nama alfanumerik yang unik sehingga Anda dapat menggunakan nama yang sama untuk model alarm.
```
{
...
"assetModelCompositeModels": [
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "IOT_EVENTS"
}
}
},
{
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
}
]
}
]
}
```
1. Tambahkan atribut ambang alarm ke model aset. Tentukan nilai default yang akan digunakan untuk ambang batas ini. Anda dapat mengganti nilai default ini pada setiap aset berdasarkan model ini.
**catatan**
Atribut ambang alarm harus berupa `INTEGER` atau a`DOUBLE`.
```
{
...
"assetModelProperties": [
...
{
"name": "Temperature Max Threshold",
"dataType": "DOUBLE",
"type": {
"attribute": {
"defaultValue": "105.0"
}
}
}
]
}
```
1. (Opsional) Tambahkan atribut notifikasi alarm ke model aset. Atribut ini menentukan penerima IAM Identity Center dan input lain yang AWS IoT Events digunakan untuk mengirim notifikasi saat alarm berubah status. Anda dapat mengganti default ini pada setiap aset berdasarkan model ini.
**penting**
Anda dapat mengirim pemberitahuan alarm ke AWS IAM Identity Center pengguna. Untuk menggunakan fitur ini, Anda harus mengaktifkan IAM Identity Center. Anda hanya dapat mengaktifkan Pusat Identitas IAM di satu AWS Wilayah pada satu waktu. Ini berarti Anda dapat menentukan pemberitahuan alarm hanya di Wilayah tempat Anda mengaktifkan Pusat Identitas IAM. Untuk informasi selengkapnya, lihat [Memulai](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) di *Panduan AWS IAM Identity Center Pengguna*.
Lakukan hal-hal berikut:
1. Tambahkan atribut yang menentukan ID toko identitas Pusat Identitas IAM Anda. Anda dapat menggunakan operasi [ListInstances](https://docs.aws.amazon.com/singlesignon/latest/APIReference/API_ListInstances.html)API Pusat Identitas IAM untuk membuat daftar toko identitas Anda. Operasi ini hanya berfungsi di Wilayah tempat Anda mengaktifkan Pusat Identitas IAM.
```
aws sso-admin list-instances
```
Kemudian, tentukan ID penyimpanan identitas (misalnya,`d-123EXAMPLE`) sebagai nilai default untuk atribut.
```
{
...
"assetModelProperties": [
...
{
"name": "identityStoreId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "d-123EXAMPLE"
}
}
}
]
}
```
1. Tambahkan atribut yang menentukan ID pengguna Pusat Identitas IAM yang menerima pemberitahuan. Untuk menentukan penerima notifikasi default, tambahkan ID pengguna IAM Identity Center sebagai nilai default. Lakukan salah satu hal berikut untuk mendapatkan ID pengguna IAM Identity Center:
1. Anda dapat menggunakan IAM Identity Center [ListUsers](https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_ListUsers.html)API untuk mendapatkan ID pengguna yang nama penggunanya Anda kenal. Ganti *d-123EXAMPLE* dengan ID toko identitas Anda, dan ganti *Name* dengan nama pengguna pengguna.
```
aws identitystore list-users \
--identity-store-id d-123EXAMPLE \
--filters AttributePath=UserName,AttributeValue=Name
```
1. Gunakan [konsol Pusat Identitas IAM](https://console.aws.amazon.com/singlesignon) untuk menelusuri pengguna Anda dan menemukan ID pengguna.
Kemudian, tentukan ID pengguna (misalnya,`123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE`) sebagai nilai default untuk atribut, atau tentukan atribut tanpa nilai default.
```
{
...
"assetModelProperties": [
...
{
"name": "userId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
}
}
}
]
}
```
1. (Opsional) Tambahkan atribut yang menentukan ID pengirim default untuk pemberitahuan pesan SMS (teks). ID pengirim ditampilkan sebagai pengirim pesan pada pesan yang dikirim oleh Amazon Simple Notification Service (Amazon SNS). Untuk informasi selengkapnya, lihat [Meminta ID pengirim AWS Olah Pesan Pengguna Akhir SMS di](https://docs.aws.amazon.com/sms-voice/latest/userguide/sender-id-request.html) *Panduan AWS Olah Pesan Pengguna Akhir SMS Pengguna*.
```
{
...
"assetModelProperties": [
...
{
"name": "senderId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "MyFactory"
}
}
}
]
}
```
1. (Opsional) Tambahkan atribut yang menentukan alamat email default untuk digunakan sebagai alamat *from* dalam pemberitahuan email.
```
{
...
"assetModelProperties": [
...
{
"name": "fromAddress",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "my.factory@example.com"
}
}
}
]
}
```
1. (Opsional) Tambahkan atribut yang menentukan subjek default untuk digunakan dalam pemberitahuan email.
```
{
...
"assetModelProperties": [
...
{
"name": "emailSubject",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "[ALERT] High boiler temperature"
}
}
}
]
}
```
1. (Opsional) Tambahkan atribut yang menentukan pesan tambahan untuk disertakan dalam pemberitahuan. Secara default, pesan notifikasi menyertakan informasi tentang alarm. Anda juga dapat menyertakan pesan tambahan yang memberi pengguna lebih banyak informasi..
```
{
...
"assetModelProperties": [
...
{
"name": "additionalMessage",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Turn off the power before you check the alarm."
}
}
}
]
}
```
1. Buat model aset atau perbarui model aset yang ada. Lakukan salah satu tindakan berikut:
+ Untuk membuat model aset, jalankan perintah berikut.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
+ Untuk memperbarui model aset yang ada, jalankan perintah berikut. Ganti *asset-model-id* dengan ID model aset.
```
aws iotsitewise update-asset-model \
--asset-model-id asset-model-id \
--cli-input-json file://asset-model-payload.json
```
Setelah Anda menjalankan perintah, perhatikan `assetModelId` dalam respon.
#### Contoh: Model aset boiler
Model aset berikut mewakili boiler yang melaporkan data suhu. Model aset ini mendefinisikan alarm yang mendeteksi ketika boiler terlalu panas.
```
{
"assetModelName": "Boiler Model",
"assetModelDescription": "Represents a boiler.",
"assetModelProperties": [
{
"name": "Temperature",
"dataType": "DOUBLE",
"unit": "C",
"type": {
"measurement": {}
}
},
{
"name": "Temperature Max Threshold",
"dataType": "DOUBLE",
"type": {
"attribute": {
"defaultValue": "105.0"
}
}
},
{
"name": "identityStoreId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "d-123EXAMPLE"
}
}
},
{
"name": "userId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "123EXAMPLE-a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"
}
}
},
{
"name": "senderId",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "MyFactory"
}
}
},
{
"name": "fromAddress",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "my.factory@example.com"
}
}
},
{
"name": "emailSubject",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "[ALERT] High boiler temperature"
}
}
},
{
"name": "additionalMessage",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "Turn off the power before you check the alarm."
}
}
}
],
"assetModelHierarchies": [
],
"assetModelCompositeModels": [
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "IOT_EVENTS"
}
}
},
{
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
}
]
}
]
}
```
### Langkah 2: Tentukan model AWS IoT Events alarm
Buat model alarm di AWS IoT Events. Di AWS IoT Events, Anda menggunakan *ekspresi* untuk menentukan nilai dalam model alarm. Anda dapat menggunakan ekspresi untuk menentukan nilai dari AWS IoT SiteWise untuk mengevaluasi dan digunakan sebagai input ke alarm. Saat AWS IoT SiteWise mengirim nilai properti aset ke model alarm, AWS IoT Events mengevaluasi ekspresi untuk mendapatkan nilai properti atau ID aset. Anda dapat menggunakan ekspresi berikut dalam model alarm:
+ **Nilai properti aset**
Untuk mendapatkan nilai properti aset, gunakan ekspresi berikut. Ganti *assetModelId* dengan ID model aset dan ganti *propertyId* dengan ID properti.
```
$sitewise.assetModel.`assetModelId`.`propertyId`.propertyValue.value
```
+ **Aset IDs**
Untuk mendapatkan ID aset, gunakan ekspresi berikut. Ganti *assetModelId* dengan ID model aset dan ganti *propertyId* dengan ID properti.
```
$sitewise.assetModel.`assetModelId`.`propertyId`.assetId
```
**catatan**
Saat Anda membuat model alarm, Anda dapat menentukan literal alih-alih ekspresi yang mengevaluasi AWS IoT SiteWise nilai. Ini dapat mengurangi jumlah atribut yang Anda tentukan pada model aset Anda. Namun, jika Anda mendefinisikan nilai sebagai literal, Anda tidak dapat menyesuaikan nilai tersebut pada aset berdasarkan model aset. AWS IoT SiteWise Monitor Pengguna Anda juga tidak dapat menyesuaikan alarm, karena mereka dapat mengonfigurasi pengaturan alarm hanya pada aset.
**Untuk membuat model AWS IoT Events alarm (CLI)**
1. Saat Anda membuat model alarm AWS IoT Events, Anda harus menentukan ID dari setiap properti yang digunakan alarm, yang mencakup yang berikut ini:
+ Properti status alarm dalam model aset komposit
+ Properti yang dipantau alarm
+ Atribut ambang
+ (Opsional) Atribut ID penyimpanan identitas Pusat Identitas IAM
+ (Opsional) Atribut ID pengguna IAM Identity Center
+ (Opsional) Atribut ID pengirim SMS
+ (Opsional) Atribut email *dari* alamat
+ (Opsional) Atribut subjek email
+ (Opsional) Atribut pesan tambahan
Jalankan perintah berikut untuk mengambil IDs properti ini pada model aset. Ganti *asset-model-id* dengan ID model aset dari langkah sebelumnya.
```
aws iotsitewise describe-asset-model --asset-model-id asset-model-id
```
Operasi mengembalikan respons yang berisi detail model aset. Perhatikan ID setiap properti yang digunakan alarm. Anda menggunakan ini IDs ketika Anda membuat model AWS IoT Events alarm di langkah berikutnya.
1. Buat model alarm di AWS IoT Events. Lakukan hal-hal berikut:
1. Buat file bernama `alarm-model-payload.json`.
1. Salin objek JSON berikut ke dalam file.
1. Masukkan nama (`alarmModelName`), deskripsi (`alarmModelDescription`), dan tingkat keparahan (`severity`) untuk alarm Anda. Untuk tingkat keparahan, tentukan bilangan bulat yang mencerminkan tingkat keparahan perusahaan Anda.
**penting**
Model alarm harus memiliki nama yang sama dengan model komposit alarm yang Anda tentukan pada model aset Anda sebelumnya.
Nama model alarm hanya dapat berisi karakter alfanumerik.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3
}
```
1. Tambahkan aturan perbandingan (`alarmRule`) ke alarm. Aturan ini mendefinisikan properti untuk monitor (`inputProperty`), nilai ambang untuk membandingkan (`threshold`), dan operator perbandingan untuk menggunakan (`comparisonOperator`).
+ Ganti *assetModelId* dengan ID model aset.
+ Ganti *alarmPropertyId* dengan ID properti yang dipantau alarm.
+ Ganti *thresholdAttributeId* dengan ID properti atribut threshold.
+ Ganti *GREATER* dengan operator yang akan digunakan untuk membandingkan nilai properti dengan ambang batas. Pilih dari salah satu pilihan berikut:
+ `LESS`
+ `LESS_OR_EQUAL`
+ `EQUAL`
+ `NOT_EQUAL`
+ `GREATER_OR_EQUAL`
+ `GREATER`
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
}
}
```
1. Tambahkan action (`alarmEventActions`) untuk mengirim status alarm ke AWS IoT SiteWise saat alarm berubah status.
**catatan**
Untuk konfigurasi lanjutan, Anda dapat menentukan tindakan tambahan yang harus dilakukan saat alarm berubah status. Misalnya, Anda mungkin memanggil AWS Lambda fungsi atau memublikasikan ke topik MQTT. Untuk informasi selengkapnya, lihat [Bekerja dengan AWS layanan lain](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-other-aws-services.html) di *Panduan AWS IoT Events Pengembang*.
+ Ganti *assetModelId* dengan ID model aset.
+ Ganti *alarmPropertyId* dengan ID properti yang dipantau alarm.
+ Ganti *alarmStatePropertyId* dengan ID properti status alarm dalam model komposit alarm.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
}
}
```
1. (Opsional) Konfigurasikan pengaturan pemberitahuan alarm. Tindakan pemberitahuan alarm menggunakan fungsi Lambda di akun Anda untuk mengirim pemberitahuan alarm. Untuk informasi selengkapnya, lihat [Persyaratan untuk pemberitahuan alarm di AWS IoT SiteWise](iot-events-alarm-notification-requirements.md). Dalam pengaturan pemberitahuan alarm, Anda dapat mengonfigurasi notifikasi SMS dan email untuk dikirim ke pengguna IAM Identity Center. Lakukan hal-hal berikut:
1. Tambahkan konfigurasi notifikasi alarm (`alarmNotification`) ke payload di`alarm-model-payload.json`.
+ Ganti *alarmNotificationFunctionArn* dengan ARN dari fungsi Lambda yang menangani notifikasi alarm.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
}
}
]
}
}
```
1. (Opsional) Konfigurasikan notifikasi SMS (`smsConfigurations`) untuk dikirim ke pengguna Pusat Identitas IAM saat alarm berubah status.
+ Ganti *identityStoreIdAttributeId* dengan ID atribut yang berisi ID penyimpanan identitas Pusat Identitas IAM.
+ Ganti *userIdAttributeId* dengan ID atribut yang berisi ID pengguna IAM Identity Center.
+ Ganti *senderIdAttributeId* dengan ID atribut yang berisi ID pengirim Amazon SNS, atau hapus `senderId` dari payload.
+ Ganti *additionalMessageAttributeId* dengan ID atribut yang berisi pesan tambahan, atau hapus `additionalMessage` dari payload.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
},
"smsConfigurations": [
{
"recipients": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
],
"senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
]
}
]
}
}
```
1. (Opsional) Konfigurasikan notifikasi email (`emailConfigurations`) untuk dikirim ke pengguna Pusat Identitas IAM saat alarm berubah status.
+ Ganti *identityStoreIdAttributeId* dengan ID properti atribut ID penyimpanan identitas Pusat Identitas IAM.
+ Ganti *userIdAttributeId* dengan ID properti atribut ID pengguna Pusat Identitas IAM.
+ Ganti *fromAddressAttributeId* dengan ID properti atribut alamat “dari”, atau hapus `from` dari muatan.
+ Ganti *emailSubjectAttributeId* dengan ID properti atribut subjek email, atau hapus `subject` dari payload.
+ Ganti *additionalMessageAttributeId* dengan ID properti atribut pesan tambahan, atau hapus `additionalMessage` dari payload.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
},
"smsConfigurations": [
{
"recipients": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
],
"senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
],
"emailConfigurations": [
{
"from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
"recipients": {
"to": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
]
},
"content": {
"subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
}
]
}
]
}
}
```
1. (Opsional) Tambahkan kemampuan alarm (`alarmCapabilities`) ke payload di`alarm-model-payload.json`. Dalam objek ini, Anda dapat menentukan apakah alur pengakuan diaktifkan dan status aktifkan default untuk aset berdasarkan model aset. Untuk informasi lebih lanjut tentang aliran pengakuan, lihat[Status alarm](industrial-alarms.md#alarm-states).
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
},
"smsConfigurations": [
{
"recipients": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
],
"senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
],
"emailConfigurations": [
{
"from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
"recipients": {
"to": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
]
},
"content": {
"subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
}
]
}
]
},
"alarmCapabilities": {
"initializationConfiguration": {
"disabledOnInitialization": false
},
"acknowledgeFlow": {
"enabled": true
}
}
}
```
1. Tambahkan peran layanan IAM (`roleArn`) yang AWS IoT Events dapat mengasumsikan untuk mengirim data ke AWS IoT SiteWise. Peran ini membutuhkan `iotsitewise:BatchPutAssetPropertyValue` izin dan hubungan kepercayaan yang memungkinkan `iotevents.amazonaws.com` untuk mengambil peran. Untuk mengirim notifikasi, peran ini juga memerlukan `sso-directory:DescribeUser` izin `lambda:InvokeFunction` dan. Untuk informasi selengkapnya, lihat [Peran layanan alarm](https://docs.aws.amazon.com/iotevents/latest/developerguide/security-iam.html) di *Panduan AWS IoT Events Pengembang*.
+ Ganti `roleArn` dengan ARN dari peran yang AWS IoT Events dapat diasumsikan untuk melakukan tindakan ini.
```
{
"alarmModelName": "BoilerTemperatureHighAlarm",
"alarmModelDescription": "Detects when the boiler temperature is high.",
"severity": 3,
"alarmRule": {
"simpleRule": {
"inputProperty": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.propertyValue.value",
"comparisonOperator": "GREATER",
"threshold": "$sitewise.assetModel.`assetModelId`.`thresholdAttributeId`.propertyValue.value"
}
},
"alarmEventActions": {
"alarmActions": [
{
"iotSiteWise": {
"assetId": "$sitewise.assetModel.`assetModelId`.`alarmPropertyId`.assetId",
"propertyId": "'alarmStatePropertyId'"
}
}
]
},
"alarmNotification": {
"notificationActions": [
{
"action": {
"lambdaAction": {
"functionArn": "alarmNotificationFunctionArn"
}
},
"smsConfigurations": [
{
"recipients": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
],
"senderId": "$sitewise.assetModel.`assetModelId`.`senderIdAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
],
"emailConfigurations": [
{
"from": "$sitewise.assetModel.`assetModelId`.`fromAddressAttributeId`.propertyValue.value",
"recipients": {
"to": [
{
"ssoIdentity": {
"identityStoreId": "$sitewise.assetModel.`assetModelId`.`identityStoreIdAttributeId`.propertyValue.value",
"userId": "$sitewise.assetModel.`assetModelId`.`userIdAttributeId`.propertyValue.value"
}
}
]
},
"content": {
"subject": "$sitewise.assetModel.`assetModelId`.`emailSubjectAttributeId`.propertyValue.value",
"additionalMessage": "$sitewise.assetModel.`assetModelId`.`additionalMessageAttributeId`.propertyValue.value"
}
}
]
}
]
},
"alarmCapabilities": {
"initializationConfiguration": {
"disabledOnInitialization": false
},
"acknowledgeFlow": {
"enabled": false
}
},
"roleArn": "arn:aws:iam::123456789012:role/MyIoTEventsAlarmRole"
}
```
1. Jalankan perintah berikut untuk membuat model AWS IoT Events alarm dari payload di`alarm-model-payload.json`.
```
aws iotevents create-alarm-model --cli-input-json file://alarm-model-payload.json
```
1. Operasi mengembalikan respons yang mencakup ARN dari model alarm,. `alarmModelArn` Salin ARN ini untuk mengatur definisi alarm pada model aset Anda di langkah berikutnya.
### Langkah 3: Aktifkan aliran data antara AWS IoT SiteWise dan AWS IoT Events
Setelah Anda membuat sumber daya yang diperlukan di AWS IoT SiteWise dan AWS IoT Events, Anda dapat mengaktifkan aliran data antara sumber daya untuk mengaktifkan alarm Anda. Di bagian ini, Anda memperbarui definisi alarm dalam model aset untuk menggunakan model alarm yang Anda buat pada langkah sebelumnya.
**Untuk mengaktifkan aliran data antara AWS IoT SiteWise dan AWS IoT Events (CLI)**
+ Atur model alarm sebagai sumber alarm dalam model aset. Lakukan hal-hal berikut:
1. Jalankan perintah berikut untuk mengambil definisi model aset yang ada. Ganti *asset-model-id* dengan ID model aset.
```
aws iotsitewise describe-asset-model --asset-model-id asset-model-id
```
Operasi mengembalikan respons yang berisi detail model aset.
1. Buat file bernama `update-asset-model-payload.json` dan salin respons perintah sebelumnya ke dalam file.
1. Hapus pasangan kunci-nilai berikut dari file: `update-asset-model-payload.json`
+ `assetModelId`
+ `assetModelArn`
+ `assetModelCreationDate`
+ `assetModelLastUpdateDate`
+ `assetModelStatus`
1. Tambahkan properti sumber alarm (`AWS/ALARM_SOURCE`) ke model komposit alarm yang Anda tentukan sebelumnya. Ganti *alarmModelArn* dengan ARN model alarm, yang menetapkan nilai properti sumber alarm.
```
{
...
"assetModelCompositeModels": [
...
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"id": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "IOT_EVENTS"
}
}
},
{
"id": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
},
{
"name": "AWS/ALARM_SOURCE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "alarmModelArn"
}
}
}
]
}
]
}
```
1. Jalankan perintah berikut untuk memperbarui model aset dengan definisi yang disimpan dalam `update-asset-model-payload.json` file. Ganti *asset-model-id* dengan ID model aset.
```
aws iotsitewise update-asset-model \
--asset-model-id asset-model-id \
--cli-input-json file://update-asset-model-payload.json
```
Model aset Anda sekarang mendefinisikan alarm yang mendeteksi. AWS IoT Events Alarm memantau properti target di semua aset berdasarkan model aset ini. Anda dapat mengonfigurasi alarm pada setiap aset untuk menyesuaikan properti seperti ambang batas atau penerima Pusat Identitas IAM untuk setiap aset. Untuk informasi selengkapnya, lihat [Konfigurasikan alarm pada aset di AWS IoT SiteWise](configure-alarms.md).
# Tentukan alarm eksternal di AWS IoT SiteWise
Alarm eksternal berisi status alarm yang Anda deteksi di luar. AWS IoT SiteWise
## Tentukan alarm eksternal (konsol)
Anda dapat menggunakan AWS IoT SiteWise konsol untuk menentukan alarm eksternal pada model aset yang ada. Untuk menentukan alarm eksternal pada model aset baru, buat model aset, lalu selesaikan langkah-langkah ini. Untuk informasi selengkapnya, lihat [Buat model aset di AWS IoT SiteWise](create-asset-models.md).
**Untuk menentukan alarm pada model aset**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Model**.
1. Pilih model aset untuk menentukan alarm.
1. Pilih tab **Definisi alarm**.
1. Pilih **Tambahkan alarm**.
1. Di **Opsi jenis alarm**, pilih **Alarm eksternal**.
1. Masukkan nama untuk alarm Anda.
1. (Opsional) Masukkan deskripsi untuk alarm Anda.
1. Pilih **Tambahkan alarm**.
## Tentukan alarm eksternal (CLI)
Anda dapat menggunakan AWS CLI untuk menentukan alarm eksternal pada model aset baru atau yang sudah ada.
Untuk menambahkan alarm eksternal ke model aset, Anda menambahkan model komposit alarm ke model aset. Model komposit alarm eksternal menentukan `EXTERNAL` jenis dan tidak menentukan properti sumber alarm. Contoh berikut alarm komposit mendefinisikan alarm suhu eksternal.
```
{
...
"assetModelCompositeModels": [
{
"name": "BoilerTemperatureHighAlarm",
"type": "AWS/ALARM",
"properties": [
{
"name": "AWS/ALARM_TYPE",
"dataType": "STRING",
"type": {
"attribute": {
"defaultValue": "EXTERNAL"
}
}
},
{
"name": "AWS/ALARM_STATE",
"dataType": "STRUCT",
"dataTypeSpec": "AWS/ALARM_STATE",
"type": {
"measurement": {}
}
}
]
}
]
}
```
Untuk informasi selengkapnya tentang cara menambahkan model komposit ke model aset baru atau yang sudah ada, lihat berikut ini:
+ [Buat model aset (AWS CLI)](create-asset-models.md#create-asset-model-cli)
+ [Memperbarui model aset, model komponen, atau antarmuka (AWS CLI)](update-asset-models.md#update-asset-model-cli)
Setelah Anda menentukan alarm eksternal, Anda dapat menelan status alarm ke aset berdasarkan model aset. Untuk informasi selengkapnya, lihat [Menelan status alarm eksternal di AWS IoT SiteWise](ingest-external-alarm-state.md).
# Konfigurasikan alarm pada aset di AWS IoT SiteWise
Setelah menentukan AWS IoT Events alarm pada model aset, Anda dapat mengonfigurasi alarm pada setiap aset berdasarkan model aset. Anda dapat mengedit nilai ambang batas dan pengaturan notifikasi untuk alarm. Masing-masing nilai ini adalah atribut pada aset, sehingga Anda dapat memperbarui nilai default atribut untuk mengonfigurasi nilai-nilai ini.
**catatan**
Anda dapat mengonfigurasi nilai-nilai ini untuk AWS IoT Events alarm, tetapi tidak pada alarm eksternal.
**Topics**
+ [Konfigurasikan nilai ambang batas (konsol)](#configure-alarm-threshold-value-console)
+ [Konfigurasikan nilai ambang (AWS CLI)](#configure-alarm-threshold-value-cli)
+ [Konfigurasikan pengaturan notifikasi di AWS IoT SiteWise](configure-alarm-notification-settings.md)
## Konfigurasikan nilai ambang batas (konsol)
Anda dapat menggunakan AWS IoT SiteWise konsol untuk memperbarui nilai atribut yang menentukan nilai ambang alarm.
**Untuk memperbarui nilai ambang alarm (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset yang ingin Anda perbarui nilai ambang alarm.
**Tip**
Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.
1. Pilih **Edit**.
1. Temukan atribut yang digunakan alarm untuk nilai ambangnya, lalu masukkan nilai barunya.
1. Pilih **Simpan**.
## Konfigurasikan nilai ambang (AWS CLI)
Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk memperbarui nilai atribut yang menentukan nilai ambang alarm.
Anda harus mengetahui aset `assetId` dan properti Anda `propertyId` untuk menyelesaikan prosedur ini. Anda juga dapat menggunakan ID eksternal. Jika Anda membuat aset dan tidak mengetahuinya`assetId`, gunakan [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API untuk mencantumkan semua aset untuk model tertentu. Gunakan [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operasi untuk melihat properti aset Anda termasuk properti IDs.
Gunakan [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)operasi untuk menetapkan nilai atribut ke aset Anda. Anda dapat menggunakan operasi ini untuk mengatur beberapa atribut sekaligus. Payload operasi ini berisi daftar entri, dan setiap entri berisi ID aset, ID properti, dan nilai atribut.
**Untuk memperbarui nilai atribut (AWS CLI)**
1. Buat file bernama `batch-put-payload.json` dan salin objek JSON berikut ke dalam file. Contoh payload ini menunjukkan cara mengatur lintang dan bujur turbin angin. Perbarui IDs, nilai, dan stempel waktu untuk memodifikasi payload untuk kasus penggunaan Anda.
```
{
"entries": [
{
"entryId": "windfarm3-turbine7-latitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 47.6204
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
},
{
"entryId": "windfarm3-turbine7-longitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 122.3491
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
+ Setiap entri dalam payload berisi `entryId` yang dapat Anda definisikan sebagai string unik apa pun. Jika ada entri permintaan yang gagal, setiap kesalahan akan berisi permintaan `entryId` yang sesuai sehingga Anda tahu permintaan mana yang harus dicoba lagi.
+ Untuk menetapkan nilai atribut, Anda dapat menyertakan satu timestamp-quality-value (TQV) struktur dalam daftar `propertyValues` untuk setiap properti atribut. Struktur ini harus berisi yang baru `value` dan saat ini`timestamp`.
+ `value`— Struktur yang berisi salah satu bidang berikut, tergantung pada jenis properti yang ditetapkan:
+ `booleanValue`
+ `doubleValue`
+ `integerValue`
+ `stringValue`
+ `nullValue`
+ `timestamp`— Struktur yang berisi waktu epoch Unix saat ini dalam hitungan detik,. `timeInSeconds` AWS IoT SiteWise menolak setiap titik data dengan stempel waktu yang ada lebih dari 7 hari di masa lalu atau lebih baru dari 5 menit di masa depan.
Untuk informasi lebih lanjut tentang cara menyiapkan muatan [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html), lihat[Menelan data dengan AWS IoT SiteWise APIs](ingest-api.md).
1. Jalankan perintah berikut untuk mengirim nilai atribut ke AWS IoT SiteWise:
```
aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
```
# Konfigurasikan pengaturan notifikasi di AWS IoT SiteWise
Anda dapat mengonfigurasi pengaturan notifikasi alarm menggunakan AWS IoT SiteWise konsol atau AWS Command Line Interface (AWS CLI).
## Konfigurasikan pengaturan notifikasi (konsol)
Anda dapat menggunakan AWS IoT SiteWise konsol untuk memperbarui nilai atribut yang menentukan pengaturan notifikasi untuk alarm.
**Untuk memperbarui pengaturan notifikasi alarm (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset yang ingin Anda perbarui pengaturan alarmnya.
1. Pilih **Edit**.
1. Temukan atribut yang digunakan alarm untuk pengaturan notifikasi yang ingin Anda ubah, lalu masukkan nilai barunya.
1. Pilih **Simpan**.
## Konfigurasikan pengaturan notifikasi (CLI)
Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk memperbarui nilai atribut yang menentukan pengaturan notifikasi untuk alarm.
Anda harus mengetahui aset `assetId` dan properti Anda `propertyId` untuk menyelesaikan prosedur ini. Anda juga dapat menggunakan ID eksternal. Jika Anda membuat aset dan tidak mengetahuinya`assetId`, gunakan [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API untuk mencantumkan semua aset untuk model tertentu. Gunakan [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operasi untuk melihat properti aset Anda termasuk properti IDs.
Gunakan [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)operasi untuk menetapkan nilai atribut ke aset Anda. Anda dapat menggunakan operasi ini untuk mengatur beberapa atribut sekaligus. Payload operasi ini berisi daftar entri, dan setiap entri berisi ID aset, ID properti, dan nilai atribut.
**Untuk memperbarui nilai atribut (AWS CLI)**
1. Buat file bernama `batch-put-payload.json` dan salin objek JSON berikut ke dalam file. Contoh payload ini menunjukkan cara mengatur lintang dan bujur turbin angin. Perbarui IDs, nilai, dan stempel waktu untuk memodifikasi payload untuk kasus penggunaan Anda.
```
{
"entries": [
{
"entryId": "windfarm3-turbine7-latitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 47.6204
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
},
{
"entryId": "windfarm3-turbine7-longitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 122.3491
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
+ Setiap entri dalam payload berisi `entryId` yang dapat Anda definisikan sebagai string unik apa pun. Jika ada entri permintaan yang gagal, setiap kesalahan akan berisi permintaan `entryId` yang sesuai sehingga Anda tahu permintaan mana yang harus dicoba lagi.
+ Untuk menetapkan nilai atribut, Anda dapat menyertakan satu timestamp-quality-value (TQV) struktur dalam daftar `propertyValues` untuk setiap properti atribut. Struktur ini harus berisi yang baru `value` dan saat ini`timestamp`.
+ `value`— Struktur yang berisi salah satu bidang berikut, tergantung pada jenis properti yang ditetapkan:
+ `booleanValue`
+ `doubleValue`
+ `integerValue`
+ `stringValue`
+ `nullValue`
+ `timestamp`— Struktur yang berisi waktu epoch Unix saat ini dalam hitungan detik,. `timeInSeconds` AWS IoT SiteWise menolak setiap titik data dengan stempel waktu yang ada lebih dari 7 hari di masa lalu atau lebih baru dari 5 menit di masa depan.
Untuk informasi lebih lanjut tentang cara menyiapkan muatan [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html), lihat[Menelan data dengan AWS IoT SiteWise APIs](ingest-api.md).
1. Jalankan perintah berikut untuk mengirim nilai atribut ke AWS IoT SiteWise:
```
aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
```
# Menanggapi alarm di AWS IoT SiteWise
Ketika AWS IoT Events alarm berubah status, Anda dapat melakukan hal berikut untuk menanggapi alarm:
+ Akui alarm untuk menunjukkan bahwa Anda menangani masalah tersebut.
+ Tunda alarm untuk menonaktifkannya sementara.
+ Nonaktifkan alarm untuk menonaktifkannya secara permanen sampai Anda mengaktifkannya lagi.
+ Aktifkan alarm yang dinonaktifkan untuk mendeteksi status alarm.
+ Setel ulang alarm untuk menghapus status dan nilai terbarunya.
Anda dapat menggunakan AWS IoT SiteWise konsol atau AWS IoT Events API untuk merespons alarm.
**catatan**
Anda dapat merespons AWS IoT Events alarm, tetapi bukan alarm eksternal.
**Topics**
+ [Menanggapi alarm (konsol)](#respond-to-alarm-console)
+ [Menanggapi alarm (API)](#respond-to-alarm-cli)
## Menanggapi alarm (konsol)
Anda dapat menggunakan AWS IoT SiteWise konsol untuk mengakui, menunda, menonaktifkan, atau mengaktifkan alarm.
**Topics**
+ [Akui alarm (konsol)](#acknowledge-alarm-console)
+ [Tunda alarm (konsol)](#snooze-alarm-console)
+ [Nonaktifkan alarm (konsol)](#disable-alarm-console)
+ [Aktifkan alarm (konsol)](#enable-alarm-console)
+ [Setel ulang alarm (konsol)](#reset-alarm-console)
### Akui alarm (konsol)
Anda dapat menerima alarm untuk menunjukkan bahwa Anda menangani masalah tersebut.
**catatan**
Anda harus mengaktifkan aliran pengakuan pada alarm sehingga Anda dapat mengenali alarm. Opsi ini diaktifkan secara default jika Anda menentukan alarm dari AWS IoT SiteWise konsol.
**Untuk mengakui alarm (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset yang ingin Anda akui alarmnya.
**Tip**
Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.
1. Pilih tab **Alarm**.
1. Pilih alarm untuk mengakui, lalu pilih **Tindakan** untuk membuka menu tindakan respons.
1. Pilih **Akui**. Status alarm berubah menjadi **Diakui**.
### Tunda alarm (konsol)
Anda dapat menunda alarm untuk menonaktifkannya sementara. Tentukan durasi untuk menunda alarm.
**Untuk menunda alarm (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset yang ingin Anda tunda alarm.
**Tip**
Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.
1. Pilih tab **Alarm**.
1. Pilih alarm untuk ditunda, lalu pilih **Tindakan untuk membuka menu tindakan** respons.
1. Pilih **Tunda**. Model terbuka di mana Anda menentukan durasi untuk ditunda.
1. Pilih panjang **Tunda atau masukkan panjang Tunda** **khusus**.
1. Pilih **Simpan**. Status alarm berubah menjadi **Snoozed**.
### Nonaktifkan alarm (konsol)
Anda dapat menonaktifkan alarm sehingga tidak mendeteksi lagi. Setelah Anda menonaktifkan alarm, Anda harus mengaktifkannya lagi jika Anda ingin alarm mendeteksi.
**Untuk menonaktifkan alarm (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset yang ingin Anda nonaktifkan alarmnya.
**Tip**
Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.
1. Pilih tab **Alarm**.
1. Pilih alarm yang akan dinonaktifkan, lalu pilih **Tindakan** untuk membuka menu tindakan respons.
1. Pilih **Disable** (Nonaktifkan). Status alarm berubah menjadi **Dinonaktifkan**.
### Aktifkan alarm (konsol)
Anda dapat mengaktifkan alarm untuk mendeteksi lagi setelah Anda menonaktifkan atau menundanya.
**Untuk mengaktifkan alarm (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset yang ingin Anda aktifkan alarmnya.
**Tip**
Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.
1. Pilih tab **Alarm**.
1. Pilih alarm yang akan diaktifkan, lalu pilih **Tindakan** untuk membuka menu tindakan respons.
1. Pilih **Aktifkan**. Status alarm berubah menjadi **Normal**.
### Setel ulang alarm (konsol)
Anda dapat mengatur ulang alarm untuk menghapus status dan nilai terbarunya.
**Untuk mengatur ulang alarm (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset yang ingin Anda atur ulang alarm.
**Tip**
Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.
1. Pilih tab **Alarm**.
1. Pilih alarm yang akan diaktifkan, lalu pilih **Tindakan** untuk membuka menu tindakan respons.
1. Pilih **Reset**. Status alarm berubah menjadi **Normal**.
## Menanggapi alarm (API)
Anda dapat menggunakan AWS IoT Events API untuk mengakui, menunda, menonaktifkan, mengaktifkan, atau mengatur ulang alarm. Untuk informasi selengkapnya, lihat operasi berikut di *Referensi AWS IoT Events API*:
+ [BatchAcknowledgeAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchAcknowledgeAlarm.html)
+ [BatchSnoozeAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchSnoozeAlarm.html)
+ [BatchDisableAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchDisableAlarm.html)
+ [BatchEnableAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchEnableAlarm.html)
+ [BatchResetAlarm](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchResetAlarm.html)
Untuk informasi selengkapnya, lihat [Menanggapi alarm](https://docs.aws.amazon.com/iotevents/latest/developerguide/respond-to-alarms.html) di Panduan *AWS IoT Events Pengembang*.
# Menelan status alarm eksternal di AWS IoT SiteWise
Alarm eksternal adalah alarm yang Anda evaluasi di luar. AWS IoT SiteWise Anda dapat menggunakan alarm eksternal ketika Anda memiliki sumber data yang melaporkan status alarm yang ingin Anda konsumsi. AWS IoT SiteWise
Properti status alarm memerlukan format khusus untuk nilai data status alarm. Setiap nilai data harus berupa objek JSON yang diserialisasikan ke string. Kemudian, Anda menelan string serial sebagai nilai string. Untuk informasi selengkapnya, lihat [Properti status alarm](industrial-alarms.md#alarm-state-properties).
**Example Contoh nilai data status alarm (tidak diserialisasi)**
```
{
"stateName": "Active"
}
```
**Example Contoh nilai data status alarm (serial)**
```
{\"stateName\":\"Active\"}
```
**catatan**
Jika sumber data tidak dapat melaporkan data dalam format ini, atau Anda tidak dapat mengonversi data ke format ini sebelum menelannya, Anda mungkin memilih untuk tidak menggunakan properti alarm. Sebagai gantinya, Anda dapat menelan data sebagai properti pengukuran dengan tipe data string, misalnya. Untuk informasi selengkapnya, lihat [Tentukan aliran data dari peralatan (pengukuran)](measurements.md) dan [Menelan data ke AWS IoT SiteWise](industrial-data-ingestion.md).
# Petakan aliran status alarm eksternal di AWS IoT SiteWise
Anda dapat menentukan alias properti untuk memetakan aliran data Anda ke properti status alarm Anda. Ini membantu Anda dengan mudah mengidentifikasi properti status alarm saat Anda menelan atau mengambil data. Untuk informasi selengkapnya tentang alias properti, lihat[Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).
**Topics**
+ [Peta aliran status alarm eksternal (konsol)](#connect-alarm-data-stream-console)
+ [Peta aliran status alarm eksternal ()AWS CLI](#connect-alarm-data-stream-cli)
## Peta aliran status alarm eksternal (konsol)
Anda dapat menentukan alias properti untuk memetakan aliran data Anda ke properti status alarm Anda. Ini membantu Anda dengan mudah mengidentifikasi properti status alarm saat Anda menelan atau mengambil data. Untuk informasi selengkapnya tentang alias properti, lihat[Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).
Anda dapat menggunakan AWS IoT SiteWise konsol untuk menyetel alias untuk properti status alarm.
**Untuk menyetel alias properti untuk properti status alarm (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Aset**.
1. Pilih aset yang ingin Anda tetapkan alias properti.
**Tip**
Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.
1. Pilih **Edit**.
1. Gulir ke **Alarm** dan perluas bagian.
1. *Di bawah **Alarm Eksternal**, masukkan alias di alias **Properti - opsional**.*
1. Pilih **Simpan**.
## Peta aliran status alarm eksternal ()AWS CLI
Anda dapat menentukan alias properti untuk memetakan aliran data Anda ke properti status alarm Anda. Ini membantu Anda dengan mudah mengidentifikasi properti status alarm saat Anda menelan atau mengambil data. Untuk informasi selengkapnya tentang alias properti, lihat[Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).
Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk menyetel alias untuk properti status alarm.
Anda harus mengetahui aset `assetId` dan properti Anda `propertyId` untuk menyelesaikan prosedur ini. Anda juga dapat menggunakan ID eksternal. Jika Anda membuat aset dan tidak mengetahuinya`assetId`, gunakan [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API untuk mencantumkan semua aset untuk model tertentu. Gunakan [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)operasi untuk melihat properti aset Anda termasuk properti IDs.
**catatan**
[DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)Tanggapan tersebut mencakup daftar model aset komposit untuk aset tersebut. Setiap alarm adalah model komposit. Untuk menemukan`propertyId`, temukan model komposit untuk alarm, dan kemudian temukan `AWS/ALARM_STATE` properti dalam model komposit itu.
Untuk informasi selengkapnya tentang cara menyetel alias properti, lihat[Memperbarui alias properti aset](update-data-streams-method.md).
# Menelan data status alarm di AWS IoT SiteWise
Properti status alarm mengharapkan status alarm sebagai string JSON serial. Untuk menyerap status alarm ke alarm eksternal AWS IoT SiteWise, Anda menelan string serial ini sebagai nilai string stempel waktu. Contoh berikut menunjukkan nilai data status untuk alarm aktif.
```
{\"stateName\":\"Active\"}
```
Untuk mengidentifikasi properti status alarm, Anda dapat menentukan salah satu dari berikut ini:
+ Alarm `assetId` dan `propertyId` properti alarm yang Anda kirimi datanya.
+ The`propertyAlias`, yang merupakan alias aliran data (misalnya,`/company/windfarm/3/turbine/7/temperature/high`). Untuk menggunakan opsi ini, Anda harus terlebih dahulu mengatur alias properti alarm Anda. Untuk mempelajari cara menyetel alias properti untuk properti status alarm, lihat[Petakan aliran status alarm eksternal di AWS IoT SiteWise](connect-alarm-data-streams.md).
Contoh payload [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)API berikut menunjukkan cara memformat status alarm eksternal. Alarm eksternal ini melaporkan ketika pembacaan rotasi turbin angin per menit (RPM) terlalu tinggi.
**Example Contoh BatchPutAssetPropertyValue payload untuk data status alarm**
```
{
"entries": [
{
"entryId": "unique entry ID",
"propertyAlias": "/company/windfarm/3/turbine/7/temperature/high",
"propertyValues": [
{
"value": {
"stringValue": "{\"stateName\":\"Active\"}"
},
"timestamp": {
"timeInSeconds": 1607550262
}
}
]
}
]
}
```
Untuk informasi selengkapnya tentang cara menggunakan `BatchPutAssetPropertyValue` API untuk menyerap data, lihat[Menelan data dengan AWS IoT SiteWise APIs](ingest-api.md).
Untuk informasi selengkapnya tentang cara lain untuk menelan data, lihat[Menelan data ke AWS IoT SiteWise](industrial-data-ingestion.md).