Prosesor IoT SiteWise - AWS IoT Greengrass

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

Prosesor IoT SiteWise

Komponen SiteWise prosesor IoT (aws.iot.SiteWiseEdgeProcessor) memungkinkan AWS IoT SiteWise gateway untuk memproses data di tepi.

Dengan komponen ini, AWS IoT SiteWise gateway dapat menggunakan model aset dan aset untuk memproses data pada perangkat gateway. Untuk informasi selengkapnya tentang AWS IoT SiteWise gateway, lihat Menggunakan AWS IoT SiteWise di tepi di AWS IoT SiteWise Panduan Pengguna.

Versi

Komponen ini memiliki versi berikut:

  • 3.3.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipe

Komponen ini adalah komponen generik (aws.greengrass.generic). Inti Greengrass menjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

  • Perangkat inti Greengrass harus berjalan di salah satu platform berikut:

    • OS: Ubuntu 20.04 atau 18.04

      Arsitektur: x86_64 () AMD64

    • OS: Perusahaan Red Hat Linux (RHEL) 8

      Arsitektur: x86_64 () AMD64

    • OS: Amazon Linux 2

      Arsitektur: x86_64 () AMD64

    • OS: Windows Server 2019 atau yang lebih baru

      Arsitektur: x86_64 () AMD64

  • Perangkat inti Greengrass harus memungkinkan lalu lintas masuk di port 443.

  • Perangkat inti Greengrass harus memungkinkan lalu lintas keluar di port 443 dan 8883.

  • Port berikut dicadangkan untuk digunakan oleh AWS IoT SiteWise: 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080, dan 50010. Menggunakan port cadangan untuk lalu lintas dapat mengakibatkan koneksi terputus.

    catatan

    Port 8087 hanya diperlukan untuk versi 2.0.15 dan yang lebih baru dari komponen ini.

  • Peran perangkat Greengrass harus memiliki izin yang memungkinkan Anda menggunakan gateway di perangkat Anda. AWS IoT SiteWise AWS IoT Greengrass V2 Untuk informasi selengkapnya, lihat Persyaratan dalam Panduan AWS IoT SiteWise Pengguna.

Titik akhir dan port

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Titik Akhir Port Wajib Deskripsi

model.iotsitewise.region.amazonaws.com

443 Ya

Dapatkan informasi tentang AWS IoT SiteWise aset dan model aset Anda.

edge.iotsitewise.region.amazonaws.com

443 Ya

Dapatkan informasi tentang konfigurasi AWS IoT SiteWise gateway perangkat inti.

ecr.region.amazonaws.com

443 Ya

Unduh gambar AWS IoT SiteWise Edge gateway Docker dari Amazon Elastic Container Registry.

iot.region.amazonaws.com

443 Ya

Dapatkan titik akhir perangkat untuk Anda Akun AWS.

sts.region.amazonaws.com

443 Ya

Dapatkan ID Anda Akun AWS.

monitor.iotsitewise.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mengakses AWS IoT SiteWise Monitor portal pada perangkat inti.

Dependensi

Saat Anda menerapkan komponen, gunakan AWS IoT Greengrass juga versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

Tabel berikut mencantumkan dependensi untuk versi 2.0.x hingga 2.1.x komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Layanan pertukaran Token >=2.0.3 <3.0.0 Keras
Manajer pengaliran >=2.0.10 <3.0.0 Keras
Greengrass CLI >=2.3.0 <3.0.0 Keras

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini tidak memiliki parameter konfigurasi apapun.

File log lokal

Komponen ini menggunakan file log berikut.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
Untuk melihat log komponen ini
  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait

Lisensi

Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut:

  • Apache-2.0

  • MIT

  • BSD-2-Klausul

  • BSD-3-Klausul

  • CDDL-1,0

  • CDDL-1.1

  • ISC

  • Zlib

  • GPL-3.0-dengan- -pengecualian GCC

  • Domain Publik

  • Python-2.0

  • Unicode- -2015 DFS

  • BSD-1-Klausul

  • Buka SSL

  • EPL-1,0

  • EPL-2.0

  • GPL-2.0- with-classpath-exception

  • MPL-2.0

  • CC0-1.0

  • JSON

