Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pemecahan masalah AWS IoT SiteWise
Gunakan informasi berikut untuk memecahkan masalah dengan. AWS IoT SiteWise
**Topics**
+ [Memecahkan masalah gateway Edge SiteWise](troubleshooting-gateway.md)
+ [Memecahkan masalah portal AWS IoT SiteWise](troubleshooting-portal.md)
+ [Memecahkan masalah tindakan aturan AWS IoT SiteWise](troubleshoot-rule.md)
+ [Memecahkan masalah operasi impor dan ekspor massal](troubleshooting-bulk.md)
# Memecahkan masalah gateway Edge SiteWise
Memecahkan masalah umum AWS IoT SiteWise Edge gateway dengan menjelajahi topik yang relevan.
Anda juga dapat melihat CloudWatch metrik yang dilaporkan oleh gateway SiteWise Edge untuk memecahkan masalah dengan konektivitas atau aliran data. Untuk informasi selengkapnya, lihat [Pantau AWS IoT SiteWise dengan CloudWatch metrik Amazon](monitor-cloudwatch-metrics.md).
**Topics**
+ [Konfigurasikan dan akses log gateway SiteWise Edge](#configure-gateway-logs)
+ [Memecahkan masalah gateway SiteWise Edge](#troubleshoot-gateway-issues)
+ [Memecahkan masalah aplikasi AWS IoT SiteWise Edge pada Siemens Industrial Edge](#troubleshoot-siemens-app)
+ [Memecahkan masalah integrasi sumber terbuka di Edge](#open-source-troubleshooting)
+ [Memecahkan masalah AWS IoT Greengrass](#troubleshoot-greengrass-issues)
## Konfigurasikan dan akses log gateway SiteWise Edge
Sebelum Anda dapat melihat log gateway SiteWise Edge, Anda harus mengonfigurasi gateway SiteWise Edge Anda untuk mengirim log ke Amazon CloudWatch Logs atau menyimpan log di sistem file lokal.
+ Gunakan CloudWatch Log jika Anda ingin menggunakannya Konsol Manajemen AWS untuk melihat file log gateway SiteWise Edge Anda. Untuk informasi selengkapnya, lihat [Gunakan CloudWatch Log Amazon](gateway-cloudwatch-logs.md).
+ Gunakan log sistem file lokal jika Anda ingin menggunakan baris perintah atau perangkat lunak lokal untuk melihat file log gateway SiteWise Edge Anda. Untuk informasi selengkapnya, lihat [Gunakan log layanan di AWS IoT SiteWise](gateway-local-logs.md).
## Memecahkan masalah gateway SiteWise Edge
Gunakan informasi berikut untuk memecahkan masalah gateway SiteWise Edge.
**Topics**
+ [Tidak dapat menerapkan paket ke gateway SiteWise Edge](#gateway-issue-ggv2-packs)
+ [AWS IoT SiteWise tidak menerima data dari server OPC UA](#gateway-issue-data-streams)
+ [Tidak ada data yang ditampilkan di dasbor](#gateway-issue-no-data)
+ [“Tidak dapat menemukan atau memuat kelas utama” muncul di aws.iot. SiteWiseEdgePublisher log di/greengrass/v2/logskesalahan](#troubleshoot-java-issues)
+ [Saya melihat 'SESSION\$1TAKEN\$1OVER' atau 'com.aws.greengrass.mqttclient. MqttClient: Gagal mempublikasikan pesan melalui Spooler dan akan mencoba lagi. ' di log](#sa-troubleshoot-multiple-use)
+ [Saya melihat 'com.aws.greengrass.deployment. IotJobsHelper: Tidak ada pekerjaan penerapan yang ditemukan. ' atau 'Hasil penerapan sudah dilaporkan. ' di log](#sa-troubleshoot-reuse)
+ [Saya melihat status 'SYNC\$1FAILED' ketika mencoba mengonfigurasi pengaturan stempel waktu dalam grup properti pada sumber data OPC UA](#troubleshoot-gateway-sync-failed-timestamp)
+ [Tipe data yang dikonversi tidak termasuk](#troubleshoot-data-conversion)
+ [Masalah toko kepercayaan](#troubleshoot-trust-stores)
+ [Masalah instalasi berkemampuan proxy](#troubleshoot-proxy-during-installation)
### Tidak dapat menerapkan paket ke gateway SiteWise Edge
Jika AWS IoT Greengrass nucleus component (`aws.greengrass.Nucleus`) sudah kedaluwarsa, Anda mungkin tidak dapat menerapkan paket ke gateway SiteWise Edge Anda. Anda dapat menggunakan AWS IoT Greengrass V2 konsol untuk memutakhirkan komponen AWS IoT Greengrass nukleus.
**Untuk memutakhirkan komponen AWS IoT Greengrass nukleus (konsol)**
1. Navigasikan ke [konsol AWS IoT Greengrass](https://console.aws.amazon.com/greengrassIntro) tersebut.
1. Di panel navigasi, di bawah **AWS IoT Greengrass**, pilih **Deployment**.
1. Dalam daftar **Deployment**, pilih deployment yang ingin Anda revisi.
1. Pilih **Revise**.
1. Pada halaman **Tentukan target**, pilih **Selanjutnya**.
1. Pada halaman **Pilih komponen**, di bawah **Komponen publik**, di kotak pencarian, masukkan**aws.greengrass.Nucleus**, lalu pilih **AWS.GreenGrass.Nucleus**.
1. Pilih **Berikutnya**.
1. Pada halaman **Konfigurasi komponen**, pilih **Berikutnya**.
1. Pada halaman **Konfigurasi pengaturan lanjutan**, pilih **Berikutnya**.
1. Di halaman **Tinjau**, pilih **Deploy**.
### AWS IoT SiteWise tidak menerima data dari server OPC UA
Jika AWS IoT SiteWise aset Anda tidak menerima data yang dikirim oleh server OPC UA, Anda dapat mencari log gateway SiteWise Edge untuk memecahkan masalah. Cari `swPublisher` log tingkat info yang berisi pesan berikut.
```
Emitting diagnostic name=PublishError.SomeException
```
Berdasarkan jenis *SomeException* di log, gunakan jenis pengecualian berikut dan masalah terkait untuk memecahkan masalah gateway SiteWise Edge Anda:
+ **ResourceNotFoundException**— Server OPC UA Anda mengirim data yang tidak cocok dengan alias properti untuk aset apa pun. Pengecualian ini dapat terjadi dalam dua kasus:
+ Alias properti Anda tidak sama persis dengan variabel OPC UA Anda, termasuk awalan sumber apa pun yang Anda tentukan. Periksa apakah alias properti dan awalan sumber Anda sudah benar.
+ Anda belum memetakan variabel OPC UA Anda ke properti aset. Untuk informasi selengkapnya, lihat [Mengelola aliran data untuk AWS IoT SiteWise](manage-data-streams.md).
Jika Anda sudah memetakan semua variabel OPC UA yang Anda inginkan AWS IoT SiteWise, Anda dapat memfilter variabel OPC UA mana yang dikirim gateway SiteWise Edge. Untuk informasi selengkapnya, lihat [Gunakan filter node OPC UA di SiteWise Edge](opc-ua-node-filters.md).
+ **InvalidRequestException**— Jenis data variabel OPC UA Anda tidak cocok dengan tipe data properti aset Anda. Misalnya, jika variabel OPC UA memiliki tipe data integer, properti aset terkait Anda harus tipe data integer. Properti aset tipe ganda tidak dapat menerima nilai integer OPC UA. Untuk memperbaiki masalah ini, tentukan properti baru dengan tipe data yang benar.
+ **TimestampOutOfRangeException**— Gateway SiteWise Edge Anda mengirim data yang berada di luar jangkauan yang AWS IoT SiteWise menerima. AWS IoT SiteWise menolak setiap titik data dengan stempel waktu lebih awal dari 7 hari di masa lalu atau lebih baru dari 5 menit di masa depan. Jika gateway SiteWise Edge Anda kehilangan daya atau koneksi ke AWS Cloud, Anda mungkin perlu menghapus cache gateway SiteWise Edge Anda.
+ **ThrottlingException**atau **LimitExceededException**— Permintaan Anda melebihi kuota AWS IoT SiteWise layanan, seperti tingkat titik data yang dicerna atau tingkat permintaan untuk operasi API data properti aset. Periksa apakah konfigurasi Anda tidak melebihi[AWS IoT SiteWise kuota](endpoints-and-quotas.md#quotas).
### Tidak ada data yang ditampilkan di dasbor
Jika tidak ada data yang ditampilkan di dasbor Anda, **konfigurasi Penerbit** dan **Sumber Data** gateway SiteWise Edge mungkin tidak sinkron. Jika tidak sinkron, memperbarui nama sumber data dapat mempercepat sinkronisasi dari cloud ke tepi, memperbaiki kesalahan Keluar dari sinkronisasi.
**Untuk memperbarui nama sumber data**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway SiteWise Edge yang terhubung ke dasbor.
1. Di bawah **Sumber data**, pilih **Edit**.
1. Pilih **nama** sumber baru, dan pilih **Simpan** untuk mengonfirmasi perubahan Anda.
1. Verifikasi perubahan Anda dengan mengonfirmasi nama sumber data telah diperbarui di tabel **Sumber data**.
### “Tidak dapat menemukan atau memuat kelas utama” muncul di aws.iot. SiteWiseEdgePublisher log di/greengrass/v2/logskesalahan
Jika Anda melihat kesalahan ini, Anda mungkin perlu memperbarui versi java dari gateway SiteWise Edge Anda.
+ Dari terminal, jalankan perintah berikut:
```
java -version
```
Versi java gateway SiteWise Edge Anda berjalan dengan akan muncul di bawah`OpenJDK Runtime Environment`. Anda akan melihat respons seperti berikut:
```
openjdk version "11.0.20" 2023-07-18 LTS
OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS
OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node)
```
Jika Anda menjalankan Java versi 11.0.20.8.1 Anda harus memperbarui paket IoT SiteWise Publisher ke versi 2.4.1 atau yang lebih baru. Hanya versi java 11.0.20.8.1 yang terpengaruh, lingkungan dengan versi java lainnya dapat terus menggunakan versi lama dari komponen IoT Publisher. SiteWise Untuk informasi selengkapnya tentang memperbarui paket komponen, lihat[Ubah versi paket komponen gateway SiteWise Edge](manage-gateways-ggv2.md#manage-gateway-update-packs).
### Saya melihat 'SESSION\$1TAKEN\$1OVER' atau 'com.aws.greengrass.mqttclient. MqttClient: Gagal mempublikasikan pesan melalui Spooler dan akan mencoba lagi. ' di log
Jika Anda melihat peringatan yang menyertakan `SESSION_TAKEN_OVER` atau kesalahan yang disertakan `com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.` dalam log Anda di`/greengrass/v2/logs/greengrass.log`, Anda mungkin mencoba menggunakan file konfigurasi yang sama untuk beberapa gateway SiteWise Edge di beberapa perangkat. Setiap gateway SiteWise Edge memerlukan file konfigurasi unik untuk terhubung ke AWS akun Anda.
### Saya melihat 'com.aws.greengrass.deployment. IotJobsHelper: Tidak ada pekerjaan penerapan yang ditemukan. ' atau 'Hasil penerapan sudah dilaporkan. ' di log
Jika Anda melihat `com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.` atau `Deployment result already reported.` dalam log Anda di`/greengrass/v2/logs/greengrass.log`, Anda mungkin mencoba untuk menggunakan kembali file konfigurasi yang sama.
Ada beberapa solusi:
+ Jika Anda ingin menggunakan kembali file konfigurasi, lakukan hal berikut:
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway SiteWise Edge yang ingin Anda gunakan kembali.
1. Pilih tab **Pembaruan**.
1. Pilih versi Publisher yang berbeda dan pilih **Deploy**.
Ikuti langkah-langkah [Buat gateway untuk Siemens Industrial Edge](sa-create-config.md) untuk membuat file konfigurasi baru.
### Saya melihat status 'SYNC\$1FAILED' ketika mencoba mengonfigurasi pengaturan stempel waktu dalam grup properti pada sumber data OPC UA
Saat AWS IoT SiteWise memperbarui komponen kolektor OPC UA untuk AWS IoT Greengrass versi 2.5.0, kami memperkenalkan opsi konfigurasi stempel waktu baru. Anda dapat menggunakan stempel waktu dari perangkat Anda, atau stempel waktu dari server. Versi lama dari komponen kolektor OPC UA tidak mendukung opsi ini dan gagal disinkronkan.
Ada dua cara untuk mengatasi status sinkronisasi sumber data yang gagal. Cara yang disarankan adalah dengan memutakhirkan komponen kolektor IoT SiteWise OPC UA ke versi 2.5.0 atau lebih tinggi. Atau, Anda dapat terus menggunakan versi komponen kolektor OPC UA yang lebih lama, jika Anda menyetel stempel waktu ke. `Source` Untuk mempelajari cara memutakhirkan komponen kolektor IoT SiteWise OPC UA, lihat. [Perbarui versi AWS IoT SiteWise komponen](manage-gateways-ggv2.md#update-component-version) Kami merekomendasikan menggunakan versi terbaru dari semua komponen.
**catatan**
Tidak ada gangguan data saat status sinkronisasi sumber data gagal. Sumber data terus mengalir ke AWS IoT SiteWise. Konfigurasi tidak disinkronkan dengan komponen kolektor SiteWise IoT OPC UA pada penerapan Anda. AWS IoT Greengrass V2
**Untuk mengubah konfigurasi stempel waktu untuk grup properti**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway yang akan diedit.
1. Di bagian **Sumber data**, pilih sumber data dengan status sinkronisasi gagal, lalu pilih **Edit**.
1. Perluas **Konfigurasi lanjutan**, lalu perluas **Pengaturan grup**.
1. **Di **Timestamp**, pilih Sumber.** Memilih **Sumber** menghapus `timestampToReturn` properti dari konfigurasi. Pengaturan ini memungkinkan pengumpulan stempel waktu sumber data dari perangkat Anda secara default, memungkinkan sumber data untuk disinkronkan dengan komponen kolektor IoT SiteWise OPC UA.
1. Pilih **Simpan**.
### Tipe data yang dikonversi tidak termasuk
Jika Anda melihat kesalahan saat mengonversi tipe data OPC UA yang tidak didukung menjadi string AWS IoT SiteWise, ada beberapa kemungkinan alasan:
+ Tipe data yang Anda coba konversi adalah tipe data yang kompleks. Tipe data yang kompleks tidak didukung.
+ Saat menggunakan **Destinasi** sebagai **AWS IoT SiteWise Buffered menggunakan Amazon** S3, nilai string penuh dipertahankan dalam file yang didorong ke bucket Amazon S3. Saat Anda kemudian memasukkan data ke dalam AWS IoT SiteWise, nilai string penuh yang lebih panjang dari 1024 byte ditolak.
### Masalah toko kepercayaan
Jika Anda mengalami masalah yang terkait dengan toko kepercayaan di SiteWise Edge, pertimbangkan langkah-langkah pemecahan masalah berikut:
+ Verifikasi bahwa sertifikat CA AWS IoT Greengrass root ada dan diformat dengan benar di toko kepercayaan yang sesuai
+ Pastikan KeyStore kata sandi Java diatur dengan benar dan dapat diakses oleh komponen SiteWise Edge
+ Periksa apakah sertifikat kustom apa pun (seperti untuk proxy HTTPS) dalam format yang benar (biasanya PEM) dan diimpor dengan benar ke toko kepercayaan
+ Konfirmasikan bahwa toko kepercayaan memiliki izin file yang benar dan dapat diakses oleh proses SiteWise Edge
+ Tinjau log SiteWise Edge untuk setiap kesalahan SSL/TLS terkait, yang mungkin mengindikasikan masalah penyimpanan kepercayaan
+ Uji SSL/TLS koneksi secara independen menggunakan alat seperti `openssl` memverifikasi fungsionalitas toko kepercayaan
### Masalah instalasi berkemampuan proxy
Jika Anda mengalami masalah selama proses konfigurasi proxy, pertimbangkan langkah-langkah pemecahan masalah berikut:
+ Verifikasi bahwa URL proxy diformat dengan benar dan menyertakan skema yang tepat (`http://`atau`https://`)
+ Pastikan bahwa setiap kredensi proxy dikodekan URL jika mengandung karakter khusus
+ Konfirmasikan bahwa daftar no-proxy mencakup semua alamat lokal dan titik akhir AWS layanan yang diperlukan
+ Untuk proxy HTTPS, verifikasi bahwa sertifikat CA yang disediakan dalam format PEM
+ Tinjau log instalasi untuk pesan kesalahan tertentu yang mungkin menunjukkan sumber masalah
+ Uji koneksi proxy secara independen untuk memastikannya berfungsi dengan benar
## Memecahkan masalah aplikasi AWS IoT SiteWise Edge pada Siemens Industrial Edge
Untuk memecahkan masalah aplikasi AWS IoT SiteWise Edge di Siemens Industrial Edge perangkat Anda, Anda dapat mengakses log untuk aplikasi melalui portal Siemens Industrial Edge Management atau Siemens Industrial Edge Device (IED). Untuk informasi selengkapnya, lihat [Mengunduh Log](https://docs.eu1.edge.siemens.cloud/build_a_device/device_building/concepts/howto-download-edge-device-logs.html) di dokumentasi Siemens.
### Data saya tidak ditampilkan di AWS IoT SiteWise
+ Pastikan tidak ada masalah dengan Databus pengguna Anda dan ikon tanda centang untuk **Databus\$1Configuration** berwarna hijau daripada abu-abu.
+ Anda mungkin tidak Siemens Industrial Edge Management menjalankan versi yang berisiSecure Storage. Tingkatkan versi Siemens OS Anda. Untuk informasi selengkapnya, lihat [Siemens Secure Storagedan aplikasi AWS IoT SiteWise Edge](sitewise-edge-on-siemens.md#sa-secure-storage).
### Saya melihat 'File konfigurasi hilang AWS\$1REGION 'di log
Jika Anda melihat `Config file missing AWS_REGION` di log Siemens, JSON dari file konfigurasi telah rusak. Anda harus membuat file konfigurasi baru. Ikuti langkah-langkah [Buat gateway untuk Siemens Industrial Edge](sa-create-config.md) untuk membuat file konfigurasi baru.
### Saya melihat pesan kesalahan 'Out of sync' pada konfigurasi gateway Edge
Jika Anda melihat pesan `Out of sync` kesalahan di Siemens Industrial Edge gateway setelah penerapan selesai, itu berarti komponen penerbit SiteWise IoT tidak sinkron dengan gateway Anda. Komponen SiteWise penerbit IoT bekerja di latar belakang Siemens Industrial Edge gateway untuk menyediakan fungsionalitas topik MQTT. Kami meningkatkan Siemens Industrial Edge gateway untuk menggunakan `iotsitewise:publisher:3` namespace kemampuan daripada. `iotsitewise:publisher:2` Anda dapat memperbarui ke versi terbaru penerbit untuk mengatasi masalah ini.
**Untuk meningkatkan ke versi terbaru dari penerbit IoT SiteWise**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih Siemens Industrial Edge gateway yang akan diedit.
1. Di bagian **kemampuan Edge**, pilih **versi perangkat lunak Lihat**.
1. Pilih versi terbaru penerbit IoT di bawah menu SiteWise tarik-turun **Penerbit**.
1. Pilih **Selesai**.
## Memecahkan masalah integrasi sumber terbuka di Edge
Bagian ini memberikan solusi untuk masalah umum yang mungkin Anda temui saat mengintegrasikan alat sumber terbuka dengan SiteWise Edge.
**catatan**
Node-red®, InfluxDB®, dan Grafana® bukan vendor atau pemasok untuk Edge. SiteWise
### Masalah koneksi
Node-red tidak dapat terhubung ke broker MQTT
Verifikasi bahwa broker MQTT berjalan dan dapat diakses pada port yang ditentukan. Periksa konfigurasi jaringan Anda dan pastikan bahwa alamat broker sudah benar.
Untuk memverifikasi status broker MQTT, jalankan:
```
docker ps | grep emqx
```
Kesalahan koneksi InfluxDB
Pastikan token otentikasi Anda valid dan Anda telah menentukan nama organisasi dan bucket yang benar. Periksa apakah InfluxDB berjalan dan dapat diakses.
Untuk memverifikasi status InfluxDB, jalankan:
```
curl -I http://localhost:8086
```
Grafana tidak dapat terhubung ke InfluxDB
Verifikasi bahwa konfigurasi sumber data InfluxDB di Grafana sudah benar, termasuk URL, token otentikasi, organisasi, dan bucket.
### Masalah aliran data
Tidak ada data yang muncul di AWS IoT SiteWise
Periksa apakah alias properti Anda di alur Node-Red cocok dengan format yang diharapkan. Verifikasi bahwa struktur topik MQTT sudah benar dan gateway SiteWise Edge dikonfigurasi dengan benar untuk menerima data dari broker MQTT.
Tidak ada data SiteWise Edge yang disimpan di InfluxDB
Verifikasi bahwa alur retensi Node-Red dikonfigurasi dengan benar dan node penulis InfluxDB memiliki pengaturan bucket dan pengukuran yang tepat. Periksa output debug Node-Red untuk kesalahan apa pun.
Kesalahan format data
Pastikan transformasi data Anda berfungsi dengan benar mengonversi data antar format. Gunakan node debug Node-Red untuk memeriksa data pada setiap tahap aliran.
### Masalah kinerja
Penggunaan CPU atau memori yang tinggi
Pantau penggunaan sumber daya dan sesuaikan konfigurasi komponen Anda sesuai kebutuhan. Pertimbangkan untuk mengurangi frekuensi pengumpulan data atau menerapkan penyaringan data untuk mengurangi beban pemrosesan.
Untuk memantau penggunaan sumber daya, jalankan:
```
docker stats
```
Pemuatan dasbor Grafana lambat
Optimalkan kueri InfluxDB Anda dan pertimbangkan untuk menambahkan batasan rentang waktu ke panel dasbor Anda. Kurangi jumlah titik data yang ditampilkan dengan menggunakan fungsi agregasi yang sesuai.
### Pencatatan dan diagnostik
Untuk memecahkan masalah, periksa log untuk setiap komponen:
Log merah simpul
Lihat log di konsol Node-merah atau jalankan:
```
docker logs node-red
```
Log InfluxDB
Akses log dengan menjalankan:
```
docker logs influxdb
```
Log Grafana
Lihat log dengan menjalankan:
```
docker logs grafana
```
SiteWise Log tepi
Periksa log gateway SiteWise Edge untuk masalah koneksi dan pemrosesan data MQTT. Untuk informasi selengkapnya, lihat [Memecahkan masalah gateway Edge SiteWise](#troubleshooting-gateway).
## Memecahkan masalah AWS IoT Greengrass
*Untuk menemukan solusi untuk banyak masalah saat mengonfigurasi atau menerapkan gateway SiteWise Edge AWS IoT Greengrass, lihat [Pemecahan Masalah AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-troubleshooting.html) di Panduan Pengembang.AWS IoT Greengrass *
# Memecahkan masalah portal AWS IoT SiteWise
Memecahkan masalah umum dengan portal Anda AWS IoT SiteWise .
## Pengguna dan administrator tidak dapat mengakses portal AWS IoT SiteWise
Jika pengguna atau administrator tidak dapat mengakses AWS IoT SiteWise portal Anda, Anda mungkin telah membatasi izin dalam kebijakan terlampir AWS Identity and Access Management (IAM) yang mencegah login berhasil.
Lihat contoh kebijakan IAM berikut yang akan mengakibatkan kegagalan login:
**catatan**
Setiap kebijakan IAM terlampir yang menyertakan `"Condition"` elemen akan menyebabkan kegagalan login.
**Contoh 1**: Kondisi di sini adalah IP terbatas, dan ini akan menyebabkan kegagalan login.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iotsitewise:DescribePortal"
],
"Resource": "*",
"Condition": {
"IpAddress": {
"aws:SourceIp": [
"203.0.113.0/24"
]
}
}
}
]
}
```
------
**Contoh 2**: Kondisi di sini adalah tag yang disertakan, dan ini akan menyebabkan kegagalan login.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iotsitewise:DescribePortal"
],
"Resource": "*",
"Condition": {
"StringLike": {
"aws:ResourceTag/project": "*"
}
}
}
]
}
```
------
Saat menambahkan pengguna atau administrator ke portal, hindari membuat kebijakan IAM yang membatasi izin pengguna, seperti IP terbatas. Kebijakan terlampir dengan izin terbatas tidak akan dapat terhubung ke AWS IoT SiteWise portal.
# Memecahkan masalah tindakan aturan AWS IoT SiteWise
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
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
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
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 ](#rule-error-invalid-data-type)
+ [Kesalahan: Pengguna: 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 ](#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
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
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: tidak berwenang untuk melakukan: iotsitewise: pada sumber daya BatchPutAssetPropertyValue
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
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.
**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
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)
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.
# Memecahkan masalah operasi impor dan ekspor massal
Untuk menangani dan mendiagnosis kesalahan yang dihasilkan selama tugas transfer, lihat AWS IoT TwinMaker **GetMetadataTransferJob**API:
1. Setelah membuat dan menjalankan tugas transfer, panggil **GetMetadataTransferJob**API:
```
aws iottwinmaker get-metadata-transfer-job \
--metadata-transfer-job-id your_metadata_transfer_job_id \
--region us-east-1
```
1. Keadaan pekerjaan berubah menjadi salah satu negara di bawah ini:
+ DISELESAIKAN
+ DIBATALKAN
+ ERROR
1. **GetMetadataTransferJob**API mengembalikan [ MetadataTransferJobProgress](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html)objek.
1. **MetadataTransferJobProgress**Objek berisi parameter berikut:
+ **FailedCount**: Menunjukkan jumlah aset yang gagal selama proses transfer.
+ **SkippedCount**: Menunjukkan jumlah aset yang dilewati selama proses transfer.
+ **SucceededCount**: Menunjukkan jumlah aset yang berhasil selama proses transfer.
+ **TotalCount**: Menunjukkan jumlah total aset yang terlibat dalam proses transfer.
1. Selain itu, elemen **reportURL** dikembalikan oleh panggilan API, yang berisi URL yang telah ditandatangani sebelumnya. Jika pekerjaan transfer Anda memiliki kesalahan yang perlu diselidiki, Anda dapat mengunduh laporan kesalahan lengkap di URL ini.