Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Hubungkan AWS IoT SiteWise Alarm ke dasbor AWS IoT TwinMaker Grafana
**catatan**
Fitur ini dalam **pratinjau publik** dan dapat berubah sewaktu-waktu.
AWS IoT TwinMaker mampu mengimpor AWS IoT SiteWise dan alarm Acara ke dalam AWS IoT TwinMaker komponen. Ini memungkinkan Anda untuk dapat menanyakan status alarm dan mengonfigurasi ambang alarm tanpa menerapkan konektor data khusus untuk migrasi AWS IoT SiteWise data. Anda dapat menggunakan plugin AWS IoT TwinMaker Grafana untuk memvisualisasikan status alarm dan mengonfigurasi ambang alarm di Grafana, tanpa melakukan panggilan API ke AWS IoT TwinMaker atau berinteraksi langsung dengan alarm. AWS IoT SiteWise
**catatan**
Pemberitahuan akhir dukungan: Pada 20 Mei 2026, AWS akan mengakhiri dukungan untuk AWS IoT Events. Setelah 20 Mei 2026, Anda tidak akan lagi dapat mengakses AWS IoT Events konsol atau AWS IoT Events sumber daya. 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 SiteWise prasyarat konfigurasi alarm
Sebelum membuat alarm dan mengintegrasikannya ke dasbor Grafana Anda, pastikan Anda telah meninjau prasyarat berikut:
+ Menjadi akrab dengan AWS IoT SiteWise model dan sistem aset. Untuk informasi selengkapnya, lihat [Membuat model aset](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-asset-models.html) dan [Membuat aset](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-assets.html) di *Panduan AWS IoT SiteWise Pengguna*.
+ Kenali model alarm IoT Events dan cara memasangnya ke AWS IoT SiteWise model. Untuk informasi selengkapnya, lihat [Mendefinisikan alarm AWS IoT Acara](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/define-iot-events-alarms.html) di *AWS IoT SiteWise Panduan Pengguna*.
+ Integrasikan AWS IoT TwinMaker dengan Grafana sehingga Anda dapat mengakses AWS IoT TwinMaker sumber daya Anda di Grafana. Untuk informasi selengkapnya, lihat [AWS IoT TwinMaker Integrasi dasbor Grafana](grafana-integration.md).
## Tentukan AWS IoT SiteWise peran IAM komponen alarm
AWS IoT TwinMaker menggunakan peran IAM ruang kerja untuk menanyakan dan mengonfigurasi ambang alarm di Grafana. Izin berikut diperlukan dalam peran AWS IoT TwinMaker ruang kerja, untuk berinteraksi dengan AWS IoT SiteWise alarm di Grafana:
```
{
"Effect": "Allow",
"Action": [
"iotevents:DescribeAlarmModel",
],
"Resource": ["{IoTEventsAlarmModelArn}"]
},{
"Effect": "Allow",
"Action": [
"iotsitewise:BatchPutAssetPropertyValue"
],
"Resource": ["{IoTSitewiseAssetArn}"]
}
```
Di [AWS IoT TwinMaker konsol](https://console.aws.amazon.com/iottwinmaker/), buat entitas yang mewakili AWS IoT SiteWise aset Anda. Pastikan Anda menambahkan komponen untuk entitas yang menggunakan `com.amazon.iotsitewise.alarm` sebagai tipe komponen, dan pilih model aset dan alarm yang sesuai.
![\[Layar Add component menampilkan komponen tipe com.amazon.iotsitewise.alarm.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/image(5).png)
Screenshot di atas adalah contoh membuat entitas ini dengan tipe`com.amazon.iotsitewise.alarm`.
Saat Anda membuat komponen ini, AWS IoT TwinMaker secara otomatis mengimpor properti alarm terkait dari AWS IoT SiteWise dan AWS IoT Events. Anda dapat mengulangi pola jenis komponen alarm ini untuk membuat komponen alarm untuk semua aset yang dibutuhkan di ruang kerja Anda.
## Kueri dan perbarui melalui AWS IoT TwinMaker API
Setelah membuat komponen alarm, Anda dapat menanyakan status alarm, ambang batas, dan memperbarui ambang alarm melalui API. AWS IoT TwinMaker
Di bawah ini adalah contoh permintaan untuk menanyakan status alarm:
```
aws iottwinmaker get-property-value-history --cli-input-json \
'{
"workspaceId": "{workspaceId}",
"entityId": "{entityId}",
"componentName": "{componentName}",
"selectedProperties": ["alarm_status"],
"startTime": "{startTimeIsoString}",
"endTime": "{endTimeIsoString}"
}'
```
Di bawah ini adalah contoh permintaan untuk menanyakan ambang alarm.
```
aws iottwinmaker get-property-value-history --cli-input-json \
'{
"workspaceId": "{workspaceId}",
"entityId": "{entityId}",
"componentName": "{componentName}",
"selectedProperties": ["alarm_threshold"],
"startTime": "{startTimeIsoString}",
"endTime": "{endTimeIsoString}"
}'
```
Di bawah ini adalah contoh permintaan untuk memperbarui ambang alarm:
```
aws iottwinmaker batch-put-property-values --cli-input-json \
'{
"workspaceId": "{workspaceId}",
"entries": [
{
"entityPropertyReference": {
"entityId": "{entityId}",
"componentName": "{componentName}",
"propertyName": "alarm_threshold"
},
"propertyValues": [
{
"value": {
"doubleValue": "{newThreshold}"
},
"time": "{effectiveTimeIsoString}"
}
]
}
]
}'
```
## Konfigurasikan dasbor Grafana Anda untuk alarm
Peran IAM dasbor yang diaktifkan penulisan kedua perlu dibuat, itu adalah peran normal tetapi dengan izin agar tindakan ditambahkan `iottwinmaker:BatchPutPropertyValues` ke TwinMaker ruang kerja seperti pada contoh di bawah ini.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iottwinmaker:Get*",
"iottwinmaker:List*",
"iottwinmaker:BatchPutPropertyValues"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
},
{
"Effect": "Allow",
"Action": "iottwinmaker:ListWorkspaces",
"Resource": "*"
}
]
}
```
------
Atau Anda dapat menambahkan pernyataan ini di akhir peran IAM Anda sebagai gantinya:
```
{
"Effect": "Allow",
"Action": [
"iottwinmaker:BatchPutPropertyValues"
],
"Resource": [
"{workspaceArn}",
"{workspaceArn}/*"
]
}
```
Sumber data harus disetel arn tulis dengan peran tulis dasbor yang Anda buat.
Setelah Anda mengubah peran IAM Anda, masuk ke dasbor Grafana Anda untuk mengambil peran yang diperbarui arn. Pilih kotak centang untuk **Tentukan izin tulis untuk Panel Konfigurasi Alarm** dan salin di arn untuk peran Tulis.
![\[Tab Pengaturan dasbor Grafana dengan kotak centang yang dipilih dan kotak entri arn disorot.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/alarmDataSource.png)
## Gunakan dasbor Grafana untuk visualisasi alarm
Gunakan prosedur berikut untuk menambahkan panel konfigurasi alarm ke dasbor Anda dan konfigurasikan:
1. Pilih ruang kerja di opsi panel.
1. Tetapkan sumber data Anda dalam konfigurasi kueri.
1. Gunakan jenis kueri berikut:`Get Property Value History by Entity`.
1. Pilih entitas atau variabel entitas, Anda ingin menambahkan alarm ke.
1. Setelah Anda memilih entitas, pilih komponen atau variabel komponen, untuk menerapkan properti ke.
1. Untuk properti, pilih: `alarm_status` dan`alarm_threshold`.
Ketika terhubung, Anda akan melihat Id untuk Id alarm dan ambang batas saat ini.
**catatan**
Untuk pratinjau publik, tidak ada pemberitahuan yang ditampilkan. Anda harus meninjau status alarm dan ambang batas untuk memastikan properti diterapkan dengan benar.
1. Urutan Kueri default dari Ascending harus digunakan sehingga nilai terbaru ditampilkan.
1. Bagian filter dari Query dapat dibiarkan kosong. Konfigurasi lengkap digambarkan di bawah ini:
![\[Grafana Labs Alarm Config Test/Edit Panel dengan konfigurasi lengkap diisi.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/alarmConfigPanel.png)
1. Dengan menggunakan tombol **Edit Alarm** Anda dapat memunculkan dialog untuk mengubah ambang alarm saat ini.
1. Pilih **Simpan** untuk menetapkan nilai ambang baru.
![\[Kotak dialog Edit alarm dengan tombol Batal dan Simpan.\]](http://docs.aws.amazon.com/id_id/iot-twinmaker/latest/guide/images/alarmThresholdModal.png)
**catatan**
Panel ini hanya boleh digunakan dengan rentang waktu langsung yang mencakup masa kini. Menggunakannya dengan rentang waktu yang berakhir dan dimulai di masa lalu dapat menunjukkan nilai yang tidak terduga saat mengedit ambang alarm sebagai ambang batas saat ini selalu.