Komponen ini dirilis menurut Perjanjian Lisensi Perangkat Lunak Greengrass Core.

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

3.3.1

Fitur baru
  • Menambahkan CORS dukungan opsional ke SiteWise EdgeAPIs, meningkatkan kemampuan berbagi sumber daya lintas asal. Fitur ini meningkatkan fleksibilitas untuk aplikasi web yang berinteraksi dengan. APIs

3.3.0

Peningkatan kinerja
  • Mekanisme penyegaran cache yang dioptimalkan untuk mengurangi penggunaan I/O antara sinkronisasi AWS IoT SiteWise aset dengan hanya menyegarkan entri untuk aset baru atau yang diperbarui.

  • Mengurangi jejak memori untuk mempertahankan cache dengan sejumlah besar properti aset yang disinkronkan.

Perbaikan bug dan peningkatan
  • Log yang ditekan untuk menelan nilai properti individu ketika tidak ada kesalahan konsumsi, yang mengurangi kebisingan log selama tingkat konsumsi yang tinggi.

  • Peningkatan keterbacaan log dengan menggunakan pemformatan yang dapat dibaca manusia untuk entri log tertentu.

  • Menambahkan dukungan untuk Java 17 dan lebih tinggi.

3.2.1

Perbaikan bug dan peningkatan
  • Perbaiki masalah di mana AWS IoT SiteWise API panggilan tidak melakukan paginasi secara sinkron dengan SiteWise Edge.

  • Perbaiki masalah untuk tidak mempublikasikan MessageRemaining.SiteWise_Edge_Stream metrik lagi.

  • Menambahkan CloudWatch metrik berikut untuk memantau koneksi dengan MQTT broker.

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

    Untuk informasi selengkapnya tentang metrik ini, lihat metrik AWS IoT Greengrass Version 2 gateway.

3.2.0

Peningkatan kinerja
  • Optimalkan API layanan untuk memiliki jejak memori yang lebih kecil dan membutuhkan lebih sedikit ruang disk untuk menginstal

    • Ini memberikan pengurangan 2 GB dalam penggunaan memori awal (sekarang menggunakan 7,5 GB memori saat startup, namun 16 GB masih disarankan) dan pengurangan ukuran unduhan 500 MB (sekarang memerlukan unduhan 1,4 GB) untuk seluruh komponen.

Fitur baru
  • GetAssetPropertyValueAggregatesAPIsekarang mendukung jendela agregasi 15 menit di tepi.

  • Port 8081 dan 8082 tidak perlu lagi tersedia agar komponen ini berjalan dengan benar.

    catatan

    Titik akhir lokal untuk bidang AWS IoT SiteWise dataAPIs, sepertiget-asset-property-value, sedang diubah dari http://localhost:8081 kehttp://localhost:11080/data. Titik akhir lokal untuk bidang AWS IoT SiteWise kontrolAPIs, sepertilist-asset-models, sedang diubah dari http://localhost:11080 kehttp://localhost:11080/control. AWS selalu merekomendasikan agar Anda menggunakan HTTPS titik SiteWise akhir gateway Edge. Titik akhir tersebut tidak berubah.

