Memecahkan masalah gateway Edge SiteWise - AWS IoT SiteWise
Konfigurasikan dan akses log gateway SiteWise EdgeMemecahkan masalah gateway SiteWise EdgeMemecahkan masalah aplikasi AWS IoT SiteWise Edge pada Siemens Industrial EdgeMemecahkan masalah integrasi sumber terbuka di EdgeMemecahkan masalah AWS IoT Greengrass

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

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.

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 menggunakan file log gateway SiteWise Edge AWS Management Console untuk melihat file log gateway Edge Anda. Untuk informasi selengkapnya, lihat Gunakan CloudWatch Log Amazon.

  • 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.

Memecahkan masalah gateway SiteWise Edge

Gunakan informasi berikut untuk memecahkan masalah gateway SiteWise Edge.

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 tersebut.

  2. Di panel navigasi, di bawah AWS IoT Greengrass, pilih Deployment.

  3. Dalam daftar Deployment, pilih deployment yang ingin Anda revisi.

  4. Pilih Revise.

  5. Pada halaman Tentukan target, pilih Selanjutnya.

  6. Pada halaman Pilih komponen, di bawah Komponen publik, di kotak pencarian, masukkanaws.greengrass.Nucleus, lalu pilih AWS.GreenGrass.Nucleus.

  7. Pilih Berikutnya.

  8. Pada halaman Konfigurasi komponen, pilih Berikutnya.

  9. Pada halaman Konfigurasi pengaturan lanjutan, pilih Berikutnya.

  10. 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.

      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.

  • 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.

  • ThrottlingExceptionatau 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 melebihiAWS IoT SiteWise kuota.

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 tersebut.

  2. Di panel navigasi, pilih gateway Edge.

  3. Pilih gateway SiteWise Edge yang terhubung ke dasbor.

  4. Di bawah Sumber data, pilih Edit.

  5. Pilih nama sumber baru, dan pilih Simpan untuk mengonfirmasi perubahan Anda.

  6. 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 bawahOpenJDK 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, lihatUbah versi paket komponen gateway SiteWise Edge.

Saya melihat 'SESSION_TAKEN_OVER' 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 tersebut.

    2. Di panel navigasi, pilih gateway Edge.

    3. Pilih gateway SiteWise Edge yang ingin Anda gunakan kembali.

    4. Pilih tab Pembaruan.

    5. Pilih versi Publisher yang berbeda dan pilih Deploy.

Ikuti langkah-langkah Buat gateway untuk Siemens Industrial Edge untuk membuat file konfigurasi baru.

Saya melihat status 'SYNC_FAILED' 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 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 tersebut.

  2. Di panel navigasi, pilih gateway Edge.

  3. Pilih gateway untuk diedit.

  4. Di bagian Sumber data, pilih sumber data dengan status sinkronisasi gagal, lalu pilih Edit.

  5. Perluas Konfigurasi lanjutan, lalu perluas Pengaturan grup.

  6. 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.

  7. 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 khusus 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://atauhttps://)

  • 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 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_Configuration 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.

Saya melihat 'File konfigurasi hilang AWS_REGION '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 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 tersebut.

  2. Di panel navigasi, pilih gateway Edge.

  3. Pilih Siemens Industrial Edge gateway untuk diedit.

  4. Di bagian kemampuan Edge, pilih versi perangkat lunak Lihat.

  5. Pilih versi terbaru penerbit IoT di bawah menu SiteWise tarik-turun Penerbit.

  6. 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 dalam alur Node-merah 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 .

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 di Panduan Pengembang.AWS IoT Greengrass