

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

# Memecahkan masalah tindakan aturan AWS IoT SiteWise
<a name="troubleshoot-rule"></a>

Untuk memecahkan masalah tindakan AWS IoT SiteWise aturan Anda AWS IoT Core, Anda dapat melakukan salah satu prosedur berikut:
+ Konfigurasikan CloudWatch Log Amazon
+ Konfigurasikan tindakan kesalahan publikasi ulang untuk aturan Anda

Kemudian, bandingkan pesan kesalahan dengan kesalahan dalam topik ini untuk memecahkan masalah Anda.

**Topics**
+ [Konfigurasikan AWS IoT Core log](#configure-iot-logs)
+ [Konfigurasikan tindakan kesalahan penerbitan ulang](#configure-republish-error-action)
+ [Memecahkan masalah aturan](#troubleshoot-rule-issues)
+ [Memecahkan masalah aturan ()AWS IoT SiteWise](#rule-tutorial-troubleshoot-rule)
+ [Memecahkan masalah aturan (DynamoDB)](#dynamodb-tutorial-troubleshoot-rule)

## Konfigurasikan AWS IoT Core log
<a name="configure-iot-logs"></a>

Anda dapat mengonfigurasi AWS IoT untuk mencatat berbagai tingkat informasi ke CloudWatch Log.

**Untuk mengkonfigurasi dan mengakses CloudWatch Log**

1. Untuk mengonfigurasi pencatatan AWS IoT Core, lihat [Pemantauan dengan CloudWatch Log](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) di *Panduan AWS IoT Pengembang*.

1. Navigasikan ke [konsol CloudWatch ](https://console.aws.amazon.com/cloudwatch/) tersebut.

1. Pada panel navigasi, pilih **Grup log**.

1. Pilih grup **AWSIotLog**.

1. Pilih aliran log terbaru. Secara default, CloudWatch menampilkan aliran log terbaru terlebih dahulu.

1. Pilih entri log untuk memperluas pesan log. Entri log Anda mungkin terlihat seperti tangkapan layar berikut.  
![\[CloudWatch Tangkapan layar "AWS IoT Log”.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-logs-console.png)

1. Bandingkan pesan kesalahan dengan kesalahan dalam topik ini untuk memecahkan masalah Anda.

## Konfigurasikan tindakan kesalahan penerbitan ulang
<a name="configure-republish-error-action"></a>

Anda dapat mengonfigurasi tindakan kesalahan pada aturan Anda untuk menangani pesan kesalahan. Dalam prosedur ini, Anda mengonfigurasi tindakan aturan penerbitan ulang sebagai tindakan kesalahan untuk melihat pesan kesalahan di klien pengujian MQTT.

**catatan**  
Tindakan kesalahan penerbitan ulang hanya menghasilkan log `ERROR` level yang setara. Jika Anda ingin lebih banyak log verbose, Anda harus [mengkonfigurasi CloudWatch ](#configure-iot-logs) Log.

**Untuk menambahkan tindakan kesalahan penerbitan ulang ke aturan**

1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.

1. Di panel navigasi kiri, pilih **Bertindak** lalu pilih **Aturan**.

1. Pilih aturan Anda.

1. Di bawah **Tindakan kesalahan**, pilih **Tambah tindakan**.

1. Pilih **Menerbitkan ulang pesan ke suatu AWS IoT topik**.  
![\[AWS IoT Core Tangkapan layar halaman “Pilih tindakan” dengan tindakan Republish disorot.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/rule-ingestion/rule-choose-republish-action-console.png)

1. Pilih **Konfigurasi tindakan** di bagian bawah halaman.

1. Di **Topik**, masukkan topik unik (misalnya,**sitewise/windfarm/rule/error**). AWS IoT Core akan menerbitkan ulang pesan kesalahan ke topik ini.

1. Pilih **Pilih** untuk memberikan AWS IoT Core akses untuk melakukan tindakan kesalahan.

1. Pilih **Pilih** di samping peran yang Anda buat untuk aturan.

1. Pilih **Perbarui Peran** untuk menambahkan izin tambahan ke peran.

1. Pilih **Tambahkan tindakan**.

   Tindakan kesalahan aturan Anda akan terlihat mirip dengan tangkapan layar berikut.  
![\[AWS IoT Core Halaman “Aturan” Publikasikan ulang tangkapan layar tindakan kesalahan.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/rule-ingestion/rule-confirm-republish-error-action-console.png)

1. Pilih panah belakang di kiri atas konsol untuk kembali ke rumah AWS IoT konsol.

Setelah mengatur tindakan kesalahan penerbitan ulang, Anda dapat melihat pesan kesalahan di klien pengujian MQTT di. AWS IoT Core

Dalam prosedur berikut, Anda berlangganan topik kesalahan di klien pengujian MQTT. Di klien pengujian MQTT, Anda dapat menerima pesan kesalahan aturan untuk memecahkan masalah.

**Untuk berlangganan topik tindakan kesalahan**

1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.

1. Di halaman navigasi kiri, pilih **Uji** untuk membuka klien pengujian MQTT.

1. Di bidang **Subscription topic**, masukkan topik error yang Anda konfigurasikan sebelumnya (misalnya,**sitewise/windfarm/rule/error**) dan pilih **Subscribe to topic**.  
![\[AWS IoT Core Tangkapan layar halaman “Klien MQTT” dengan tombol “Berlangganan topik” disorot.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-subscribe-error-topic-console.png)

1. Perhatikan pesan kesalahan muncul dan kemudian perluas `failures` array dalam pesan kesalahan apa pun. 

   Selanjutnya, bandingkan pesan kesalahan dengan kesalahan dalam topik ini untuk memecahkan masalah Anda.

## Memecahkan masalah aturan
<a name="troubleshoot-rule-issues"></a>

Gunakan informasi berikut untuk memecahkan masalah aturan.

**Topics**
+ [Kesalahan: Anggota harus berada dalam 604800 detik sebelum dan 300 detik setelah stempel waktu saat ini](#rule-error-timestamp-out-of-range)
+ [Kesalahan: Nilai properti tidak cocok dengan tipe data <type>](#rule-error-invalid-data-type)
+ [Kesalahan: Pengguna: <role-arn>tidak berwenang untuk melakukan: iotsitewise: pada sumber daya BatchPutAssetPropertyValue](#rule-error-role-not-authorized)
+ [Kesalahan: iot.amazonaws.com tidak dapat melakukan: sts: on resource: AssumeRole <role-arn>](#rule-error-unable-to-assume-role)
+ [Info: Tidak ada permintaan yang dikirim. PutAssetPropertyValueEntries kosong setelah melakukan templat substitusi.](#rule-info-request-was-empty)

### Kesalahan: Anggota harus berada dalam 604800 detik sebelum dan 300 detik setelah stempel waktu saat ini
<a name="rule-error-timestamp-out-of-range"></a>

Stempel waktu Anda lebih tua dari 7 hari atau lebih baru dari 5 menit, dibandingkan dengan waktu epoch Unix saat ini. Coba tindakan berikut ini:
+ Periksa apakah stempel waktu Anda dalam waktu Unix epoch (UTC). Jika Anda memberikan stempel waktu dengan zona waktu yang berbeda, Anda menerima kesalahan ini.
+ Periksa apakah stempel waktu Anda dalam hitungan detik. AWS IoT SiteWise mengharapkan stempel waktu dibagi menjadi waktu dalam hitungan detik (dalam waktu epoch Unix) dan diimbangi dalam nanodetik.
+ Periksa apakah Anda mengunggah data yang diberi stempel waktu selambat-lambatnya 7 hari sebelumnya.

### Kesalahan: Nilai properti tidak cocok dengan tipe data <type>
<a name="rule-error-invalid-data-type"></a>

Entri dalam tindakan aturan Anda memiliki tipe data yang berbeda dari properti aset target. Misalnya, properti aset target Anda adalah `DOUBLE` dan tipe data yang Anda pilih adalah **Integer** atau Anda meneruskan nilainya. `integerValue` Coba tindakan berikut ini:
+ Jika Anda mengonfigurasi aturan dari AWS IoT konsol, periksa apakah Anda memilih **tipe Data** yang benar untuk setiap entri.
+ Jika Anda mengonfigurasi aturan dari API atau AWS Command Line Interface (AWS CLI), periksa apakah `value` objek Anda menggunakan bidang tipe yang benar (misalnya, `doubleValue` untuk `DOUBLE` properti).

### Kesalahan: Pengguna: <role-arn>tidak berwenang untuk melakukan: iotsitewise: pada sumber daya BatchPutAssetPropertyValue
<a name="rule-error-role-not-authorized"></a>

Aturan Anda tidak diizinkan untuk mengakses properti aset target, atau properti aset target tidak ada. Coba tindakan berikut ini:
+ Periksa apakah alias properti Anda benar dan bahwa Anda memiliki properti aset dengan alias properti yang diberikan. Untuk informasi selengkapnya, lihat [Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).
+ Pastikan aturan Anda memiliki peran dan peran tersebut mengizinkan `iotsitewise:BatchPutAssetPropertyValue` izin ke properti aset yang ditargetkan, seperti melalui hierarki aset target. Untuk informasi selengkapnya, lihat [Berikan AWS IoT akses yang diperlukan](grant-rule-access.md).

### Kesalahan: iot.amazonaws.com tidak dapat melakukan: sts: on resource: AssumeRole <role-arn>
<a name="rule-error-unable-to-assume-role"></a>

Pengguna Anda tidak diizinkan untuk mengambil peran pada aturan Anda di AWS Identity and Access Management (IAM).

Periksa apakah pengguna Anda diizinkan `iam:PassRole` izin untuk peran pada aturan Anda. Untuk informasi selengkapnya, lihat [Meneruskan izin peran](https://docs.aws.amazon.com/iot/latest/developerguide/pass-role.html) di *Panduan AWS IoT Pengembang*.

### Info: Tidak ada permintaan yang dikirim. PutAssetPropertyValueEntries kosong setelah melakukan templat substitusi.
<a name="rule-info-request-was-empty"></a>

**catatan**  
Pesan ini adalah log `INFO` level.

Permintaan Anda harus memiliki setidaknya satu entri dengan semua parameter yang diperlukan.

Periksa apakah parameter aturan Anda, termasuk templat substitusi, menghasilkan nilai yang tidak kosong. Templat substitusi tidak dapat mengakses nilai yang ditentukan dalam `AS` klausa dalam pernyataan kueri aturan Anda. Untuk informasi selengkapnya, lihat [Templat substitusi](https://docs.aws.amazon.com/iot/latest/developerguide/iot-substitution-templates.html) di *Panduan AWS IoT Pengembang*.

## Memecahkan masalah aturan ()AWS IoT SiteWise
<a name="rule-tutorial-troubleshoot-rule"></a>

Ikuti langkah-langkah dalam prosedur ini untuk memecahkan masalah aturan Anda jika data penggunaan CPU dan memori tidak muncul AWS IoT SiteWise seperti yang diharapkan. Dalam prosedur ini, Anda mengonfigurasi tindakan aturan penerbitan ulang sebagai tindakan kesalahan untuk melihat pesan kesalahan di klien pengujian MQTT. Anda juga dapat mengonfigurasi logging ke CloudWatch Log untuk memecahkan masalah. Untuk informasi selengkapnya, lihat [Memecahkan masalah tindakan aturan AWS IoT SiteWise](#troubleshoot-rule).

**Untuk menambahkan tindakan kesalahan penerbitan ulang ke aturan**

1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.

1. **Di panel navigasi kiri, pilih **Perutean pesan**, lalu pilih Aturan.**

1. Pilih aturan yang Anda buat sebelumnya dan pilih **Edit**.

1. Di bawah **Tindakan kesalahan - *opsional***, pilih **Tambahkan tindakan kesalahan**.

1. Pilih **Menerbitkan ulang pesan ke suatu AWS IoT topik**.

1. Di **Topik**, masukkan jalur ke kesalahan Anda (misalnya,**sitewise/rule/tutorial/error**). AWS IoT Core akan menerbitkan ulang pesan kesalahan ke topik ini.

1. Pilih peran yang Anda buat sebelumnya (misalnya, **SiteWiseTutorialDeviceRuleRole**).

1. Pilih **Perbarui**.

Setelah mengatur tindakan kesalahan penerbitan ulang, Anda dapat melihat pesan kesalahan di klien pengujian MQTT di. AWS IoT Core

Dalam prosedur berikut, Anda berlangganan topik kesalahan di klien pengujian MQTT.

**Untuk berlangganan topik tindakan kesalahan**

1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.

1. Di halaman navigasi kiri, pilih klien pengujian **MQTT untuk membuka klien pengujian** MQTT.

1. Di bidang **Filter topik**, masukkan **sitewise/rule/tutorial/error** dan pilih **Berlangganan**.

Saat pesan kesalahan muncul, lihat `failures` larik dalam pesan kesalahan apa pun untuk mendiagnosis masalah. Untuk informasi selengkapnya tentang kemungkinan masalah dan cara mengatasinya, lihat[Memecahkan masalah tindakan aturan AWS IoT SiteWise](#troubleshoot-rule).

Jika kesalahan tidak muncul, periksa apakah aturan Anda diaktifkan dan Anda berlangganan topik yang sama dengan yang Anda konfigurasi dalam tindakan kesalahan penerbitan ulang. Jika kesalahan masih tidak muncul setelah Anda melakukannya, periksa apakah skrip perangkat berjalan dan memperbarui bayangan perangkat dengan sukses.

**catatan**  
Anda juga dapat berlangganan topik pembaruan bayangan perangkat Anda untuk melihat muatan yang diuraikan AWS IoT SiteWise tindakan Anda. Untuk melakukannya, berlangganan topik berikut.  

```
$aws/things/+/shadow/update/accepted
```

## Memecahkan masalah aturan (DynamoDB)
<a name="dynamodb-tutorial-troubleshoot-rule"></a>

Ikuti langkah-langkah dalam prosedur ini untuk memecahkan masalah aturan Anda jika data aset demo tidak muncul di tabel DynamoDB seperti yang diharapkan. Dalam prosedur ini, Anda mengonfigurasi tindakan aturan penerbitan ulang sebagai tindakan kesalahan untuk melihat pesan kesalahan di klien pengujian MQTT. Anda juga dapat mengonfigurasi logging ke CloudWatch Log untuk memecahkan masalah. Untuk informasi selengkapnya, lihat [Memantau dengan CloudWatch Log](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) di *Panduan AWS IoT Pengembang*.

**Untuk menambahkan tindakan kesalahan penerbitan ulang ke aturan**

1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.

1. Di panel navigasi kiri, pilih **Bertindak** lalu pilih **Aturan**.

1. Pilih aturan yang Anda buat sebelumnya.  
![\[AWS IoT Tangkapan layar halaman inti “Aturan”.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-rule-console.png)

1. Di bawah **Tindakan kesalahan**, pilih **Tambah tindakan**.

1. Pilih **Menerbitkan ulang pesan ke suatu AWS IoT topik**.  
![\[AWS IoT Tangkapan layar halaman inti “Pilih tindakan” dengan tindakan Republish disorot.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-republish-action-console.png)

1. Pilih **Konfigurasi tindakan** di bagian bawah halaman.

1. Di **Topik**, masukkan**windspeed/error**. AWS IoT Core akan menerbitkan ulang pesan kesalahan ke topik ini.  
![\[AWS IoT Tangkapan layar halaman inti “Konfigurasi Republish action” dengan “Topik” disorot.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-configure-republish-action-console.png)

1. Pilih **Pilih** untuk memberikan akses AWS IoT Inti untuk melakukan tindakan kesalahan menggunakan peran yang Anda buat sebelumnya.

1. Pilih **Pilih** di sebelah peran Anda.  
![\[AWS IoT Tangkapan layar halaman inti “Konfigurasi Republish action” dengan tombol pilih peran disorot.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-select-role-console.png)

1. Pilih **Perbarui Peran** untuk menambahkan izin tambahan ke peran.  
![\[AWS IoT Tangkapan layar halaman inti “Konfigurasi Republish action” dengan tombol peran pembaruan disorot.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-update-role-console.png)

1. Pilih **Tambahkan tindakan** untuk menyelesaikan penambahan tindakan kesalahan.

1. Pilih panah belakang di kiri atas konsol untuk kembali ke rumah konsol AWS IoT Core.

Setelah mengatur tindakan kesalahan penerbitan ulang, Anda dapat melihat pesan kesalahan di klien pengujian MQTT di Core. AWS IoT 

Dalam prosedur berikut, Anda berlangganan topik kesalahan di klien pengujian MQTT.

**Untuk berlangganan topik tindakan kesalahan**

1. Di halaman navigasi kiri konsol AWS IoT inti, pilih **Uji**.

1. Di bidang **Subscription topic**, masukkan **windspeed/error** dan pilih **Subscribe to topic**.  
![\[AWS IoT Tangkapan layar halaman inti “klien MQTT” dengan tombol “Berlangganan topik” disorot.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-subscribe-error-topic-console.png)

1. Perhatikan pesan kesalahan muncul dan jelajahi `failures` larik dalam pesan kesalahan untuk mendiagnosis masalah umum berikut:
   + Kesalahan ketik dalam pernyataan kueri aturan
   + Izin peran tidak memadai

   Jika kesalahan tidak muncul, periksa apakah aturan Anda diaktifkan dan Anda berlangganan topik yang sama dengan yang Anda konfigurasi dalam tindakan kesalahan penerbitan ulang. Jika kesalahan masih tidak muncul, periksa apakah aset ladang angin demo Anda masih ada dan Anda mengaktifkan notifikasi pada properti kecepatan angin. Jika aset demo Anda kedaluwarsa dan hilang AWS IoT SiteWise, Anda dapat membuat demo baru dan memperbarui pernyataan kueri aturan untuk mencerminkan model aset dan properti IDs yang diperbarui.