Perbaikan bug dan peningkatan
  • Sinkronisasi dari sekarang AWS IoT SiteWise akan mentransisikan sumber daya ke status valid jika sinkronisasi sebelumnya terputus. Ini akan memperbaiki masalah dengan beberapa sumber daya yang rusak setelah restart paksa.

  • Memperbaiki kondisi langka di mana sumber daya dapat rusak di tepi jika dimodifikasi selama sinkronisasi. Sinkronisasi sekarang akan gagal jika kondisi ini terdeteksi, dan sumber daya akan dicoba lagi pada sinkronisasi berikutnya.

  • Memperbaiki masalah yang memungkinkan HTTP titik akhir dipanggil APIs secara eksternal. Hanya HTTPS dapat digunakan untuk menelepon APIs di luar alamat loopback lokal sekarang.

  • ListAssetsAPIsekarang menunjukkan hierarki aset untuk aset yang disimpan di tepi.

  • Memperbaiki masalah saat Paket Pemrosesan Data gagal memulai ulang, meningkatkan, atau menurunkan versi pada Windows.

  • Memperbaiki bug dalam Paket Pemrosesan Data untuk OS Windows yang mencegah pelanggan menggunakan kredensi untuk terhubung dengan Broker. MQTT

3.1.3

Perbaikan bug dan peningkatan
  • Perbaiki masalah di mana Paket Pemrosesan Data salah melaporkan sinkronisasi yang berhasil ketika beberapa sumber daya benar-benar gagal.

  • Izinkan beberapa aset memiliki nama yang sama selama mereka tidak memiliki induk yang sama.

3.1.1

Perbaikan bug dan peningkatan
  • Perbaiki masalah di mana permintaan SigV4 gagal karena ketidakcocokan zona waktu.

  • Perbaiki masalah di mana properti transformasi dan metrik berhenti menghitung ketika mereka mengandalkan atribut setelah memulai ulang.

  • Aktifkan dukungan konfigurasi Port Stream Manager kustom.

  • Perbaiki masalah di mana properti yang disinkronkan ke tepi mungkin berhenti diperbarui.

3.1.0

Perbaikan bug dan peningkatan
  • Perbaiki masalah saat ListAssetModels API gagal menghasilkan token berikutnya.

3.0.0

Fitur baru
  • Memungkinkan dukungan konsumsi data dari broker. MQTT

2.2.1

Perbaikan bug dan peningkatan
  • Sesuaikan proses sinkronisasi untuk membuat penyimpanan data bidang kontrol lebih konsisten dengan cara cloud beroperasi. Ini sedikit berdampak pada peningkatan.

    catatan

    Data bidang kontrol yang disinkronkan pada versi 2.2.1 atau lebih tinggi tidak akan kompatibel dengan versi sebelumnya. Untuk menurunkan versi ke versi sebelumnya, Anda harus menyelesaikan instalasi baru. Ini tidak memengaruhi peningkatan, data yang disinkronkan pada versi sebelumnya akan berfungsi dengan versi 2.2.1.

  • Modifikasi tambahan pada rantai AWS kredensional untuk memprioritaskan AWS IoT Greengrass V2 kredensional.

2.1.37

Perbaikan bug dan peningkatan
  • Menghentikan dependency-routing-service proses dan memindahkan fungsionalitasnya ke dalam property-state-service proses untuk mengurangi penggunaan sumber daya dari proses komunikasi.

  • Tingkatkan batas hasil maksimum get-asset-property-value-history API hingga 20.000 agar sesuai dengan batas yang digunakan oleh AWS IoT SiteWise.

  • Perbaiki masalah di mana token berikutnya tidak disediakan dalam hasil paginasi get-asset-property-value-history API saat tidak ada batas hasil maksimal yang ditentukan.

2.1.35

Perbaikan bug dan peningkatan
  • Memodifikasi rantai AWS kredensil untuk memprioritaskan kredensil. AWS IoT Greengrass

  • Memperbaiki masalah dengan deteksi akun saat menerapkan sebagai bagian dari grup AWS IoT Thing.

2.1.34

Perbaikan bug dan peningkatan
  • Menyesuaikan perhitungan metrik/transformasi untuk menggunakan multi-threading di Linux. Windows terus menjalankan perhitungan single-threaded untuk kompatibilitas.

  • Memperbaiki masalah di mana perhitungan metrik akan hilang untuk beberapa jendela komputasi.

2.1.33

Perbaikan bug dan peningkatan
  • Memperbaiki masalah dengan pelaporan status kesalahan ke konsol Greengrass.

2.1.32

Perbaikan bug dan peningkatan
  • Menambahkan dukungan untuk nama pengguna dan grup yang disesuaikan.

2.1.31

Perbaikan bug dan peningkatan
  • Menambahkan dukungan untuk menghitung rata-rata tertimbang waktu dan standar deviasi tertimbang waktu untuk data yang dimodelkan. AWS IoT SiteWise

2.1.29

Perbaikan bug dan peningkatan
  • Menambahkan dukungan untuk memfilter aset pada fungsionalitas edge.

2.1.28

Perbaikan bug dan peningkatan
  • Mengoptimalkan sinkronisasi sumber daya untuk memungkinkan sejumlah besar aset disinkronkan dari tepi AWS Cloud ke tepi.

2.1.24

Perbaikan bug dan peningkatan
  • Memperbaiki masalah yang menyebabkan dasbor menghilang saat menyinkronkan sumber daya untuk kedua kalinya.

2.1.23

Perbaikan bug dan peningkatan
  • Menambahkan batas waktu untuk proses aws.iot.SiteWiseEdgeProcessor instalasi untuk menghindari kegagalan instalasi jika konektivitas internet lambat.

  • Sinkronisasi sumber daya yang dioptimalkan untuk meningkatkan efisiensi sinkronisasi antara cloud dan edge.

2.1.21

Awas

Upgrade dari 2.0.x ke 2.1.x akan mengakibatkan hilangnya data lokal.

Fitur baru
  • Menambahkan dukungan untuk Windows Server 2019 atau lebih tinggi.

  • Menghapus docker untuk sistem operasi berbasis Linux.

2.0.16

Versi ini berisi perbaikan bug dan perbaikan.

2.0.15

Perbaikan bug dan peningkatan
  • Mengubah port yang digunakan komponen ini untuk API operasi sinkronisasi sumber daya dari 8085 ke 8087. Akibatnya, komponen ini sekarang membutuhkan port 8087 untuk tersedia. Komponen ini masih membutuhkan port 8085 untuk tersedia.

  • Memperbarui AWS OpsHub otentikasi untuk menolak pengguna yang tidak sah selama login, bukan saat pengguna mencoba memanggil API operasi.

2.0.14

Versi ini berisi perbaikan bug dan perbaikan.

2.0.13

Perbaikan bug dan peningkatan
  • Memperbaiki masalah sehingga ketika komponen ini melaporkan data ke CloudWatch metrik Amazon, sekarang dengan benar menunjukkan data mana yang tidak dimodelkan.

2.0.9

Perbaikan bug dan peningkatan
  • Meningkatkan keandalan untuk membuat dan memperbarui AWS IoT SiteWise sumber daya pada perangkat inti.

  • Menambahkan API operasi lokal tambahan yang dapat Anda gunakan untuk memantau komponen mana yang diinstal pada perangkat inti, versi setiap komponen, dan status setiap komponen. Anda dapat melihat informasi ini di tab Pengaturan di AWS IoT SiteWise aplikasi AWS OpsHub for pada perangkat inti.

  • Menambahkan status kesehatan untuk kontainer Docker yang dijalankan komponen ini. Anda dapat menjalankan docker ps perintah untuk melihat status kesehatan kontainer.

2.0.7

Perbaikan bug dan peningkatan
  • Memperbaiki dukungan untuk melihat AWS IoT SiteWise Monitor portal pada perangkat inti.

2.0.6

Perbaikan bug dan peningkatan
  • Memperbaiki AWS IoT SiteWise statetime(),earliest(), dan latest() fungsi yang dihitung komponen ini pada perangkat inti.

2.0.5

Perbaikan bug dan peningkatan
  • Menambahkan dukungan untuk AWS IoT SiteWise pretrigger() fungsi dalam transformasi yang dihitung komponen ini pada perangkat inti.

  • Mengubah jalur tempat komponen ini menyimpan konfigurasi Lightweight Directory Access Protocol (LDAP) untuk otentikasi.

2.0.2

Versi awal.

Lihat juga