Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Komponen yang disediakan oleh AWS AWS IoT Greengrass menyediakan dan memelihara komponen bawaan yang dapat Anda terapkan ke perangkat Anda. Komponen ini mencakup fitur (seperti manajer aliran), konektor AWS IoT Greengrass V1 (seperti CloudWatch metrik), dan alat pengembangan lokal (seperti CLI AWS IoT Greengrass ). [Anda dapat [menerapkan komponen ini](manage-deployments.md) ke perangkat Anda untuk fungsionalitas mandiri mereka, atau Anda dapat menggunakannya sebagai dependensi dalam komponen Greengrass kustom Anda.](develop-greengrass-components.md) **catatan** Beberapa komponen AWS yang disediakan bergantung pada versi minor spesifik dari inti Greengrass. Karena ketergantungan ini, Anda perlu memperbarui komponen ini saat memperbarui inti Greengrass ke versi minor baru. Untuk informasi tentang versi spesifik dari inti yang masing-masing komponen bergantung padanya, lihat topik komponen yang sesuai. Untuk informasi selengkapnya terkait cara memperbarui inti, lihat [Perbarui perangkat lunak AWS IoT Greengrass Core (OTA)](update-greengrass-core-v2.md). Ketika komponen memiliki tipe komponen generik dan Lambda, versi komponen saat ini adalah tipe generik dan versi komponen sebelumnya adalah tipe Lambda. | Komponen | Deskripsi | [Jenis komponen](develop-greengrass-components.md#component-types) | Sistem operasi yang didukung | [Sumber terbuka](open-source.md) | Dukungan Nucleus lite | | --- | --- | --- | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | Inti dari perangkat lunak AWS IoT Greengrass Inti. Gunakan komponen ini untuk mengonfigurasi dan memperbarui perangkat lunak pada perangkat inti Anda. | Inti | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-nucleus) | Tidak | | [Greengrass nucleus lite](greengrass-nucleus-lite-component.md) | Inti ringan untuk perangkat terbatas sumber daya yang dioptimalkan untuk perangkat berbiaya rendah, edge, dan aplikasi volume tinggi | NucleusLite | Linux | [Ya](https://github.com/aws-greengrass/aws-greengrass-lite) | Tidak | | [Auth perangkat klien](client-device-auth-component.md) | Memungkinkan perangkat IoT lokal, yang disebut perangkat klien, untuk terhubung ke perangkat inti. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-client-device-auth) | Tidak | | [CloudWatch metrik](cloudwatch-metrics-component.md) | Menerbitkan metrik khusus ke Amazon. CloudWatch | Generik, Lambda | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-cloudwatch-metrics) | Ya | | [AWS IoT Device Defender](device-defender-component.md) | Memberitahu administrator tentang perubahan pada keadaan perangkat inti Greengrass untuk mengidentifikasi perilaku yang tidak biasa. | Generik, Lambda | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-device-defender) | Tidak | | [Spooler disk](disk-spooler-component.md) | Mengaktifkan opsi penyimpanan persisten untuk pesan yang di-spooled dari perangkat inti Greengrass ke. AWS IoT Core Komponen ini akan menyimpan pesan keluar ini pada disk. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-disk-spooler) | Tidak | | [Manajer aplikasi Docker](docker-application-manager-component.md) | Memungkinkan AWS IoT Greengrass untuk mengunduh gambar Docker dari Docker Hub dan Amazon Elastic Container Registry (Amazon ECR). | Generik | Linux, Windows | Tidak | Built-in | | [Konektor tepi untuk Kinesis Video Streams](kvs-edge-connector-component.md) | Membaca umpan video dari kamera lokal, menerbitkan aliran ke Kinesis Video Streams, dan menampilkan aliran di dasbor Grafana. AWS IoT TwinMaker | Generik | Linux | Tidak | Tidak | | [Greengrass CLI](greengrass-cli-component.md) | Menyediakan antarmuka baris perintah yang dapat Anda gunakan untuk membuat deployment lokal dan berinteraksi dengan perangkat inti Greengrass dan komponennya. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-cli) | [Tidak](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/ggl-cli.md) | | [Detektor IP](ip-detector-component.md) | Melaporkan informasi konektivitas broker MQTT ke AWS IoT Greengrass, sehingga perangkat klien dapat menemukan cara terhubung. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-ip-detector) | Tidak | | [Firehouse](kinesis-firehose-component.md) | Menerbitkan data melalui aliran pengiriman Amazon Data Firehose ke tujuan di. AWS Cloud | Lambda | Linux | Tidak | Tidak | | [Peluncur Lambda](lambda-launcher-component.md) | Menangani proses dan konfigurasi lingkungan untuk fungsi Lambda. | Generik | Linux | Tidak | Tidak | | [Manajer Lambda](lambda-manager-component.md) | Menangani komunikasi antar proses dan penskalaan untuk fungsi Lambda. | Plugin | Linux | Tidak | Tidak | | [Runtime Lambda](lambda-runtimes-component.md) | Memberikan artefak untuk setiap waktu aktif Lambda. | Generik | Linux | Tidak | Tidak | | [Router langganan warisan](legacy-subscription-router-component.md) | Mengelola langganan untuk fungsi Lambda yang berjalan AWS IoT Greengrass di V1. | Generik | Linux | Tidak | Tidak | | [Konsol debug lokal](local-debug-console-component.md) | Menyediakan konsol lokal yang dapat Anda gunakan untuk debug dan mengelola perangkat inti Greengrass dan komponennya. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-localdebugconsole) | Tidak | | [Manajer log](log-manager-component.md) | Mengumpulkan dan mengunggah log pada perangkat inti Greengrass. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-log-manager) | Tidak | | [Komponen machine learning](machine-learning-components.md) | Menyediakan model machine learning dan contoh kode inferensi yang dapat Anda gunakan untuk melakukan inferensi machine learning pada perangkat inti Greengrass. | Lihat [Komponen machine learning](machine-learning-components.md). | Tidak | | [Adaptor protokol Modbus-RTU](modbus-rtu-protocol-adapter-component.md) | Mengumpulkan informasi dari perangkat Modbus RTU lokal. | Lambda | Linux | Tidak | Tidak | | [Pemancar telemetri nukleus](nucleus-emitter-component.md) | Menerbitkan data telemetri kesehatan sistem yang dikumpulkan dari inti ke topik lokal atau ke topik MQTT. AWS IoT Core | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-telemetry-nucleus-emitter) | Tidak | | [Jembatan MQTT](mqtt-bridge-component.md) | Relay pesan MQTT antara perangkat klien, penerbitan/berlangganan lokal AWS IoT Greengrass , dan. AWS IoT Core | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-mqtt-bridge) | Tidak | | [MQTT 3.1.1 broker (Moquette)](mqtt-broker-moquette-component.md) | Menjalankan broker MQTT 3.1.1 yang menangani pesan antara perangkat klien dan perangkat inti. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-moquette-mqtt) | Tidak | | [Pialang MQTT 5 (EMQX)](mqtt-broker-emqx-component.md) | Menjalankan broker MQTT 5 yang menangani pesan antara perangkat klien dan perangkat inti. | Generik | Linux, Windows | Tidak | Tidak | | [Penyedia PKCS \$111](pkcs11-provider-component.md) | Mengaktifkan komponen Greengrass untuk mengakses kunci pribadi dan sertifikat yang Anda simpan dengan aman di modul keamanan perangkat keras (HSM). | Plugin | Linux | [Ya](https://github.com/aws-greengrass/aws-greengrass-pkcs11-provider) | Built-in | | [Secrets manager](secret-manager-component.md) | Menyebarkan rahasia dari AWS Secrets Manager rahasia sehingga Anda dapat menggunakan kredensil dengan aman, seperti kata sandi, dalam komponen khusus pada perangkat inti Greengrass. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-secret-manager) | Tidak | | [Tunneling yang aman](secure-tunneling-component.md) | Mengaktifkan koneksi tunneling AWS IoT aman yang dapat Anda gunakan untuk membuat komunikasi bidrectional dengan perangkat inti Greengrass yang berada di belakang firewall terbatas. | Generik | Linux | Tidak | Ya | | [Pengelola bayangan](shadow-manager-component.md) | Memungkinkan interaksi dengan bayangan pada perangkat inti. Ini mengelola penyimpanan dokumen bayangan dan juga sinkronisasi status bayangan lokal dengan layanan AWS IoT Device Shadow. | Plugin | Linux, Windows | [Ya](https://github.com/aws-greengrass/aws-greengrass-shadow-manager) | Tidak | | [Amazon SNS](sns-component.md) | Menerbitkan pesan ke topik Amazon SNS. | Lambda | Linux | Tidak | Tidak | | [Manajer pengaliran](stream-manager-component.md) | Streaming data bervolume tinggi dari sumber lokal ke AWS Cloud. | Generik | Linux, Windows | Tidak | Ya | | [Forwarder log sistem](system-log-forwarder-component.md) | Unggah log systemd-journald ke file. AWS Cloud | Generik | Linux | [Ya](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) | Ya | | [Agen Systems Manager](systems-manager-agent-component.md) | Kelola perangkat inti dengan AWS Systems Manager, yang memungkinkan Anda untuk menambal perangkat, menjalankan perintah, dan banyak lagi. | Generik | Linux | [Ya](https://github.com/aws/amazon-ssm-agent/blob/mainline/packaging/greengrass/component.json) | Tidak | | [Layanan pertukaran token](token-exchange-service-component.md) | Memberikan AWS kredensi yang dapat Anda gunakan untuk berinteraksi dengan AWS layanan. | Generik | Linux, Windows | Tidak | Built-in | | [Kolektor IoT SiteWise OPC UA](iotsitewise-opcua-collector-component.md) | Mengumpulkan data dari server OPC-UA. | Generik | Linux, Windows | Tidak | Tidak | | [Simulator sumber data IoT SiteWise OPC UA](iotsitewise-opcua-data-source-simulator-component.md) | Menjalankan server OPC-UA lokal yang menghasilkan data sampel. | Generik | Linux, Windows | Tidak | Tidak | | [Penerbit IoT SiteWise](iotsitewise-publisher-component.md) | Mempublikasikan data ke AWS Cloud. | Generik | Linux, Windows | Tidak | Tidak | | [Prosesor IoT SiteWise](iotsitewise-processor-component.md) | Memproses data pada perangkat inti Greengrass. | Generik | Linux, Windows | Tidak | Tidak | # Inti Greengrass Komponen inti Greengrass `aws.greengrass.Nucleus` () adalah komponen wajib dan persyaratan minimum untuk menjalankan perangkat lunak Core AWS IoT Greengrass pada perangkat. Anda dapat mengonfigurasi komponen ini untuk menyesuaikan dan memperbarui perangkat lunak AWS IoT Greengrass Core Anda dari jarak jauh. Terapkan komponen ini untuk mengonfigurasi pengaturan seperti proxy, peran perangkat, dan konfigurasi AWS IoT benda pada perangkat inti Anda. **catatan** Mulai Greengrass versi 2.14.0, versi runtime perangkat nukleus yang dioptimalkan jejak memori tersedia untuk perangkat edge yang dibatasi. Lihat [Greengrass nucleus](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) lite untuk informasi lebih lanjut tentang konfigurasi dan penggunaannya. **penting** Saat versi komponen nukleus berubah, atau saat Anda mengubah parameter konfigurasi tertentu, perangkat lunak AWS IoT Greengrass Inti—yang menyertakan inti dan semua komponen lain di perangkat Anda—akan dimulai ulang untuk menerapkan perubahan. Saat Anda menerapkan komponen, AWS IoT Greengrass instal versi terbaru yang didukung dari semua dependensi komponen tersebut. Karena itu, versi patch baru dari komponen publik AWS yang disediakan mungkin secara otomatis diterapkan ke perangkat inti Anda jika Anda menambahkan perangkat baru ke grup sesuatu, atau Anda memperbarui penerapan yang menargetkan perangkat tersebut. Beberapa pembaruan otomatis, seperti pembaruan inti, dapat menyebabkan perangkat Anda memulai ulang secara tiba-tiba. Untuk mencegah pembaruan yang tidak diinginkan untuk komponen yang berjalan di perangkat Anda, sebaiknya sertakan versi komponen yang Anda inginkan secara langsung saat [membuat deployment](create-deployments.md). Untuk informasi selengkapnya tentang perilaku pembaruan untuk perangkat lunak AWS IoT Greengrass Core, lihat[Perbarui perangkat lunak AWS IoT Greengrass Core (OTA)](update-greengrass-core-v2.md). **Topics** + [Versi](#greengrass-nucleus-component-versions) + [Persyaratan perangkat](#greengrass-v2-requirements) + [Platform yang didukung](#greengrass-v2-supported-platforms) + [Sistem operasi](#greengrass-nucleus-component-os-support) + [Persyaratan](#greengrass-nucleus-component-requirements) + [Dependensi](#greengrass-nucleus-component-dependencies) + [Unduh dan instalasi](#greengrass-nucleus-component-install) + [Konfigurasi](#greengrass-nucleus-component-configuration) + [File log lokal](#greengrass-nucleus-component-log-file) + [Changelog](#greengrass-nucleus-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.17.x + 2.16.x + 2.15.x + 2.14.x + 2.13.x + 2.12.x + 2.11.x + 2.10.x + 2.9.x + 2.8.x + 2.7.x + 2.6.x + 2.5.x + 2.4.x + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Persyaratan perangkat **catatan** Anda dapat menggunakannya AWS IoT Device Tester AWS IoT Greengrass untuk memverifikasi bahwa perangkat Anda dapat menjalankan perangkat lunak AWS IoT Greengrass Core dan berkomunikasi dengan perangkat lunak AWS Cloud. Untuk informasi selengkapnya, lihat [Menggunakan AWS IoT Device Tester untuk AWS IoT Greengrass V2](device-tester-for-greengrass-ug.md). ------ #### [ Linux ] + Penggunaan sebuah [Wilayah AWS](https://en.wikipedia.org/wiki/Amazon_Web_Services#Availability_and_topology)yang mendukung AWS IoT Greengrass V2. Untuk daftar Wilayah yang didukung, lihat [AWS IoT Greengrass V2 titik akhir dan kuota](https://docs.aws.amazon.com/general/latest/gr/greengrassv2.html) di. *Referensi Umum AWS* + Ruang disk minimal 256 MB tersedia untuk perangkat lunak AWS IoT Greengrass Core. Persyaratan ini tidak termasuk komponen yang di-deploy ke perangkat inti. + Minimum 96 MB RAM dialokasikan untuk perangkat lunak AWS IoT Greengrass Core. Persyaratan ini tidak termasuk komponen yang berjalan pada perangkat inti. Untuk informasi selengkapnya, lihat [Kontrol alokasi memori dengan opsi JVM](configure-greengrass-core-v2.md#jvm-tuning). + Java Runtime Environment (JRE) versi 8 atau lebih tinggi. Java harus tersedia pada variabel lingkungan [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) pada perangkat. Untuk menggunakan Java untuk mengembangkan komponen kustom, Anda harus menginstal Java Development Kit (JDK). Kami menyarankan Anda menggunakan versi dukungan jangka panjang [Amazon Corretto](https://aws.amazon.com/corretto/) [atau](https://openjdk.java.net/) OpenJDK. Versi 8 atau lebih tinggi diperlukan. + [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.25 atau lebih besar. + Anda dapat menjalankan perangkat lunak AWS IoT Greengrass Core sebagai pengguna root. Gunakan `sudo`, misalnya. Anda juga dapat menjalankan perangkat lunak AWS IoT Greengrass Core sebagai pengguna non-root. Untuk informasi selengkapnya, lihat [Siapkan perangkat AWS IoT Greengrass V2 inti sebagai non-root](setup-greengrass-non-root.md). + Pengguna root yang menjalankan perangkat lunak AWS IoT Greengrass Core, seperti`root`, harus memiliki izin untuk menjalankan `sudo` dengan pengguna dan grup apa pun. File `/etc/sudoers` harus memberikan izin kepada pengguna ini untuk menjalankan `sudo` sebagai grup lain. Izin untuk pengguna di `/etc/sudoers` seharusnya terlihat seperti contoh berikut. ``` root ALL=(ALL:ALL) ALL ``` + Perangkat inti harus dapat melakukan permintaan keluar ke satu set titik akhir dan port. Untuk informasi selengkapnya, lihat [Izinkan lalu lintas perangkat melalui proxy atau firewall](allow-device-traffic.md). + Direktori `/tmp` harus dipasang dengan izin `exec`. + Semua perintah shell berikut: + `ps -ax -o pid,ppid` + `sudo` + `sh` + `kill` + `cp` + `chmod` + `rm` + `ln` + `echo` + `exit` + `id` + `uname` + `grep` + Perangkat Anda mungkin juga memerlukan perintah shell opsional berikut: + (Opsional)`systemctl`. Perintah ini digunakan untuk mengatur perangkat lunak AWS IoT Greengrass Core sebagai layanan sistem. + (Opsional)`useradd`,`groupadd`, dan`usermod`. Perintah ini digunakan untuk mengatur pengguna `ggc_user` sistem dan grup `ggc_group` sistem. + (Opsional)`mkfifo`. Perintah ini digunakan untuk menjalankan fungsi Lambda sebagai komponen. + Untuk mengonfigurasi batas sumber daya sistem untuk proses komponen, perangkat Anda harus menjalankan kernel Linux versi 2.6.24 atau yang lebih baru. + Untuk menjalankan fungsi Lambda, perangkat Anda harus memenuhi persyaratan tambahan. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). ------ #### [ Windows ] + Penggunaan sebuah [Wilayah AWS](https://en.wikipedia.org/wiki/Amazon_Web_Services#Availability_and_topology)yang mendukung AWS IoT Greengrass V2. Untuk daftar Wilayah yang didukung, lihat [AWS IoT Greengrass V2 titik akhir dan kuota](https://docs.aws.amazon.com/general/latest/gr/greengrassv2.html) di. *Referensi Umum AWS* + Ruang disk minimal 256 MB tersedia untuk perangkat lunak AWS IoT Greengrass Core. Persyaratan ini tidak termasuk komponen yang di-deploy ke perangkat inti. + Minimum 160 MB RAM dialokasikan untuk perangkat lunak AWS IoT Greengrass Core. Persyaratan ini tidak termasuk komponen yang berjalan pada perangkat inti. Untuk informasi selengkapnya, lihat [Kontrol alokasi memori dengan opsi JVM](configure-greengrass-core-v2.md#jvm-tuning). + Java Runtime Environment (JRE) versi 8 atau lebih tinggi. Java harus tersedia pada variabel sistem [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) pada perangkat. Untuk menggunakan Java untuk mengembangkan komponen kustom, Anda harus menginstal Java Development Kit (JDK). Kami menyarankan Anda menggunakan versi dukungan jangka panjang [Amazon Corretto](https://aws.amazon.com/corretto/) [atau](https://openjdk.java.net/) OpenJDK. Versi 8 atau lebih tinggi diperlukan.. **catatan** Untuk menggunakan versi 2.5.0 dari inti [Greengrass, Anda harus menggunakan Java Runtime](#greengrass-nucleus-component) Environment (JRE) versi 64-bit. Greengrass nucleus versi 2.5.1 mendukung 32-bit dan 64-bit. JREs + Pengguna yang menginstal perangkat lunak AWS IoT Greengrass Core harus menjadi administrator. + Anda harus menginstal perangkat lunak AWS IoT Greengrass Core sebagai layanan sistem. Tentukan `--setup-system-service true` kapan Anda menginstal perangkat lunak. + Setiap pengguna yang menjalankan proses komponen harus ada di LocalSystem akun, dan nama dan kata sandi pengguna harus ada di instance Credential Manager untuk LocalSystem akun tersebut. Anda dapat mengatur pengguna ini ketika Anda mengikuti petunjuk untuk [menginstal perangkat lunak AWS IoT Greengrass Core](install-greengrass-core-v2.md). + Perangkat inti harus dapat melakukan permintaan keluar ke satu set titik akhir dan port. Untuk informasi selengkapnya, lihat [Izinkan lalu lintas perangkat melalui proxy atau firewall](allow-device-traffic.md). ------ ## Platform yang didukung AWS IoT Greengrass secara resmi mendukung perangkat yang menjalankan platform berikut. Perangkat dengan platform yang tidak termasuk dalam daftar ini mungkin berfungsi, tetapi AWS IoT Greengrass pengujian hanya pada platform yang ditentukan ini. ------ #### [ Linux ] Arsitektur: + Armv7l + Armv8 () AArch64 + x86\$164 ------ #### [ Windows ] Arsitektur: + x86\$164 Versi: + Windows 10 + Windows 11 + Windows Server 2019 + Windows Server 2022 **catatan** Beberapa AWS IoT Greengrass fitur saat ini tidak didukung pada perangkat Windows. Untuk informasi selengkapnya, lihat [Kompatibilitas fitur Greengrass](operating-system-feature-support-matrix.md) dan [Pertimbangan fitur](#greengrass-v2-windows-feature-considerations). ------ ### Pertimbangan fitur Beberapa AWS IoT Greengrass fitur saat ini tidak didukung pada perangkat Windows. Tinjau perbedaan fitur untuk mengonfirmasi apakah perangkat Windows memenuhi kebutuhan Anda. Untuk informasi selengkapnya, lihat [Kompatibilitas fitur Greengrass](operating-system-feature-support-matrix.md). [Untuk membangun sistem operasi berbasis Linux kustom, Anda dapat menggunakan BitBake resep untuk AWS IoT Greengrass dalam proyek. `meta-aws`](https://github.com/aws/meta-aws/tree/master/recipes-iot) `meta-aws`Proyek ini menyediakan resep yang dapat Anda gunakan untuk membangun kemampuan perangkat lunak AWS edge dalam sistem [Linux tertanam](https://elinux.org/) yang dibangun dengan [OpenEmbedded](https://www.openembedded.org/wiki/Main_Page)dan kerangka kerja Yocto Project build. Proyek [Yocto adalah proyek](https://www.yoctoproject.org/) kolaborasi open source yang membantu Anda membangun sistem berbasis Linux khusus untuk aplikasi tertanam terlepas dari arsitektur perangkat keras. BitBake Resep untuk AWS IoT Greengrass menginstal, mengonfigurasi, dan secara otomatis menjalankan perangkat lunak AWS IoT Greengrass Core di perangkat Anda. Platform Linux juga dapat berjalan AWS IoT Greengrass dalam wadah Docker. Untuk informasi selengkapnya, lihat [Jalankan perangkat lunak AWS IoT Greengrass Core dalam wadah Docker](run-greengrass-docker.md). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows Untuk informasi selengkapnya, lihat [Platform yang didukung](#greengrass-v2-supported-platforms). ## Persyaratan Perangkat harus memenuhi persyaratan tertentu untuk menginstal dan menjalankan inti Greengrass dan perangkat lunak Core. AWS IoT Greengrass Untuk informasi selengkapnya, lihat [Persyaratan perangkat](#greengrass-v2-requirements). Komponen inti Greengrass didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan. + Komponen inti Greengrass harus memiliki konektivitas AWS IoT data ke, AWS IoT Credentials, dan Amazon S3. ## Dependensi Inti Greengrass tidak termasuk dependensi komponen apapun. Namun, beberapa komponen yang disediakan oleh AWS mencakup nukleus sebagai dependensi. Untuk informasi selengkapnya, lihat [Komponen yang disediakan oleh AWS](public-components.md). Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Unduh dan instalasi Anda dapat men-download installer yang mengatur komponen inti Greengrass pada perangkat Anda. Installer ini mengatur perangkat Anda sebagai perangkat inti Greengrass. Ada dua jenis instalasi yang dapat Anda lakukan: instalasi cepat yang menciptakan AWS sumber daya yang diperlukan untuk Anda, atau instalasi manual di mana Anda membuat AWS sumber daya sendiri. Untuk informasi selengkapnya, lihat [Instal perangkat lunak AWS IoT Greengrass Core](install-greengrass-core-v2.md). Anda juga dapat mengikuti tutorial untuk menginstal inti Greengrass dan mengeksplorasi pengembangan komponen Greengrass. Untuk informasi selengkapnya, lihat [Tutorial: Memulai dengan AWS IoT Greengrass V2](getting-started.md). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. Beberapa parameter mengharuskan perangkat lunak AWS IoT Greengrass Core restart untuk diterapkan. Untuk informasi selengkapnya tentang mengapa dan bagaimana komponen ini, lihat [Konfigurasikan perangkat lunak AWS IoT Greengrass Inti](configure-greengrass-core-v2.md). `iotRoleAlias` Alias AWS IoT peran yang menunjuk ke peran IAM pertukaran token. Penyedia AWS IoT kredensyal mengasumsikan peran ini untuk memungkinkan perangkat inti Greengrass berinteraksi dengan layanan. AWS Untuk informasi selengkapnya, lihat [Otorisasi perangkat inti untuk berinteraksi dengan layanan AWS](device-service-role.md). Ketika Anda menjalankan perangkat lunak AWS IoT Greengrass Core dengan `--provision true` opsi, perangkat lunak menyediakan alias peran dan menetapkan nilainya dalam komponen inti. `interpolateComponentConfiguration` [(Opsional) Anda dapat mengaktifkan inti Greengrass untuk [menginterpolasi variabel resep komponen dalam konfigurasi komponen dan menggabungkan pembaruan konfigurasi](component-recipe-reference.md#recipe-variables).](update-component-configurations.md#merge-configuration-update-recipe-variables) Kami menyarankan Anda mengatur opsi ini `true` agar perangkat inti dapat menjalankan komponen Greengrass yang menggunakan variabel resep dalam konfigurasinya. Fitur ini tersedia untuk v2.6.0 dan yang lebih baru dari komponen ini. Default: `false` `networkProxy` (Opsional) Proksi jaringan yang digunakan untuk semua koneksi. Untuk informasi selengkapnya, lihat [Hubungkan pada port 443 atau melalui proksi jaringan](configure-greengrass-core-v2.md#configure-alpn-network-proxy). Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan dimulai ulang agar perubahan diterapkan. Objek ini berisi informasi berikut: `noProxyAddresses` (Opsional) Daftar alamat IP atau nama host yang dipisahkan koma yang dikecualikan dari proxy. `proxy` Proksi yang akan dihubungkan. Objek ini berisi informasi berikut: `url` URL server proksi dalam format `scheme://userinfo@host:port`. + `scheme` — Skema, yang harus berupa `http` atau `https`. **penting** Perangkat inti Greengrass harus menjalankan [Greengrass](#greengrass-nucleus-component) nucleus v2.5.0 atau yang lebih baru untuk menggunakan proxy HTTPS. Jika Anda mengonfigurasi proxy HTTPS, Anda harus menambahkan sertifikat CA server proxy ke sertifikat CA root Amazon perangkat inti. Untuk informasi selengkapnya, lihat [Aktifkan perangkat inti untuk mempercayai proxy HTTPS](configure-greengrass-core-v2.md#https-proxy-certificate-trust). + `userinfo` - (Opsional) Nama pengguna dan informasi kata sandi. Jika Anda menentukan informasi ini di`url`, perangkat inti Greengrass mengabaikan bidang dan. `username` `password` + `host` - Nama host atau alamat IP server proksi. + `port` — (Opsional) Nomor port. Jika Anda tidak menentukan port, maka perangkat inti Greengrass akan menggunakan nilai default berikut: + `http` – 80 + `https` – 443 `username` (Opsional) Nama pengguna yang mengautentikasi server proxy. `password` (Opsional) Kata sandi yang mengautentikasi server proxy. `mqtt` (Opsional) Konfigurasi MQTT untuk perangkat inti Greengrass. Untuk informasi selengkapnya, lihat [Hubungkan pada port 443 atau melalui proksi jaringan](configure-greengrass-core-v2.md#configure-alpn-network-proxy). Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan dimulai ulang agar perubahan diterapkan. Objek ini berisi informasi berikut: `port` (Opsional) Port yang akan digunakan untuk koneksi MQTT. Default: `8883` `keepAliveTimeoutMs` (Opsional) Jumlah waktu dalam milidetik antara setiap pesan `PING` yang dikirim klien untuk menjaga sambungan MQTT hidup. Nilai ini harus lebih besar dari`pingTimeoutMs`. Default: `60000` (60 detik) `pingTimeoutMs` (Opsional) Jumlah waktu dalam milidetik yang klien tunggu untuk menerima pesan `PINGACK` dari server. Jika masa tunggu melebihi batas waktu, perangkat inti menutup dan membuka kembali sambungan MQTT. Nilai ini harus kurang dari`keepAliveTimeoutMs`. Default: `30000` (30 detik) `operationTimeoutMs` (Opsional) Jumlah waktu dalam milidetik yang klien menunggu operasi MQTT (seperti `CONNECT` atau) untuk diselesaikan. `PUBLISH` Opsi ini tidak berlaku untuk MQTT `PING` atau pesan tetap hidup. Default: `30000` (30 detik) `maxInFlightPublishes` (Opsional) Jumlah maksimum pesan MQTT QoS 1 yang tidak diakui yang dapat terbang pada waktu yang sama. Fitur ini tersedia untuk v2.1.0 dan versi kemudian dari komponen ini. Default: `5` Kisaran valid: Nilai maksimum 100 `maxMessageSizeInBytes` (Opsional) Ukuran maksimum pesan MQTT. Jika pesan melebihi ukuran ini, inti Greengrass menolak pesan dengan kesalahan. Fitur ini tersedia untuk v2.1.0 dan versi kemudian dari komponen ini. Default: `131072` (128 KB) Kisaran valid: Nilai maksimum `2621440` (2,5 MB) `maxPublishRetry` (Opsional) Jumlah waktu maksimum untuk mencoba kembali pesan yang gagal untuk dipublikasikan. Anda dapat menentukan `-1` untuk mencoba lagi dalam waktu tak terbatas. Fitur ini tersedia untuk v2.1.0 dan versi kemudian dari komponen ini. Default: `100` `spooler` (Opsional) Konfigurasi spooler MQTT untuk perangkat inti Greengrass. Objek ini berisi informasi berikut: `storageType` Jenis penyimpanan untuk menyimpan pesan. Jika `storageType` diatur ke`Disk`, `pluginName` dapat dikonfigurasi. Anda dapat menentukan `Memory` atau `Disk`. [Fitur ini tersedia untuk v2.11.0 dan yang lebih baru dari komponen inti Greengrass.](#greengrass-nucleus-component) Jika spooler MQTT `storageType` disetel ke `Disk` dan Anda ingin menurunkan versi inti Greengrass dari versi 2.11.x ke versi sebelumnya, Anda harus mengubah konfigurasi kembali ke. `Memory` Satu-satunya konfigurasi untuk `storageType` itu didukung di Greengrass nucleus versi 2.10.x dan sebelumnya adalah. `Memory` Tidak mengikuti panduan ini dapat mengakibatkan spooler rusak. Ini akan menyebabkan perangkat inti Greengrass Anda tidak dapat mengirim pesan MQTT ke. AWS Cloud Default: `Memory` `pluginName` (Opsional) Nama komponen plugin. Komponen ini hanya akan digunakan jika `storageType` diatur ke`Disk`. Opsi ini default ke `aws.greengrass.DiskSpooler` dan akan menggunakan GreenGrass yang disediakan. [Spooler disk](disk-spooler-component.md) [Fitur ini tersedia untuk v2.11.0 dan yang lebih baru dari komponen inti Greengrass.](#greengrass-nucleus-component) Default: `"aws.greengrass.DiskSpooler"` `maxSizeInBytes` (Opsional) Ukuran maksimum cache di mana perangkat inti menyimpan pesan MQTT yang belum diproses dalam memori. Jika cache penuh, pesan baru ditolak. Default: `2621440` (2,5 MB) `keepQos0WhenOffline` (Opsional) Anda dapat mengirim pesan MQTT QoS 0 yang diterima oleh perangkat inti ketika ia offline. Jika Anda menetapkan opsi ini ke `true`, perangkat inti akan mengirim pesan QoS 0 yang tidak dapat dikirimnya saat sedang offline. Jika Anda menetapkan opsi ini ke `false`, perangkat inti akan membuang pesan ini. Perangkat inti selalu mengirim pesan QoS 1 pesan kecuali spool penuh. Default: `false` `version` (Opsional) Versi MQTT. Anda dapat menentukan `mqtt3` atau `mqtt5`. [Fitur ini tersedia untuk v2.10.0 dan yang lebih baru dari komponen inti Greengrass.](#greengrass-nucleus-component) Default: `mqtt5` `receiveMaximum` (Opsional) Jumlah maksimum paket QoS1 yang tidak diakui yang dapat dikirim broker. [Fitur ini tersedia untuk v2.10.0 dan yang lebih baru dari komponen inti Greengrass.](#greengrass-nucleus-component) Default: `100` `sessionExpirySeconds` (Opsional) Jumlah waktu dalam hitungan detik yang dapat Anda minta agar sesi berlangsung dari IoT Core. Defaultnya adalah waktu maksimum yang didukung oleh AWS IoT Core. [Fitur ini tersedia untuk v2.10.0 dan yang lebih baru dari komponen inti Greengrass.](#greengrass-nucleus-component) Default: `604800 (7 days)` `minimumReconnectDelaySeconds` (Opsional) Opsi untuk perilaku rekoneksi. Jumlah minimum waktu dalam hitungan detik untuk MQTT untuk menyambung kembali. [Fitur ini tersedia untuk v2.10.0 dan yang lebih baru dari komponen inti Greengrass.](#greengrass-nucleus-component) Default: `1` `maximumReconnectDelaySeconds` (Opsional) Opsi untuk perilaku rekoneksi. Jumlah maksimum waktu dalam hitungan detik untuk MQTT untuk menyambung kembali. [Fitur ini tersedia untuk v2.10.0 dan yang lebih baru dari komponen inti Greengrass.](#greengrass-nucleus-component) Default: `120` `minimumConnectedTimeBeforeRetryResetSeconds` (Opsional) Opsi untuk perilaku rekoneksi. Jumlah waktu dalam hitungan detik koneksi harus aktif sebelum penundaan coba lagi diatur ulang kembali ke minimum. [Fitur ini tersedia untuk v2.10.0 dan yang lebih baru dari komponen inti Greengrass.](#greengrass-nucleus-component) Default: `30` `jvmOptions` (Opsional) Opsi JVM yang digunakan untuk menjalankan perangkat lunak AWS IoT Greengrass Core. Untuk informasi tentang opsi JVM yang direkomendasikan untuk menjalankan perangkat lunak AWS IoT Greengrass Core, lihat. [Kontrol alokasi memori dengan opsi JVM](configure-greengrass-core-v2.md#jvm-tuning) Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan dimulai ulang agar perubahan diterapkan. `iotDataEndpoint` Titik akhir AWS IoT data untuk Anda Akun AWS. Ketika Anda menjalankan perangkat lunak AWS IoT Greengrass Core dengan `--provision true` opsi, perangkat lunak mendapatkan data dan titik akhir kredensial Anda dari AWS IoT dan mengaturnya dalam komponen nukleus. `iotCredEndpoint` Titik akhir AWS IoT kredensial untuk Anda. Akun AWS Ketika Anda menjalankan perangkat lunak AWS IoT Greengrass Core dengan `--provision true` opsi, perangkat lunak mendapatkan data dan titik akhir kredensial Anda dari AWS IoT dan mengaturnya dalam komponen nukleus. `greengrassDataPlaneEndpoint` Fitur ini tersedia di v2.7.0 dan yang lebih baru dari komponen ini. Untuk informasi selengkapnya, lihat [Menggunakan sertifikat perangkat yang ditandatangani oleh CA pribadi](configure-greengrass-core-v2.md#configure-nucleus-private-ca). `greengrassDataPlanePort` Fitur ini tersedia di v2.0.4 dan yang lebih baru dari komponen ini. (Opsional) Port yang akan digunakan untuk koneksi bidang data. Untuk informasi selengkapnya, lihat [Hubungkan pada port 443 atau melalui proksi jaringan](configure-greengrass-core-v2.md#configure-alpn-network-proxy). Anda harus menentukan port di mana perangkat dapat membuat koneksi keluar. Jika Anda menentukan port yang diblokir, perangkat tidak akan dapat terhubung AWS IoT Greengrass untuk menerima penerapan. Pilih dari salah satu pilihan berikut: + `443` + `8443` Default: `8443` `awsRegion` Wilayah AWS Untuk digunakan. `runWithDefault` Pengguna sistem yang digunakan untuk menjalankan komponen. Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan dimulai ulang agar perubahan diterapkan. Objek ini berisi informasi berikut: `posixUser` Nama atau ID pengguna sistem dan, secara opsional, grup sistem yang digunakan perangkat inti untuk menjalankan komponen generik dan Lambda. Tentukan pengguna dan grup yang dipisahkan dengan titik dua (`:`) dalam format berikut: `user:group`. Grup ini opsional. Jika Anda tidak menentukan grup, perangkat lunak AWS IoT Greengrass Core menggunakan grup utama untuk pengguna. Misalnya, Anda dapat menentukan `ggc_user` atau `ggc_user:ggc_group`. Untuk informasi selengkapnya, lihat [Konfigurasikan pengguna yang menjalankan komponen](configure-greengrass-core-v2.md#configure-component-user). Saat Anda menjalankan penginstal perangkat lunak AWS IoT Greengrass Core dengan `--component-default-user ggc_user:ggc_group` opsi, perangkat lunak menetapkan parameter ini di komponen inti. `windowsUser` Fitur ini tersedia di v2.5.0 dan yang lebih baru dari komponen ini. Nama pengguna Windows yang digunakan untuk menjalankan komponen ini pada perangkat inti Windows. Pengguna harus ada di setiap perangkat inti Windows, dan nama serta kata sandinya harus disimpan dalam instance Credentials Manager LocalSystem akun. Untuk informasi selengkapnya, lihat [Konfigurasikan pengguna yang menjalankan komponen](configure-greengrass-core-v2.md#configure-component-user). Saat Anda menjalankan penginstal perangkat lunak AWS IoT Greengrass Core dengan `--component-default-user ggc_user` opsi, perangkat lunak menetapkan parameter ini di komponen inti. `systemResourceLimits` Fitur ini tersedia di v2.4.0 dan yang lebih baru dari komponen ini. AWS IoT Greengrass saat ini tidak mendukung fitur ini di perangkat inti Windows. Batas sumber daya sistem untuk diterapkan pada proses komponen Lambda generik dan non-kontainer secara default. Anda dapat mengganti batas sumber daya sistem untuk masing-masing komponen saat membuat penerapan. Untuk informasi selengkapnya, lihat [Konfigurasikan batas sumber daya sistem untuk komponen](configure-greengrass-core-v2.md#configure-component-system-resource-limits). Objek ini berisi informasi berikut: `cpus` Jumlah maksimum waktu CPU yang dapat digunakan oleh setiap proses komponen pada perangkat inti. Total waktu CPU perangkat inti setara dengan jumlah inti CPU perangkat. Misalnya, pada perangkat inti dengan 4 core CPU, Anda dapat mengatur nilai ini `2` untuk membatasi proses setiap komponen hingga 50 persen penggunaan setiap inti CPU. Pada perangkat dengan 1 inti CPU, Anda dapat mengatur nilai ini `0.25` untuk membatasi proses setiap komponen hingga 25 persen penggunaan CPU. Jika Anda menetapkan nilai ini ke angka yang lebih besar dari jumlah inti CPU, perangkat lunak AWS IoT Greengrass Core tidak membatasi penggunaan CPU komponen. `memory` Jumlah maksimum RAM (dalam kilobyte) yang dapat digunakan oleh setiap proses komponen pada perangkat inti. `s3EndpointType` (Opsional) Jenis titik akhir S3. Parameter ini hanya akan berlaku untuk Wilayah AS Timur (Virginia N.) (`us-east-1`). Pengaturan parameter ini dari Wilayah lain akan diabaikan. Pilih dari salah satu pilihan berikut: + `REGIONAL`— Klien S3 dan URL presigned menggunakan endpoint regional. + `GLOBAL`— Klien S3 dan URL presigned menggunakan endpoint lama. + `DUALSTACK`— URL presigned S3 menggunakan endpoint dualstack. Default: `GLOBAL` `fipsMode` (Opsional) Menyebabkan Greengrass menggunakan titik akhir FIPS. Untuk informasi selengkapnya tentang cara mengaktifkan titik akhir FIPS, lihat titik akhir [FIPS](FIPS.html). Pilih dari salah satu pilihan berikut: + `true`Ketika disetel ke true titik akhir akan menggunakan titik akhir FIPS. + `false`Ketika false, titik akhir tidak akan menggunakan titik akhir FIPS. Default: `false` `logging` (Opsional) Konfigurasi pencatatan untuk perangkat inti. Untuk informasi selengkapnya tentang cara mengonfigurasi dan menggunakan log Greengrass, lihat. [Memantau AWS IoT Greengrass log](monitor-logs.md) Objek ini berisi informasi berikut: `level` (Opsional) Tingkat minimum pesan log untuk output. Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `format` (Opsional) Format data log. Pilih dari salah satu pilihan berikut: + `TEXT`— Pilih opsi ini jika Anda ingin melihat log dalam bentuk teks. + `JSON`— Pilih opsi ini jika Anda ingin melihat log dengan perintah log [CLI Greengrass](gg-cli-logs.md) atau berinteraksi dengan log secara terprogram. Default: `TEXT` `outputType` (Opsional) Jenis output untuk log. Pilih dari salah satu pilihan berikut: + `FILE`— Perangkat lunak AWS IoT Greengrass Core mengeluarkan log ke file di direktori yang Anda tentukan. `outputDirectory` + `CONSOLE`— Perangkat lunak AWS IoT Greengrass Core mencetak log ke`stdout`. Pilih opsi ini untuk melihat log begitu perangkat inti mencetaknya. Default: `FILE` `fileSizeKB` (Opsional) Ukuran maksimum setiap file log (dalam kilobyte). Setelah file log melebihi ukuran file maksimum ini, perangkat lunak AWS IoT Greengrass Core membuat file log baru. Parameter ini hanya berlaku bila Anda menentukan `FILE` untuk `outputType`. Default: `1024` `totalLogsSizeKB` (Opsional) Ukuran total maksimum file log (dalam kilobyte) untuk setiap komponen, termasuk inti Greengrass. [File log Greengrass nucleus juga menyertakan log dari komponen plugin.](develop-greengrass-components.md#component-types) Setelah ukuran total file log komponen melebihi ukuran maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen tersebut. Parameter ini setara dengan parameter [batas ruang disk](log-manager-component.md#log-manager-component-configuration) [komponen pengelola log](log-manager-component.md) (`diskSpaceLimit`), yang dapat Anda tentukan untuk inti Greengrass (sistem) dan setiap komponen. Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total maksimum untuk inti Greengrass dan setiap komponen. Parameter ini hanya berlaku bila Anda menentukan `FILE` untuk `outputType`. Default: `10240` `outputDirectory` (Opsional) Direktori output untuk file log. Parameter ini hanya berlaku bila Anda menentukan `FILE` untuk `outputType`. Default:`/greengrass/v2/logs`, di mana `/greengrass/v2` folder AWS IoT Greengrass root. `fleetstatus` Parameter ini tersedia pada v2.1.0 dan versi yang lebih baru dari komponen ini. (Opsional) Konfigurasi status armada untuk perangkat inti. Objek ini berisi informasi berikut: `periodicStatusPublishIntervalSeconds` (Opsional) Jumlah waktu (dalam detik) yang di antaranya perangkat inti menerbitkan status perangkat ke AWS Cloud. Minimal: `86400` (24 jam) Default: `86400` (24 jam) `telemetry` (Opsional) Konfigurasi telemetri kesehatan sistem untuk perangkat inti. Untuk informasi lebih lanjut tentang metrik telemetri dan cara memperlakukan data telemetri, lihat [Kumpulkan data telemetri kesehatan sistem dari perangkat inti AWS IoT Greengrass](telemetry.md). Objek ini berisi informasi berikut: `enabled` (Opsional) Anda dapat mengaktifkan atau menonaktifkan telemetri. Default: `true` `periodicAggregateMetricsIntervalSeconds` (Opsional) Interval (dalam detik) di mana perangkat inti menggabungkan metrik. Jika Anda menetapkan nilai ini lebih rendah dari nilai minimum yang didukung, nukleus akan menggunakan nilai default sebagai gantinya. Minimal: `3600` Default: `3600` `periodicPublishMetricsIntervalSeconds` (Opsional) Jumlah waktu (dalam detik) yang di antaranya perangkat inti menerbitkan metrik telemetri ke AWS Cloud. Jika Anda menetapkan nilai ini lebih rendah dari nilai minimum yang didukung, nukleus akan menggunakan nilai default sebagai gantinya. Minimal: `86400` Default: `86400` `deploymentPollingFrequencySeconds` (Opsional) Periode dalam detik untuk mengumpulkan notifikasi deployment. Default: `15` `componentStoreMaxSizeBytes` (Opsional) Ukuran maksimum pada disk dari penyimpanan komponen, yang terdiri dari resep komponen dan artefak. Default: `10000000000` (10 GB) `platformOverride` (Opsional) Kamus atribut yang mengidentifikasi platform perangkat inti. Gunakan ini untuk menentukan atribut platform kustom yang dapat digunakan resep komponen untuk mengidentifikasi siklus hidup dan artefak yang benar untuk komponen. Misalnya, Anda mungkin menentukan atribut kemampuan perangkat keras untuk men-deploy hanya serangkaian artefak minimal yang akan dijalankan oleh komponen. Untuk informasi lebih lanjut, lihat [parameter platform manifes](component-recipe-reference.md#component-platform-definition) dalam resep komponen. Anda juga dapat menggunakan parameter ini untuk menimpa atribut platform `os` dan `architecture` dari perangkat inti. `httpClient` Parameter ini tersedia di v2.5.0 dan yang lebih baru dari komponen ini. (Opsional) Konfigurasi klien HTTP untuk perangkat inti. Opsi konfigurasi ini berlaku untuk semua permintaan HTTP yang dibuat oleh komponen ini. Jika perangkat inti berjalan pada jaringan yang lebih lambat, Anda dapat meningkatkan durasi waktu tunggu ini untuk mencegah permintaan HTTP dari waktu habis. Objek ini berisi informasi berikut: `connectionTimeoutMs` (Opsional) Jumlah waktu (dalam milidetik) untuk menunggu koneksi terbuka sebelum waktu permintaan koneksi habis. Default: `2000` (2 detik) `socketTimeoutMs` (Opsional) Jumlah waktu (dalam milidetik) untuk menunggu data ditransfer melalui koneksi terbuka sebelum waktu koneksi habis. Default: `30000` (30 detik) `deploymentConfigurationTimeSource` Parameter ini tersedia di v2.15.0 dan yang lebih baru dari komponen ini. (Opsional) Stempel waktu yang akan digunakan saat memproses penerapan. Defaultnya adalah`deploymentCreationTime`. Objek ini berisi nilai-nilai berikut: `deploymentCreationTime` Nilai default dari`deploymentConfigurationTimeSource`. Perangkat menggunakan stempel waktu pembuatan penerapan untuk menyelesaikan konflik kunci konfigurasi selama pemrosesan. Ketika perilaku ini dipilih, konfigurasi perangkat lokal yang dipegang oleh nukleus mungkin memiliki stempel waktu yang lebih besar daripada penerapan yang masuk dan menolak perubahan konfigurasi masuk yang sekarang dianggap usang. `deploymentProcessingTime` Perangkat menggunakan stempel waktu lokalnya untuk menyelesaikan konflik kunci konfigurasi selama pemrosesan penerapan. Saat diproses, perangkat memperbarui konfigurasi berdasarkan stempel waktu pemrosesan, bukan stempel waktu pembuatan penerapan. Perilaku ini mengasumsikan jam perangkat dikalibrasi dengan benar. Konfigurasikan setelan nukleus ini di image atau instalasi perangkat awal Anda, bukan melalui penerapan saat Anda ingin perangkat baru menggunakan perilaku ini pada koneksi pertama. Gunakan [https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-installer.html](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-installer.html)opsi penginstal klasik nukleus untuk konfigurasi ini. Konfigurasi awal ini penting karena perangkat memproses beberapa penerapan dalam urutan sewenang-wenang. Tanpa konfigurasi awal yang tepat, perangkat dapat memproses penerapan menggunakan `deploymentCreationTime` perilaku default sebelum menerima penerapan yang menyetel konfigurasi inti. `deploymentProcessingTime` **Example Contoh: Pembaruan gabungan konfigurasi** ``` { "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias", "networkProxy": { "noProxyAddresses": "http://192.168.0.1,www.example.com", "proxy": { "url": "http://my-proxy-server:1100", "username": "Mary_Major", "password": "pass@word1357" } }, "mqtt": { "port": 443 }, "greengrassDataPlanePort": 443, "jvmOptions": "-Xmx64m", "runWithDefault": { "posixUser": "ggc_user:ggc_group" } } ``` ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.17.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.16.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.16.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.15.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.15.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.14.3 | Perbaikan bug dan peningkatan [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.14.2 | Perbaikan bug dan peningkatan [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.14.1 | Perbaikan bug dan peningkatan [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.14.0 | Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.13.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.3 | Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. Perbaikan bug dan peningkatan [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.11.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.11.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.11.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.11.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.10.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.10.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.10.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.10.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.8.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.8.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.7.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.1 | Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.0.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.0.3 | Versi awal. | # Greengrass nucleus lite Greengrass nucleus lite `aws.greengrass.NucleusLite` () adalah runtime perangkat untuk perangkat edge terbatas yang dioptimalkan untuk jejak memori minimal (menggunakan RAM kurang dari 5MB). Ini telah diperkenalkan dengan rilis AWS IoT Greengrass versi 2.14.0 dan kompatibel dengan AWS IoT Greengrass komponen generik, Greengrass V2 API, dan SDK. Greengrass nucleus lite ditawarkan sebagai alternatif dari inti Greengrass umum [(`aws.greengrass.Nucleus`) dan dapat digunakan dalam armada perangkat Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html) yang heterogen. **Topics** + [Versi](#greengrass-nucleus-lite-component-versions) + [Sistem operasi](#greengrass-nucleus-lite-component-os-support) + [Persyaratan](#greengrass-nucleus-lite-component-requirements) + [Kompatibilitas](#greengrass-nucleus-lite-component-compatibility) + [Download dan Instalasi](#greengrass-nucleus-lite-component-install) + [Konfigurasi](#greengrass-nucleus-lite-component-configuration) + [File log lokal](#greengrass-nucleus-lite-component-log-file) + [Changelog](#greengrass-nucleus-lite-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.5.x + 2.4.x + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux (distribusi dengan systemd) Untuk informasi lebih lanjut, lihat Inti [Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/operating-system-feature-support-matrix.html). ## Persyaratan Perangkat harus memenuhi persyaratan tertentu untuk menginstal dan menjalankan AWS IoT Greengrass nucleus lite dan perangkat lunak AWS IoT Greengrass Core. Untuk informasi selengkapnya, lihat [Panduan pengaturan](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#setting-up-greengrass-nucleus-lite). + 5MB ruang RAM untuk runtime nukleus. + Penyimpanan 5MB (disk/Flash). Dependensi sistem tambahan didokumentasikan dalam Panduan [Pengaturan](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#dependencies). Komponen inti Greengrass didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan: + Inti Greengrass harus memiliki konektivitas AWS IoT ke data, AWS IoT Kredensial, dan Amazon S3. Untuk menjalankan AWS IoT Greengrass nucleus lite sebagai pengguna non-root, Anda dapat menggunakan wadah tanpa akar. Untuk informasi selengkapnya, lihat [Menggunakan Podman](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/BUILD.md#optional-using-podman) di AWS IoT Greengrass GitHub repositori nucleus lite. ## Kompatibilitas AWS IoT Greengrass Nucleus lite kompatibel dengan API AWS IoT Greengrass v2 (subset dari) dan didukung SDKs. Itu tidak tergantung pada bahasa tertentu runtimes/VMs tetapi komponen yang ditambahkan ke penerapan dapat memerlukan kehadiran runtime tertentu (misalnya: Java JVM, Python). Untuk informasi lebih lanjut tentang fitur apa yang didukung dengan Greengrass nucleus lite, lihat. [Kompatibilitas fitur Greengrass](operating-system-feature-support-matrix.md) ## Download dan Instalasi Anda dapat mengunduh paket apt, [membangun dari sumber](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/README.md#getting-started), [menggunakan lapisan Yocto, atau mengunduh gambar Yocto](https://github.com/aws4embeddedlinux/meta-aws) [yang sudah dibuat sebelumnya untuk perangkat yang kompatibel (](https://github.com/aws4embeddedlinux/meta-aws-demos)mis.,). RaspberryPi Dari [AWS IoT Core Konsol](https://console.aws.amazon.com/iot/home) Anda akan dapat mengunduh **kit koneksi** yang berisi semua kredensional dan konfigurasi awal untuk perangkat Anda. Petunjuk tentang cara menginstal disertakan dalam setiap metode distribusi tertentu. Anda juga dapat mengikuti tutorial untuk menginstal AWS IoT Greengrass nucleus lite dan menjelajahi pengembangan komponen Greengrass. Untuk informasi selengkapnya, lihat [Tutorial: Memulai dengan AWS IoT Greengrass V2](getting-started.md). ## Konfigurasi Nukleus menyediakan parameter [konfigurasi](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#configuring-greengrass) berikut. Beberapa parameter mengharuskan perangkat lunak AWS IoT Greengrass Core restart untuk diterapkan. `iotRoleAlias` Alias AWS IoT peran yang menunjuk ke peran IAM pertukaran token. Penyedia AWS IoT kredensi mengasumsikan peran ini untuk memungkinkan perangkat inti Greengrass berinteraksi dengan layanan. AWS Untuk informasi selengkapnya, lihat [Mengotorisasi perangkat inti untuk berinteraksi dengan AWS layanan](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html). `iotDataEndpoint` Titik akhir AWS IoT data untuk Anda Akun AWS. `iotCredEndpoint` Titik akhir AWS IoT kredensil untuk Anda. Akun AWS `greengrassDataPlanePort` Port yang digunakan untuk koneksi pesawat data. Untuk informasi selengkapnya, lihat [Connect pada port 443 atau melalui proxy jaringan](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#configure-alpn-network-proxy). Anda harus menentukan port di mana perangkat dapat membuat koneksi keluar. Jika Anda menentukan port yang diblokir, perangkat tidak akan dapat terhubung AWS IoT Greengrass untuk menerima penerapan. Pilih dari salah satu pilihan berikut: + `443` + `8443` + Default: `8443` `awsRegion` Wilayah AWS Untuk digunakan. `runWithDefault` Pengguna sistem yang digunakan untuk menjalankan komponen. Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perangkat lunak AWS IoT Greengrass Core akan dimulai ulang agar perubahan diterapkan. Objek ini berisi informasi berikut: `posixUser` Nama atau ID pengguna sistem dan, secara opsional, grup sistem yang digunakan perangkat inti untuk menjalankan komponen generik. Tentukan pengguna dan grup yang dipisahkan dengan titik dua (`:`) dalam format berikut: `user:group`. Grup ini opsional. Jika Anda tidak menentukan grup, perangkat lunak AWS IoT Greengrass Core menggunakan grup utama untuk pengguna. Misalnya, Anda dapat menentukan `ggc_user` atau `ggc_user:ggc_group`. Untuk informasi selengkapnya, lihat [Konfigurasikan pengguna yang menjalankan komponen](configure-greengrass-core-v2.md#configure-component-user). `networkProxy` (Opsional) Proksi jaringan yang digunakan untuk semua koneksi. Untuk informasi selengkapnya, lihat [Hubungkan pada port 443 atau melalui proksi jaringan](configure-greengrass-core-v2.md#configure-alpn-network-proxy). Saat Anda menerapkan perubahan pada parameter konfigurasi ini, perubahan akan berlaku setelah restart perangkat lunak AWS IoT Greengrass Core berikutnya. Objek ini berisi informasi berikut: `noProxyAddresses` (Opsional) Daftar alamat IP atau nama host yang dipisahkan koma yang dikecualikan dari proxy. `proxy` Proksi yang akan dihubungkan. Objek ini berisi informasi berikut: `url` URL server proksi dalam format `http://host:port`. + `scheme` — Skema, yang harus berupa `http`. + `host` - Nama host atau alamat IP server proksi. + `port` — (Opsional) Nomor port. Jika Anda tidak menentukan port, maka perangkat inti Greengrass akan menggunakan nilai default berikut: + `http` — 80 ## File log lokal Pesan dicatat ke stdout dan file log ditangani oleh systemd. **Untuk melihat log komponen ini** + Gunakan `journalctl` untuk melihat log. ## Changelog | **Versi** | **Perubahan** | | --- | --- | | 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.3.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) | | 2.0.0 | Versi awal. | # Auth perangkat klien Komponen auth perangkat klien (`aws.greengrass.clientdevices.Auth`) mengautentikasi perangkat klien dan mengotorisasi tindakan perangkat klien. **catatan** Perangkat klien adalah perangkat IoT lokal yang terhubung ke perangkat inti Greengrass untuk mengirim pesan MQTT dan data yang akan diproses. Untuk informasi selengkapnya, lihat [Berinteraksilah dengan perangkat IoT lokal](interact-with-local-iot-devices.md). **Topics** + [Versi](#client-device-auth-component-versions) + [Tipe](#client-device-auth-component-type) + [Sistem operasi](#client-device-auth-component-os-support) + [Persyaratan](#client-device-auth-component-requirements) + [Dependensi](#client-device-auth-component-dependencies) + [Konfigurasi](#client-device-auth-component-configuration) + [File log lokal](#client-device-auth-component-log-file) + [Changelog](#client-device-auth-component-changelog) ## Versi **catatan** Autentikasi perangkat klien versi 2.3.0 telah dihentikan. Kami sangat menyarankan Anda meningkatkan ke autentikasi perangkat klien versi 2.3.1 atau yang lebih baru. Komponen ini memiliki versi berikut: + 2.5.x + 2.4.x + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + [Peran layanan Greengrass](greengrass-service-role.md) harus dikaitkan dengan Anda dan mengizinkan Akun AWS izin. `iot:DescribeCertificate` + AWS IoT Kebijakan perangkat inti harus mengizinkan izin berikut: + `greengrass:GetConnectivityInfo`, di mana sumber daya termasuk ARN perangkat inti yang menjalankan komponen ini + `greengrass:VerifyClientDeviceIoTCertificateAssociation`, di mana sumber daya menyertakan Nama Sumber Daya Amazon (ARN) dari setiap perangkat klien yang terhubung ke perangkat inti + `greengrass:VerifyClientDeviceIdentity` + `greengrass:PutCertificateAuthorities` + `iot:Publish`, di mana sumber daya termasuk ARN dari topik MQTT berikut: + `$aws/things/coreDeviceThingName*-gci/shadow/get` + `iot:Subscribe`, di mana sumber daya mencakup ARNs filter topik MQTT berikut: + `$aws/things/coreDeviceThingName*-gci/shadow/update/delta` + `$aws/things/coreDeviceThingName*-gci/shadow/get/accepted` + `iot:Receive`, di mana sumber daya mencakup ARNs topik MQTT berikut: + `$aws/things/coreDeviceThingName*-gci/shadow/update/delta` + `$aws/things/coreDeviceThingName*-gci/shadow/get/accepted` Untuk informasi selengkapnya, lihat [AWS IoT kebijakan untuk operasi pesawat data](device-auth.md#iot-policies) dan [AWS IoT Kebijakan minimal untuk mendukung perangkat klien](device-auth.md#client-device-support-minimal-iot-policy). + (Opsional) Untuk menggunakan otentikasi offline, peran AWS Identity and Access Management (IAM) yang digunakan oleh AWS IoT Greengrass layanan harus berisi izin berikut: + `greengrass:ListClientDevicesAssociatedWithCoreDevice`untuk mengaktifkan perangkat inti untuk daftar klien untuk otentikasi offline. + Komponen autentikasi perangkat klien didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan. + Komponen autentikasi perangkat klien harus memiliki konektivitas ke AWS IoT data, AWS IoT Kredensyal, dan Amazon S3. ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `iot.region.amazonaws.com` | 443 | Ya | Digunakan untuk mendapatkan informasi tentang sertifikat AWS IoT barang. | ## 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](#client-device-auth-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.5.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.17.0 | Lunak | ------ #### [ 2.5.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.16.0 | Lunak | ------ #### [ 2.5.2 – 2.5.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.2 dan 2.5.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.15.0 | Lunak | ------ #### [ 2.5.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.14.0 | Lunak | ------ #### [ 2.4.4 - 2.5.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.13.0 | Lunak | ------ #### [ 2.4.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.12.0 | Lunak | ------ #### [ 2.4.1 and 2.4.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.1 dan 2.4.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.11.0 | Lunak | ------ #### [ 2.3.0 – 2.4.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.0 hingga 2.4.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.10.0 | Lunak | ------ #### [ 2.3.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.10.0 | Lunak | ------ #### [ 2.2.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <=2.9.0 | Lunak | ------ #### [ 2.2.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <=2.8.0 | Lunak | ------ #### [ 2.2.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.8.0 | Lunak | ------ #### [ 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.6.0 <2.7.0 | Lunak | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Lunak | ------ #### [ 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Lunak | ------ #### [ 2.0.2 and 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.2 dan 2.0.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Lunak | ------ #### [ 2.0.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Lunak | ------ #### [ 2.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. **catatan** Izin berlangganan dievaluasi selama permintaan berlangganan klien ke broker MQTT lokal. Jika izin berlangganan klien yang ada dicabut, klien tidak akan lagi dapat berlangganan topik. Namun, itu akan terus menerima pesan dari topik berlangganan sebelumnya. Untuk mencegah perilaku ini, broker MQTT lokal harus dimulai kembali setelah mencabut izin berlangganan untuk memaksa otorisasi ulang klien. Untuk komponen broker MQTT 5 (EMQX), perbarui `restartIdentifier` konfigurasi untuk memulai kembali broker MQTT 5. Untuk komponen broker MQTT 3.1.1 (Moquette), komponen ini dimulai ulang setiap minggu secara default ketika sertifikat server berubah memaksa klien untuk mengotorisasi ulang. Anda dapat memaksa restart baik dengan mengubah informasi konektivitas (alamat IP) dari perangkat inti atau dengan membuat penyebaran untuk menghapus komponen broker dan kemudian menerapkannya lagi nanti. ------ #### [ v2.5.0 – 2.5.4 ] `deviceGroups` Grup perangkat adalah grup perangkat klien yang memiliki izin untuk menyambung dan berkomunikasi dengan perangkat inti. Gunakan aturan pemilihan untuk mengidentifikasi grup perangkat klien, dan menentukan *kebijakan otorisasi perangkat klien* yang menentukan izin untuk setiap grup perangkat. Objek ini berisi informasi berikut: `formatVersion` Versi format untuk objek konfigurasi ini. Pilih dari salah satu pilihan berikut: + `2021-03-05` `definitions` grup perangkat untuk perangkat inti ini. Setiap definisi menentukan *aturan pemilihan* untuk mengevaluasi apakah perangkat klien adalah anggota grup. Setiap definisi juga menentukan kebijakan izin yang akan diterapkan ke perangkat klien yang cocok dengan aturan pemilihan. Jika perangkat klien adalah anggota dari beberapa grup perangkat, izin perangkat terdiri dari kebijakan izin masing-masing grup. Objek ini berisi informasi berikut: `groupNameKey` Nama grup perangkat ini. Ganti *groupNameKey* dengan nama yang membantu Anda mengidentifikasi grup perangkat ini. Objek ini berisi informasi berikut: `selectionRule` Kueri yang menentukan perangkat klien mana yang menjadi anggota grup perangkat ini. Saat perangkat klien terhubung, perangkat inti mengevaluasi aturan pemilihan ini untuk menentukan apakah perangkat klien adalah anggota grup perangkat ini. Jika perangkat klien adalah anggota, perangkat inti akan menggunakan kebijakan grup perangkat ini untuk mengotorisasi tindakan perangkat klien. Setiap aturan pemilihan terdiri dari setidaknya satu *klausa aturan pemilihan*, yang merupakan kueri ekspresi tunggal yang dapat mencocokkan perangkat klien. Aturan pemilihan menggunakan sintaks kueri yang sama dengan pengindeksan AWS IoT armada. *Untuk informasi selengkapnya tentang sintaks aturan pemilihan, lihat sintaks [kueri pengindeksan AWS IoT armada di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) Pengembang.AWS IoT Core * Gunakan wildcard `*` untuk mencocokkan beberapa perangkat klien dengan satu pilihan klausul aturan. Anda dapat menggunakan wildcard ini di awal dan akhir nama benda untuk mencocokkan perangkat klien yang namanya dimulai atau diakhiri dengan string yang Anda tentukan. Anda juga dapat menggunakan wildcard ini untuk mencocokkan semua perangkat klien. Untuk memilih nilai yang berisi karakter titik dua (`:`), lepaskan titik dua dengan karakter garis miring terbalik (`\`). Dalam format seperti JSON, Anda harus melepaskan karakter ris miring terbalik, sehingga Anda memasukkan dua karakter ris miring terbalik sebelum karakter titik dua. Sebagai contoh, tentukan `thingName: MyTeam\\:ClientDevice1` untuk memilih objek yang namanya `MyTeam:ClientDevice1`. Anda dapat menentukan sebagai berikut: + `thingName`— Nama AWS IoT benda perangkat klien. **Example Contoh aturan pemilihan** Aturan seleksi berikut cocok dengan perangkat klien yang namanya `MyClientDevice1` atau `MyClientDevice2`. ``` thingName: MyClientDevice1 OR thingName: MyClientDevice2 ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan seleksi berikut cocok dengan perangkat klien yang namanya dimulai dengan `MyClientDevice`. ``` thingName: MyClientDevice* ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan pemilihan berikut cocok dengan perangkat klien yang namanya diakhiri dengan`MyClientDevice`. ``` thingName: *MyClientDevice ``` **Example Contoh aturan pemilihan (cocok dengan semua perangkat)** Aturan seleksi berikut cocok dengan semua perangkat klien. ``` thingName: * ``` `policyName` Kebijakan izin yang berlaku untuk perangkat klien dalam grup perangkat ini. Tentukan nama kebijakan yang Anda tetapkan di objek `policies`. `policies` Kebijakan otorisasi perangkat klien untuk perangkat klien yang terhubung ke perangkat inti. Setiap kebijakan otorisasi menentukan serangkaian tindakan dan sumber daya tempat perangkat klien dapat melakukan tindakan tersebut. Objek ini berisi informasi berikut: `policyNameKey` Nama kebijakan otorisasi ini. Ganti *policyNameKey* dengan nama yang membantu Anda mengidentifikasi kebijakan otorisasi ini. Anda menggunakan nama kebijakan ini untuk menentukan kebijakan yang berlaku untuk grup perangkat. Objek ini berisi informasi berikut: `statementNameKey` Nama pernyataan kebijakan ini. Ganti *statementNameKey* dengan nama yang membantu Anda mengidentifikasi pernyataan kebijakan ini. Objek ini berisi informasi berikut: `operations` Daftar operasi untuk mengizinkan sumber daya dalam kebijakan ini. Anda dapat menyertakan salah satu dari operasi berikut: + `mqtt:connect` — Memberikan izin untuk terhubung ke perangkat inti. Perangkat klien harus memiliki izin ini untuk menyambung ke perangkat inti. Operasi ini mendukung sumber daya berikut: + `mqtt:clientId:deviceClientId` — Batasi akses berdasarkan ID klien yang digunakan perangkat klien untuk terhubung ke broker MQTT perangkat inti. Ganti *deviceClientId* dengan ID klien yang akan digunakan. + `mqtt:publish` — Memberikan izin untuk mempublikasikan pesan MQTT ke topik. Operasi ini mendukung sumber daya berikut: + `mqtt:topic:mqttTopic` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopic* dengan topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. + `mqtt:subscribe` — Memberikan izin untuk berlangganan filter topik MQTT untuk menerima pesan. Operasi ini mendukung sumber daya berikut: + `mqtt:topicfilter:mqttTopicFilter` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopicFilter* dengan filter topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. `resources` Daftar operasi yang akan mengizinkan sumber daya dalam kebijakan ini. Tentukan sumber daya yang sesuai dengan operasi dalam kebijakan ini. Misalnya, Anda dapat menentukan daftar sumber daya topik MQTT (`mqtt:topic:mqttTopic`) dalam kebijakan yang menentukan operasi `mqtt:publish`. Anda dapat menentukan `*` wildcard di mana saja dalam variabel sumber daya untuk memungkinkan akses ke semua sumber daya. Misalnya, Anda dapat menentukan **mqtt:topic:my\$1** untuk mengizinkan akses ke sumber daya yang cocok dengan input tersebut. Variabel sumber daya berikut didukung: + `mqtt:topic:${iot:Connection.Thing.ThingName}` Ini menyelesaikan nama benda dalam AWS IoT Core registri yang kebijakannya sedang dievaluasi. AWS IoT Core menggunakan sertifikat yang disajikan perangkat saat mengautentikasi untuk menentukan hal mana yang akan digunakan untuk memverifikasi koneksi. Variabel kebijakan ini hanya tersedia jika perangkat terhubung melalui MQTT atau MQTT melalui protokol. WebSocket `statementDescription` (Opsional) Deskripsi untuk pernyataan kebijakan ini. `certificates` (Opsional) Opsi konfigurasi sertifikat untuk perangkat inti ini. Objek ini berisi informasi berikut: `serverCertificateValiditySeconds` (Opsional) Jumlah waktu (dalam detik) setelah sertifikat server MQTT lokal kedaluwarsa. Anda dapat mengonfigurasi opsi ini untuk menyesuaikan seberapa sering perangkat klien memutuskan sambungan dan menyambung kembali ke perangkat inti. Komponen ini memutar sertifikat server MQTT lokal 24 jam sebelum kedaluwarsa. Broker MQTT, seperti [komponen broker Moquette MQTT](mqtt-broker-moquette-component.md), menghasilkan sertifikat baru dan memulai ulang. Ketika ini terjadi, semua perangkat klien yang terhubung ke perangkat inti ini terputus. Perangkat klien dapat terhubung kembali ke perangkat inti setelah periode waktu yang singkat. Default: `604800` (7 hari) Nilai minimum: `172800` (2 hari) Nilai maksimum: `864000` (10 hari) `performance` (Opsional) Opsi konfigurasi kinerja untuk perangkat inti ini. Objek ini berisi informasi berikut: `maxActiveAuthTokens` (Opsional) Jumlah maksimum token otorisasi perangkat klien aktif. Anda dapat meningkatkan jumlah ini untuk mengaktifkan lebih banyak perangkat klien untuk terhubung ke perangkat inti tunggal, tanpa mengautentikasi ulang mereka. Default: `2500` `cloudRequestQueueSize` (Opsional) Jumlah maksimum AWS Cloud permintaan untuk mengantri sebelum komponen ini menolak permintaan. Default: `100` `maxConcurrentCloudRequests` (Opsional) Jumlah maksimum permintaan bersamaan untuk dikirim ke. AWS Cloud Anda dapat meningkatkan angka ini untuk meningkatkan kinerja otentikasi pada perangkat inti tempat Anda menghubungkan sejumlah besar perangkat klien. Default: `1` `certificateAuthority` (Opsional) Opsi konfigurasi otoritas sertifikat untuk mengganti otoritas perantara perangkat inti dengan otoritas sertifikat perantara Anda sendiri. Jika Anda mengonfigurasi perangkat inti Greengrass Anda dengan otoritas sertifikat khusus (CA) dan menggunakan CA yang sama untuk menerbitkan sertifikat perangkat klien, Greengrass melewati pemeriksaan kebijakan otorisasi untuk operasi MQTT perangkat klien. Komponen autentikasi perangkat klien sepenuhnya mempercayai klien menggunakan sertifikat yang ditandatangani oleh CA yang dikonfigurasi untuk digunakan. Untuk membatasi perilaku ini saat menggunakan CA kustom, buat dan tandatangani perangkat klien menggunakan CA atau CA perantara yang berbeda, lalu sesuaikan `certificateChainUri` bidang `certificateUri` dan untuk menunjuk ke CA perantara yang benar. Objek ini berisi informasi berikut. CertificateURI Lokasi sertifikat. Ini bisa berupa URI sistem file atau URI yang menunjuk ke sertifikat yang disimpan dalam modul keamanan perangkat keras. `certificateChainUri` Lokasi rantai sertifikat untuk perangkat inti CA. Ini harus menjadi rantai sertifikat lengkap kembali ke CA root Anda. Ini bisa berupa URI sistem file atau URI yang menunjuk ke rantai sertifikat yang disimpan dalam modul keamanan perangkat keras. `privateKeyUri` Lokasi kunci pribadi perangkat inti. Ini bisa berupa URI sistem file atau URI yang menunjuk ke kunci pribadi sertifikat yang disimpan dalam modul keamanan perangkat keras. `security` (Opsional) Opsi konfigurasi keamanan untuk perangkat inti ini. Objek ini berisi informasi berikut. `clientDeviceTrustDurationMinutes` Durasi dalam hitungan menit bahwa informasi otentikasi perangkat klien dapat dipercaya sebelum diperlukan untuk mengautentikasi ulang dengan perangkat inti. Nilai default adalah 1. `metrics` (Opsional) Opsi metrik untuk perangkat inti ini. Metrik kesalahan hanya akan ditampilkan jika ada kesalahan dengan autentikasi perangkat klien. Objek ini berisi informasi berikut: `disableMetrics` Jika `disableMetrics` bidang disetel sebagai`true`, autentikasi perangkat klien tidak akan mengumpulkan metrik. Default: `false` `aggregatePeriodSeconds` Periode agregasi dalam hitungan detik yang menentukan seberapa sering autentikasi perangkat klien mengumpulkan metrik dan mengirimkannya ke agen telemetri. Ini tidak mengubah seberapa sering metrik diterbitkan karena agen telemetri masih menerbitkannya sekali sehari. Default: `3600` startupTimeoutSeconds (Opsional) Maksimum waktu dalam hitungan detik untuk memulai komponen. Status komponen berubah menjadi `ERRORED` jika melebihi batas waktu ini. Default: `120` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan yang ketat)** Contoh konfigurasi berikut menentukan untuk memungkinkan perangkat klien yang namanya dimulai dengan `MyClientDevice` untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyDeviceGroup": { "selectionRule": "thingName: MyClientDevice*", "policyName": "MyRestrictivePolicy" } }, "policies": { "MyRestrictivePolicy": { "AllowConnect": { "statementDescription": "Allow client devices to connect.", "operations": [ "mqtt:connect" ], "resources": [ "*" ] }, "AllowPublish": { "statementDescription": "Allow client devices to publish on test/topic.", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:test/topic" ] }, "AllowSubscribe": { "statementDescription": "Allow client devices to subscribe to test/topic/response.", "operations": [ "mqtt:subscribe" ], "resources": [ "mqtt:topicfilter:test/topic/response" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan permisif)** Contoh konfigurasi berikut menentukan untuk memungkinkan semua perangkat klien untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyPermissiveDeviceGroup": { "selectionRule": "thingName: *", "policyName": "MyPermissivePolicy" } }, "policies": { "MyPermissivePolicy": { "AllowAll": { "statementDescription": "Allow client devices to perform all actions.", "operations": [ "*" ], "resources": [ "*" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan nama benda)** Contoh konfigurasi berikut memungkinkan perangkat klien untuk mempublikasikan topik yang dimulai dengan nama benda perangkat klien dan diakhiri dengan string`topic`. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "myThing": { "selectionRule": "thingName: *", "policyName": "MyThingNamePolicy" } }, "policies": { "MyThingNamePolicy": { "policyStatement": { "statementDescription": "mqtt publish", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:${iot:Connection.Thing.ThingName}/*/topic" ] } } } } } ``` ------ #### [ v2.4.5 ] `deviceGroups` Grup perangkat adalah grup perangkat klien yang memiliki izin untuk menyambung dan berkomunikasi dengan perangkat inti. Gunakan aturan pemilihan untuk mengidentifikasi grup perangkat klien, dan menentukan *kebijakan otorisasi perangkat klien* yang menentukan izin untuk setiap grup perangkat. Objek ini berisi informasi berikut: `formatVersion` Versi format untuk objek konfigurasi ini. Pilih dari salah satu pilihan berikut: + `2021-03-05` `definitions` grup perangkat untuk perangkat inti ini. Setiap definisi menentukan *aturan pemilihan* untuk mengevaluasi apakah perangkat klien adalah anggota grup. Setiap definisi juga menentukan kebijakan izin yang akan diterapkan ke perangkat klien yang cocok dengan aturan pemilihan. Jika perangkat klien adalah anggota dari beberapa grup perangkat, izin perangkat terdiri dari kebijakan izin masing-masing grup. Objek ini berisi informasi berikut: `groupNameKey` Nama grup perangkat ini. Ganti *groupNameKey* dengan nama yang membantu Anda mengidentifikasi grup perangkat ini. Objek ini berisi informasi berikut: `selectionRule` Kueri yang menentukan perangkat klien mana yang menjadi anggota grup perangkat ini. Saat perangkat klien terhubung, perangkat inti mengevaluasi aturan pemilihan ini untuk menentukan apakah perangkat klien adalah anggota grup perangkat ini. Jika perangkat klien adalah anggota, perangkat inti akan menggunakan kebijakan grup perangkat ini untuk mengotorisasi tindakan perangkat klien. Setiap aturan pemilihan terdiri dari setidaknya satu *klausa aturan pemilihan*, yang merupakan kueri ekspresi tunggal yang dapat mencocokkan perangkat klien. Aturan pemilihan menggunakan sintaks kueri yang sama dengan pengindeksan AWS IoT armada. *Untuk informasi selengkapnya tentang sintaks aturan pemilihan, lihat sintaks [kueri pengindeksan AWS IoT armada di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) Pengembang.AWS IoT Core * Gunakan wildcard `*` untuk mencocokkan beberapa perangkat klien dengan satu pilihan klausul aturan. Anda dapat menggunakan wildcard ini di awal dan akhir nama benda untuk mencocokkan perangkat klien yang namanya dimulai atau diakhiri dengan string yang Anda tentukan. Anda juga dapat menggunakan wildcard ini untuk mencocokkan semua perangkat klien. Untuk memilih nilai yang berisi karakter titik dua (`:`), lepaskan titik dua dengan karakter garis miring terbalik (`\`). Dalam format seperti JSON, Anda harus melepaskan karakter ris miring terbalik, sehingga Anda memasukkan dua karakter ris miring terbalik sebelum karakter titik dua. Sebagai contoh, tentukan `thingName: MyTeam\\:ClientDevice1` untuk memilih objek yang namanya `MyTeam:ClientDevice1`. Anda dapat menentukan sebagai berikut: + `thingName`— Nama AWS IoT benda perangkat klien. **Example Contoh aturan pemilihan** Aturan seleksi berikut cocok dengan perangkat klien yang namanya `MyClientDevice1` atau `MyClientDevice2`. ``` thingName: MyClientDevice1 OR thingName: MyClientDevice2 ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan seleksi berikut cocok dengan perangkat klien yang namanya dimulai dengan `MyClientDevice`. ``` thingName: MyClientDevice* ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan pemilihan berikut cocok dengan perangkat klien yang namanya diakhiri dengan`MyClientDevice`. ``` thingName: *MyClientDevice ``` **Example Contoh aturan pemilihan (cocok dengan semua perangkat)** Aturan seleksi berikut cocok dengan semua perangkat klien. ``` thingName: * ``` `policyName` Kebijakan izin yang berlaku untuk perangkat klien dalam grup perangkat ini. Tentukan nama kebijakan yang Anda tetapkan di objek `policies`. `policies` Kebijakan otorisasi perangkat klien untuk perangkat klien yang terhubung ke perangkat inti. Setiap kebijakan otorisasi menentukan serangkaian tindakan dan sumber daya tempat perangkat klien dapat melakukan tindakan tersebut. Objek ini berisi informasi berikut: `policyNameKey` Nama kebijakan otorisasi ini. Ganti *policyNameKey* dengan nama yang membantu Anda mengidentifikasi kebijakan otorisasi ini. Anda menggunakan nama kebijakan ini untuk menentukan kebijakan yang berlaku untuk grup perangkat. Objek ini berisi informasi berikut: `statementNameKey` Nama pernyataan kebijakan ini. Ganti *statementNameKey* dengan nama yang membantu Anda mengidentifikasi pernyataan kebijakan ini. Objek ini berisi informasi berikut: `operations` Daftar operasi untuk mengizinkan sumber daya dalam kebijakan ini. Anda dapat menyertakan salah satu dari operasi berikut: + `mqtt:connect` — Memberikan izin untuk terhubung ke perangkat inti. Perangkat klien harus memiliki izin ini untuk menyambung ke perangkat inti. Operasi ini mendukung sumber daya berikut: + `mqtt:clientId:deviceClientId` — Batasi akses berdasarkan ID klien yang digunakan perangkat klien untuk terhubung ke broker MQTT perangkat inti. Ganti *deviceClientId* dengan ID klien yang akan digunakan. + `mqtt:publish` — Memberikan izin untuk mempublikasikan pesan MQTT ke topik. Operasi ini mendukung sumber daya berikut: + `mqtt:topic:mqttTopic` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopic* dengan topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. + `mqtt:subscribe` — Memberikan izin untuk berlangganan filter topik MQTT untuk menerima pesan. Operasi ini mendukung sumber daya berikut: + `mqtt:topicfilter:mqttTopicFilter` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopicFilter* dengan filter topik yang akan digunakan. Sumber daya ini mendukung wildcard topik MQTT `+` dan `#`. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. Perangkat klien dapat berlangganan filter topik yang tepat yang Anda izinkan. Misalnya, jika Anda mengizinkan perangkat klien untuk berlangganan sumber daya `mqtt:topicfilter:client/+/status`, perangkat klien dapat berlangganan `client/+/status` tetapi bukan `client/client1/status`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua tindakan. `resources` Daftar operasi yang akan mengizinkan sumber daya dalam kebijakan ini. Tentukan sumber daya yang sesuai dengan operasi dalam kebijakan ini. Misalnya, Anda dapat menentukan daftar sumber daya topik MQTT (`mqtt:topic:mqttTopic`) dalam kebijakan yang menentukan operasi `mqtt:publish`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua sumber daya. Anda tidak dapat menggunakan wildcard `*` untuk mencocokkan pengidentifikasi sumber daya parsial. Misalnya, Anda dapat menentukan **"resources": "\$1"**, tetapi Anda tidak dapat menentukan **"resources": "mqtt:clientId:\$1"**. `statementDescription` (Opsional) Deskripsi untuk pernyataan kebijakan ini. `certificates` (Opsional) Opsi konfigurasi sertifikat untuk perangkat inti ini. Objek ini berisi informasi berikut: `serverCertificateValiditySeconds` (Opsional) Jumlah waktu (dalam detik) setelah sertifikat server MQTT lokal kedaluwarsa. Anda dapat mengonfigurasi opsi ini untuk menyesuaikan seberapa sering perangkat klien memutuskan sambungan dan menyambung kembali ke perangkat inti. Komponen ini memutar sertifikat server MQTT lokal 24 jam sebelum kedaluwarsa. Broker MQTT, seperti [komponen broker Moquette MQTT](mqtt-broker-moquette-component.md), menghasilkan sertifikat baru dan memulai ulang. Ketika ini terjadi, semua perangkat klien yang terhubung ke perangkat inti ini terputus. Perangkat klien dapat terhubung kembali ke perangkat inti setelah periode waktu yang singkat. Default: `604800` (7 hari) Nilai minimum: `172800` (2 hari) Nilai maksimum: `864000` (10 hari) `performance` (Opsional) Opsi konfigurasi kinerja untuk perangkat inti ini. Objek ini berisi informasi berikut: `maxActiveAuthTokens` (Opsional) Jumlah maksimum token otorisasi perangkat klien aktif. Anda dapat meningkatkan jumlah ini untuk mengaktifkan lebih banyak perangkat klien untuk terhubung ke perangkat inti tunggal, tanpa mengautentikasi ulang mereka. Default: `2500` `cloudRequestQueueSize` (Opsional) Jumlah maksimum AWS Cloud permintaan untuk mengantri sebelum komponen ini menolak permintaan. Default: `100` `maxConcurrentCloudRequests` (Opsional) Jumlah maksimum permintaan bersamaan untuk dikirim ke. AWS Cloud Anda dapat meningkatkan angka ini untuk meningkatkan kinerja otentikasi pada perangkat inti tempat Anda menghubungkan sejumlah besar perangkat klien. Default: `1` `certificateAuthority` (Opsional) Opsi konfigurasi otoritas sertifikat untuk mengganti otoritas perantara perangkat inti dengan otoritas sertifikat perantara Anda sendiri. Jika Anda mengonfigurasi perangkat inti Greengrass Anda dengan otoritas sertifikat khusus (CA) dan menggunakan CA yang sama untuk menerbitkan sertifikat perangkat klien, Greengrass melewati pemeriksaan kebijakan otorisasi untuk operasi MQTT perangkat klien. Komponen autentikasi perangkat klien sepenuhnya mempercayai klien menggunakan sertifikat yang ditandatangani oleh CA yang dikonfigurasi untuk digunakan. Untuk membatasi perilaku ini saat menggunakan CA kustom, buat dan tandatangani perangkat klien menggunakan CA atau CA perantara yang berbeda, lalu sesuaikan `certificateChainUri` bidang `certificateUri` dan untuk menunjuk ke CA perantara yang benar. Objek ini berisi informasi berikut. CertificateURI Lokasi sertifikat. Ini bisa berupa URI sistem file atau URI yang menunjuk ke sertifikat yang disimpan dalam modul keamanan perangkat keras. `certificateChainUri` Lokasi rantai sertifikat untuk perangkat inti CA. Ini harus menjadi rantai sertifikat lengkap kembali ke CA root Anda. Ini bisa berupa URI sistem file atau URI yang menunjuk ke rantai sertifikat yang disimpan dalam modul keamanan perangkat keras. `privateKeyUri` Lokasi kunci pribadi perangkat inti. Ini bisa berupa URI sistem file atau URI yang menunjuk ke kunci pribadi sertifikat yang disimpan dalam modul keamanan perangkat keras. `security` (Opsional) Opsi konfigurasi keamanan untuk perangkat inti ini. Objek ini berisi informasi berikut. `clientDeviceTrustDurationMinutes` Durasi dalam hitungan menit bahwa informasi otentikasi perangkat klien dapat dipercaya sebelum diperlukan untuk mengautentikasi ulang dengan perangkat inti. Nilai default adalah 1. `metrics` (Opsional) Opsi metrik untuk perangkat inti ini. Metrik kesalahan hanya akan ditampilkan jika ada kesalahan dengan autentikasi perangkat klien. Objek ini berisi informasi berikut: `disableMetrics` Jika `disableMetrics` bidang disetel sebagai`true`, autentikasi perangkat klien tidak akan mengumpulkan metrik. Default: `false` `aggregatePeriodSeconds` Periode agregasi dalam hitungan detik yang menentukan seberapa sering autentikasi perangkat klien mengumpulkan metrik dan mengirimkannya ke agen telemetri. Ini tidak mengubah seberapa sering metrik diterbitkan karena agen telemetri masih menerbitkannya sekali sehari. Default: `3600` startupTimeoutSeconds (Opsional) Maksimum waktu dalam hitungan detik untuk memulai komponen. Status komponen berubah menjadi `ERRORED` jika melebihi batas waktu ini. Default: `120` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan yang ketat)** Contoh konfigurasi berikut menentukan untuk memungkinkan perangkat klien yang namanya dimulai dengan `MyClientDevice` untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyDeviceGroup": { "selectionRule": "thingName: MyClientDevice*", "policyName": "MyRestrictivePolicy" } }, "policies": { "MyRestrictivePolicy": { "AllowConnect": { "statementDescription": "Allow client devices to connect.", "operations": [ "mqtt:connect" ], "resources": [ "*" ] }, "AllowPublish": { "statementDescription": "Allow client devices to publish on test/topic.", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:test/topic" ] }, "AllowSubscribe": { "statementDescription": "Allow client devices to subscribe to test/topic/response.", "operations": [ "mqtt:subscribe" ], "resources": [ "mqtt:topicfilter:test/topic/response" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan permisif)** Contoh konfigurasi berikut menentukan untuk memungkinkan semua perangkat klien untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyPermissiveDeviceGroup": { "selectionRule": "thingName: *", "policyName": "MyPermissivePolicy" } }, "policies": { "MyPermissivePolicy": { "AllowAll": { "statementDescription": "Allow client devices to perform all actions.", "operations": [ "*" ], "resources": [ "*" ] } } } } } ``` ------ #### [ v2.4.2 - v2.4.4 ] `deviceGroups` Grup perangkat adalah grup perangkat klien yang memiliki izin untuk menyambung dan berkomunikasi dengan perangkat inti. Gunakan aturan pemilihan untuk mengidentifikasi grup perangkat klien, dan menentukan *kebijakan otorisasi perangkat klien* yang menentukan izin untuk setiap grup perangkat. Objek ini berisi informasi berikut: `formatVersion` Versi format untuk objek konfigurasi ini. Pilih dari salah satu pilihan berikut: + `2021-03-05` `definitions` grup perangkat untuk perangkat inti ini. Setiap definisi menentukan *aturan pemilihan* untuk mengevaluasi apakah perangkat klien adalah anggota grup. Setiap definisi juga menentukan kebijakan izin yang akan diterapkan ke perangkat klien yang cocok dengan aturan pemilihan. Jika perangkat klien adalah anggota dari beberapa grup perangkat, izin perangkat terdiri dari kebijakan izin masing-masing grup. Objek ini berisi informasi berikut: `groupNameKey` Nama grup perangkat ini. Ganti *groupNameKey* dengan nama yang membantu Anda mengidentifikasi grup perangkat ini. Objek ini berisi informasi berikut: `selectionRule` Kueri yang menentukan perangkat klien mana yang menjadi anggota grup perangkat ini. Saat perangkat klien terhubung, perangkat inti mengevaluasi aturan pemilihan ini untuk menentukan apakah perangkat klien adalah anggota grup perangkat ini. Jika perangkat klien adalah anggota, perangkat inti akan menggunakan kebijakan grup perangkat ini untuk mengotorisasi tindakan perangkat klien. Setiap aturan pemilihan terdiri dari setidaknya satu *klausa aturan pemilihan*, yang merupakan kueri ekspresi tunggal yang dapat mencocokkan perangkat klien. Aturan pemilihan menggunakan sintaks kueri yang sama dengan pengindeksan AWS IoT armada. *Untuk informasi selengkapnya tentang sintaks aturan pemilihan, lihat sintaks [kueri pengindeksan AWS IoT armada di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) Pengembang.AWS IoT Core * Gunakan wildcard `*` untuk mencocokkan beberapa perangkat klien dengan satu pilihan klausul aturan. Anda dapat menggunakan wildcard ini di akhir nama objek untuk mencocokkan perangkat klien yang namanya dimulai dengan string yang Anda tentukan. Anda juga dapat menggunakan wildcard ini untuk mencocokkan semua perangkat klien. Untuk memilih nilai yang berisi karakter titik dua (`:`), lepaskan titik dua dengan karakter garis miring terbalik (`\\`). Dalam format seperti JSON, Anda harus melepaskan karakter ris miring terbalik, sehingga Anda memasukkan dua karakter ris miring terbalik sebelum karakter titik dua. Sebagai contoh, tentukan `thingName: MyTeam\\\\:ClientDevice1` untuk memilih objek yang namanya `MyTeam:ClientDevice1`. Anda dapat menentukan sebagai berikut: + `thingName` — Nama objek AWS IoT perangkat klien. **Example Contoh aturan pemilihan** Aturan seleksi berikut cocok dengan perangkat klien yang namanya `MyClientDevice1` atau `MyClientDevice2`. ``` thingName: MyClientDevice1 OR thingName: MyClientDevice2 ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan seleksi berikut cocok dengan perangkat klien yang namanya dimulai dengan `MyClientDevice`. ``` thingName: MyClientDevice* ``` **Example Contoh aturan pemilihan (cocok dengan semua perangkat)** Aturan seleksi berikut cocok dengan semua perangkat klien. ``` thingName: * ``` `policyName` Kebijakan izin yang berlaku untuk perangkat klien dalam grup perangkat ini. Tentukan nama kebijakan yang Anda tetapkan di objek `policies`. `policies` Kebijakan otorisasi perangkat klien untuk perangkat klien yang terhubung ke perangkat inti. Setiap kebijakan otorisasi menentukan serangkaian tindakan dan sumber daya tempat perangkat klien dapat melakukan tindakan tersebut. Objek ini berisi informasi berikut: `policyNameKey` Nama kebijakan otorisasi ini. Ganti *policyNameKey* dengan nama yang membantu Anda mengidentifikasi kebijakan otorisasi ini. Anda menggunakan nama kebijakan ini untuk menentukan kebijakan yang berlaku untuk grup perangkat. Objek ini berisi informasi berikut: `statementNameKey` Nama pernyataan kebijakan ini. Ganti *statementNameKey* dengan nama yang membantu Anda mengidentifikasi pernyataan kebijakan ini. Objek ini berisi informasi berikut: `operations` Daftar operasi untuk mengizinkan sumber daya dalam kebijakan ini. Anda dapat menyertakan salah satu dari operasi berikut: + `mqtt:connect` — Memberikan izin untuk terhubung ke perangkat inti. Perangkat klien harus memiliki izin ini untuk menyambung ke perangkat inti. Operasi ini mendukung sumber daya berikut: + `mqtt:clientId:deviceClientId` — Batasi akses berdasarkan ID klien yang digunakan perangkat klien untuk terhubung ke broker MQTT perangkat inti. Ganti *deviceClientId* dengan ID klien yang akan digunakan. + `mqtt:publish` — Memberikan izin untuk mempublikasikan pesan MQTT ke topik. Operasi ini mendukung sumber daya berikut: + `mqtt:topic:mqttTopic` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopic* dengan topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. + `mqtt:subscribe` — Memberikan izin untuk berlangganan filter topik MQTT untuk menerima pesan. Operasi ini mendukung sumber daya berikut: + `mqtt:topicfilter:mqttTopicFilter` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopicFilter* dengan filter topik yang akan digunakan. Sumber daya ini mendukung wildcard topik MQTT `+` dan `#`. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. Perangkat klien dapat berlangganan filter topik yang tepat yang Anda izinkan. Misalnya, jika Anda mengizinkan perangkat klien untuk berlangganan sumber daya `mqtt:topicfilter:client/+/status`, perangkat klien dapat berlangganan `client/+/status` tetapi bukan `client/client1/status`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua tindakan. `resources` Daftar operasi yang akan mengizinkan sumber daya dalam kebijakan ini. Tentukan sumber daya yang sesuai dengan operasi dalam kebijakan ini. Misalnya, Anda dapat menentukan daftar sumber daya topik MQTT (`mqtt:topic:mqttTopic`) dalam kebijakan yang menentukan operasi `mqtt:publish`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua sumber daya. Anda tidak dapat menggunakan wildcard `*` untuk mencocokkan pengidentifikasi sumber daya parsial. Misalnya, Anda dapat menentukan **"resources": "\$1"**, tetapi Anda tidak dapat menentukan **"resources": "mqtt:clientId:\$1"**. `statementDescription` (Opsional) Deskripsi untuk pernyataan kebijakan ini. `certificates` (Opsional) Opsi konfigurasi sertifikat untuk perangkat inti ini. Objek ini berisi informasi berikut: `serverCertificateValiditySeconds` (Opsional) Jumlah waktu (dalam detik) setelah sertifikat server MQTT lokal kedaluwarsa. Anda dapat mengonfigurasi opsi ini untuk menyesuaikan seberapa sering perangkat klien memutuskan sambungan dan menyambung kembali ke perangkat inti. Komponen ini memutar sertifikat server MQTT lokal 24 jam sebelum kedaluwarsa. Broker MQTT, seperti [komponen broker Moquette MQTT](mqtt-broker-moquette-component.md), menghasilkan sertifikat baru dan memulai ulang. Ketika ini terjadi, semua perangkat klien yang terhubung ke perangkat inti ini terputus. Perangkat klien dapat terhubung kembali ke perangkat inti setelah periode waktu yang singkat. Default: `604800` (7 hari) Nilai minimum: `172800` (2 hari) Nilai maksimum: `864000` (10 hari) `performance` (Opsional) Opsi konfigurasi kinerja untuk perangkat inti ini. Objek ini berisi informasi berikut: `maxActiveAuthTokens` (Opsional) Jumlah maksimum token otorisasi perangkat klien aktif. Anda dapat meningkatkan jumlah ini untuk mengaktifkan lebih banyak perangkat klien untuk terhubung ke perangkat inti tunggal, tanpa mengautentikasi ulang mereka. Default: `2500` `cloudRequestQueueSize` (Opsional) Jumlah maksimum AWS Cloud permintaan untuk mengantri sebelum komponen ini menolak permintaan. Default: `100` `maxConcurrentCloudRequests` (Opsional) Jumlah maksimum permintaan bersamaan untuk dikirim ke. AWS Cloud Anda dapat meningkatkan angka ini untuk meningkatkan kinerja otentikasi pada perangkat inti tempat Anda menghubungkan sejumlah besar perangkat klien. Default: `1` `certificateAuthority` (Opsional) Opsi konfigurasi otoritas sertifikat untuk mengganti otoritas perantara perangkat inti dengan otoritas sertifikat perantara Anda sendiri. Jika Anda mengonfigurasi perangkat inti Greengrass Anda dengan otoritas sertifikat khusus (CA) dan menggunakan CA yang sama untuk menerbitkan sertifikat perangkat klien, Greengrass melewati pemeriksaan kebijakan otorisasi untuk operasi MQTT perangkat klien. Komponen autentikasi perangkat klien sepenuhnya mempercayai klien menggunakan sertifikat yang ditandatangani oleh CA yang dikonfigurasi untuk digunakan. Untuk membatasi perilaku ini saat menggunakan CA kustom, buat dan tandatangani perangkat klien menggunakan CA atau CA perantara yang berbeda, lalu sesuaikan `certificateChainUri` bidang `certificateUri` dan untuk menunjuk ke CA perantara yang benar. Objek ini berisi informasi berikut. CertificateURI Lokasi sertifikat. Ini bisa berupa URI sistem file atau URI yang menunjuk ke sertifikat yang disimpan dalam modul keamanan perangkat keras. `certificateChainUri` Lokasi rantai sertifikat untuk perangkat inti CA. Ini harus menjadi rantai sertifikat lengkap kembali ke CA root Anda. Ini bisa berupa URI sistem file atau URI yang menunjuk ke rantai sertifikat yang disimpan dalam modul keamanan perangkat keras. `privateKeyUri` Lokasi kunci pribadi perangkat inti. Ini bisa berupa URI sistem file atau URI yang menunjuk ke kunci pribadi sertifikat yang disimpan dalam modul keamanan perangkat keras. `security` (Opsional) Opsi konfigurasi keamanan untuk perangkat inti ini. Objek ini berisi informasi berikut. `clientDeviceTrustDurationMinutes` Durasi dalam hitungan menit bahwa informasi otentikasi perangkat klien dapat dipercaya sebelum diperlukan untuk mengautentikasi ulang dengan perangkat inti. Nilai default adalah 1. `metrics` (Opsional) Opsi metrik untuk perangkat inti ini. Metrik kesalahan hanya akan ditampilkan jika ada kesalahan dengan autentikasi perangkat klien. Objek ini berisi informasi berikut: `disableMetrics` Jika `disableMetrics` bidang disetel sebagai`true`, autentikasi perangkat klien tidak akan mengumpulkan metrik. Default: `false` `aggregatePeriodSeconds` Periode agregasi dalam hitungan detik yang menentukan seberapa sering autentikasi perangkat klien mengumpulkan metrik dan mengirimkannya ke agen telemetri. Ini tidak mengubah seberapa sering metrik diterbitkan karena agen telemetri masih menerbitkannya sekali sehari. Default: `3600` startupTimeoutSeconds (Opsional) Maksimum waktu dalam hitungan detik untuk memulai komponen. Status komponen berubah menjadi `ERRORED` jika melebihi batas waktu ini. Default: `120` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan yang ketat)** Contoh konfigurasi berikut menentukan untuk memungkinkan perangkat klien yang namanya dimulai dengan `MyClientDevice` untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyDeviceGroup": { "selectionRule": "thingName: MyClientDevice*", "policyName": "MyRestrictivePolicy" } }, "policies": { "MyRestrictivePolicy": { "AllowConnect": { "statementDescription": "Allow client devices to connect.", "operations": [ "mqtt:connect" ], "resources": [ "*" ] }, "AllowPublish": { "statementDescription": "Allow client devices to publish on test/topic.", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:test/topic" ] }, "AllowSubscribe": { "statementDescription": "Allow client devices to subscribe to test/topic/response.", "operations": [ "mqtt:subscribe" ], "resources": [ "mqtt:topicfilter:test/topic/response" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan permisif)** Contoh konfigurasi berikut menentukan untuk memungkinkan semua perangkat klien untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyPermissiveDeviceGroup": { "selectionRule": "thingName: *", "policyName": "MyPermissivePolicy" } }, "policies": { "MyPermissivePolicy": { "AllowAll": { "statementDescription": "Allow client devices to perform all actions.", "operations": [ "*" ], "resources": [ "*" ] } } } } } ``` ------ #### [ v2.4.0 - v2.4.1 ] `deviceGroups` Grup perangkat adalah grup perangkat klien yang memiliki izin untuk menyambung dan berkomunikasi dengan perangkat inti. Gunakan aturan pemilihan untuk mengidentifikasi grup perangkat klien, dan menentukan *kebijakan otorisasi perangkat klien* yang menentukan izin untuk setiap grup perangkat. Objek ini berisi informasi berikut: `formatVersion` Versi format untuk objek konfigurasi ini. Pilih dari salah satu pilihan berikut: + `2021-03-05` `definitions` grup perangkat untuk perangkat inti ini. Setiap definisi menentukan *aturan pemilihan* untuk mengevaluasi apakah perangkat klien adalah anggota grup. Setiap definisi juga menentukan kebijakan izin yang akan diterapkan ke perangkat klien yang cocok dengan aturan pemilihan. Jika perangkat klien adalah anggota dari beberapa grup perangkat, izin perangkat terdiri dari kebijakan izin masing-masing grup. Objek ini berisi informasi berikut: `groupNameKey` Nama grup perangkat ini. Ganti *groupNameKey* dengan nama yang membantu Anda mengidentifikasi grup perangkat ini. Objek ini berisi informasi berikut: `selectionRule` Kueri yang menentukan perangkat klien mana yang menjadi anggota grup perangkat ini. Saat perangkat klien terhubung, perangkat inti mengevaluasi aturan pemilihan ini untuk menentukan apakah perangkat klien adalah anggota grup perangkat ini. Jika perangkat klien adalah anggota, perangkat inti akan menggunakan kebijakan grup perangkat ini untuk mengotorisasi tindakan perangkat klien. Setiap aturan pemilihan terdiri dari setidaknya satu *klausa aturan pemilihan*, yang merupakan kueri ekspresi tunggal yang dapat mencocokkan perangkat klien. Aturan pemilihan menggunakan sintaks kueri yang sama dengan pengindeksan AWS IoT armada. *Untuk informasi selengkapnya tentang sintaks aturan pemilihan, lihat sintaks [kueri pengindeksan AWS IoT armada di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) Pengembang.AWS IoT Core * Gunakan wildcard `*` untuk mencocokkan beberapa perangkat klien dengan satu pilihan klausul aturan. Anda dapat menggunakan wildcard ini di akhir nama objek untuk mencocokkan perangkat klien yang namanya dimulai dengan string yang Anda tentukan. Anda juga dapat menggunakan wildcard ini untuk mencocokkan semua perangkat klien. Untuk memilih nilai yang berisi karakter titik dua (`:`), lepaskan titik dua dengan karakter garis miring terbalik (`\\`). Dalam format seperti JSON, Anda harus melepaskan karakter ris miring terbalik, sehingga Anda memasukkan dua karakter ris miring terbalik sebelum karakter titik dua. Sebagai contoh, tentukan `thingName: MyTeam\\\\:ClientDevice1` untuk memilih objek yang namanya `MyTeam:ClientDevice1`. Anda dapat menentukan sebagai berikut: + `thingName` — Nama objek AWS IoT perangkat klien. **Example Contoh aturan pemilihan** Aturan seleksi berikut cocok dengan perangkat klien yang namanya `MyClientDevice1` atau `MyClientDevice2`. ``` thingName: MyClientDevice1 OR thingName: MyClientDevice2 ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan seleksi berikut cocok dengan perangkat klien yang namanya dimulai dengan `MyClientDevice`. ``` thingName: MyClientDevice* ``` **Example Contoh aturan pemilihan (cocok dengan semua perangkat)** Aturan seleksi berikut cocok dengan semua perangkat klien. ``` thingName: * ``` `policyName` Kebijakan izin yang berlaku untuk perangkat klien dalam grup perangkat ini. Tentukan nama kebijakan yang Anda tetapkan di objek `policies`. `policies` Kebijakan otorisasi perangkat klien untuk perangkat klien yang terhubung ke perangkat inti. Setiap kebijakan otorisasi menentukan serangkaian tindakan dan sumber daya tempat perangkat klien dapat melakukan tindakan tersebut. Objek ini berisi informasi berikut: `policyNameKey` Nama kebijakan otorisasi ini. Ganti *policyNameKey* dengan nama yang membantu Anda mengidentifikasi kebijakan otorisasi ini. Anda menggunakan nama kebijakan ini untuk menentukan kebijakan yang berlaku untuk grup perangkat. Objek ini berisi informasi berikut: `statementNameKey` Nama pernyataan kebijakan ini. Ganti *statementNameKey* dengan nama yang membantu Anda mengidentifikasi pernyataan kebijakan ini. Objek ini berisi informasi berikut: `operations` Daftar operasi untuk mengizinkan sumber daya dalam kebijakan ini. Anda dapat menyertakan salah satu dari operasi berikut: + `mqtt:connect` — Memberikan izin untuk terhubung ke perangkat inti. Perangkat klien harus memiliki izin ini untuk menyambung ke perangkat inti. Operasi ini mendukung sumber daya berikut: + `mqtt:clientId:deviceClientId` — Batasi akses berdasarkan ID klien yang digunakan perangkat klien untuk terhubung ke broker MQTT perangkat inti. Ganti *deviceClientId* dengan ID klien yang akan digunakan. + `mqtt:publish` — Memberikan izin untuk mempublikasikan pesan MQTT ke topik. Operasi ini mendukung sumber daya berikut: + `mqtt:topic:mqttTopic` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopic* dengan topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. + `mqtt:subscribe` — Memberikan izin untuk berlangganan filter topik MQTT untuk menerima pesan. Operasi ini mendukung sumber daya berikut: + `mqtt:topicfilter:mqttTopicFilter` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopicFilter* dengan filter topik yang akan digunakan. Sumber daya ini mendukung wildcard topik MQTT `+` dan `#`. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. Perangkat klien dapat berlangganan filter topik yang tepat yang Anda izinkan. Misalnya, jika Anda mengizinkan perangkat klien untuk berlangganan sumber daya `mqtt:topicfilter:client/+/status`, perangkat klien dapat berlangganan `client/+/status` tetapi bukan `client/client1/status`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua tindakan. `resources` Daftar operasi yang akan mengizinkan sumber daya dalam kebijakan ini. Tentukan sumber daya yang sesuai dengan operasi dalam kebijakan ini. Misalnya, Anda dapat menentukan daftar sumber daya topik MQTT (`mqtt:topic:mqttTopic`) dalam kebijakan yang menentukan operasi `mqtt:publish`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua sumber daya. Anda tidak dapat menggunakan wildcard `*` untuk mencocokkan pengidentifikasi sumber daya parsial. Misalnya, Anda dapat menentukan **"resources": "\$1"**, tetapi Anda tidak dapat menentukan **"resources": "mqtt:clientId:\$1"**. `statementDescription` (Opsional) Deskripsi untuk pernyataan kebijakan ini. `certificates` (Opsional) Opsi konfigurasi sertifikat untuk perangkat inti ini. Objek ini berisi informasi berikut: `serverCertificateValiditySeconds` (Opsional) Jumlah waktu (dalam detik) setelah sertifikat server MQTT lokal kedaluwarsa. Anda dapat mengonfigurasi opsi ini untuk menyesuaikan seberapa sering perangkat klien memutuskan sambungan dan menyambung kembali ke perangkat inti. Komponen ini memutar sertifikat server MQTT lokal 24 jam sebelum kedaluwarsa. Broker MQTT, seperti [komponen broker Moquette MQTT](mqtt-broker-moquette-component.md), menghasilkan sertifikat baru dan memulai ulang. Ketika ini terjadi, semua perangkat klien yang terhubung ke perangkat inti ini terputus. Perangkat klien dapat terhubung kembali ke perangkat inti setelah periode waktu yang singkat. Default: `604800` (7 hari) Nilai minimum: `172800` (2 hari) Nilai maksimum: `864000` (10 hari) `performance` (Opsional) Opsi konfigurasi kinerja untuk perangkat inti ini. Objek ini berisi informasi berikut: `maxActiveAuthTokens` (Opsional) Jumlah maksimum token otorisasi perangkat klien aktif. Anda dapat meningkatkan jumlah ini untuk mengaktifkan lebih banyak perangkat klien untuk terhubung ke perangkat inti tunggal, tanpa mengautentikasi ulang mereka. Default: `2500` `cloudRequestQueueSize` (Opsional) Jumlah maksimum AWS Cloud permintaan untuk mengantri sebelum komponen ini menolak permintaan. Default: `100` `maxConcurrentCloudRequests` (Opsional) Jumlah maksimum permintaan bersamaan untuk dikirim ke. AWS Cloud Anda dapat meningkatkan angka ini untuk meningkatkan kinerja otentikasi pada perangkat inti tempat Anda menghubungkan sejumlah besar perangkat klien. Default: `1` `certificateAuthority` (Opsional) Opsi konfigurasi otoritas sertifikat untuk mengganti otoritas perantara perangkat inti dengan otoritas sertifikat perantara Anda sendiri. Objek ini berisi informasi berikut. Objek ini berisi informasi berikut: CertificateURI Lokasi sertifikat. Ini bisa berupa URI sistem file atau URI yang menunjuk ke sertifikat yang disimpan dalam modul keamanan perangkat keras. `certificateChainUri` Lokasi rantai sertifikat untuk perangkat inti CA. Ini harus menjadi rantai sertifikat lengkap kembali ke CA root Anda. Ini bisa berupa URI sistem file atau URI yang menunjuk ke rantai sertifikat yang disimpan dalam modul keamanan perangkat keras. `privateKeyUri` Lokasi kunci pribadi perangkat inti. Ini bisa berupa URI sistem file atau URI yang menunjuk ke kunci pribadi sertifikat yang disimpan dalam modul keamanan perangkat keras. `security` (Opsional) Opsi konfigurasi keamanan untuk perangkat inti ini. Objek ini berisi informasi berikut. `clientDeviceTrustDurationMinutes` Durasi dalam hitungan menit bahwa informasi otentikasi perangkat klien dapat dipercaya sebelum diperlukan untuk mengautentikasi ulang dengan perangkat inti. Nilai default adalah 1. `metrics` (Opsional) Opsi metrik untuk perangkat inti ini. Metrik kesalahan hanya akan ditampilkan jika ada kesalahan dengan autentikasi perangkat klien. Objek ini berisi informasi berikut: `disableMetrics` Jika `disableMetrics` bidang disetel sebagai`true`, autentikasi perangkat klien tidak akan mengumpulkan metrik. Default: `false` `aggregatePeriodSeconds` Periode agregasi dalam hitungan detik yang menentukan seberapa sering autentikasi perangkat klien mengumpulkan metrik dan mengirimkannya ke agen telemetri. Ini tidak mengubah seberapa sering metrik diterbitkan karena agen telemetri masih menerbitkannya sekali sehari. Default: `3600` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan yang ketat)** Contoh konfigurasi berikut menentukan untuk memungkinkan perangkat klien yang namanya dimulai dengan `MyClientDevice` untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyDeviceGroup": { "selectionRule": "thingName: MyClientDevice*", "policyName": "MyRestrictivePolicy" } }, "policies": { "MyRestrictivePolicy": { "AllowConnect": { "statementDescription": "Allow client devices to connect.", "operations": [ "mqtt:connect" ], "resources": [ "*" ] }, "AllowPublish": { "statementDescription": "Allow client devices to publish on test/topic.", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:test/topic" ] }, "AllowSubscribe": { "statementDescription": "Allow client devices to subscribe to test/topic/response.", "operations": [ "mqtt:subscribe" ], "resources": [ "mqtt:topicfilter:test/topic/response" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan permisif)** Contoh konfigurasi berikut menentukan untuk memungkinkan semua perangkat klien untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyPermissiveDeviceGroup": { "selectionRule": "thingName: *", "policyName": "MyPermissivePolicy" } }, "policies": { "MyPermissivePolicy": { "AllowAll": { "statementDescription": "Allow client devices to perform all actions.", "operations": [ "*" ], "resources": [ "*" ] } } } } } ``` ------ #### [ v2.3.x ] `deviceGroups` Grup perangkat adalah grup perangkat klien yang memiliki izin untuk menyambung dan berkomunikasi dengan perangkat inti. Gunakan aturan pemilihan untuk mengidentifikasi grup perangkat klien, dan menentukan *kebijakan otorisasi perangkat klien* yang menentukan izin untuk setiap grup perangkat. Objek ini berisi informasi berikut: `formatVersion` Versi format untuk objek konfigurasi ini. Pilih dari salah satu pilihan berikut: + `2021-03-05` `definitions` grup perangkat untuk perangkat inti ini. Setiap definisi menentukan *aturan pemilihan* untuk mengevaluasi apakah perangkat klien adalah anggota grup. Setiap definisi juga menentukan kebijakan izin yang akan diterapkan ke perangkat klien yang cocok dengan aturan pemilihan. Jika perangkat klien adalah anggota dari beberapa grup perangkat, izin perangkat terdiri dari kebijakan izin masing-masing grup. Objek ini berisi informasi berikut: `groupNameKey` Nama grup perangkat ini. Ganti *groupNameKey* dengan nama yang membantu Anda mengidentifikasi grup perangkat ini. Objek ini berisi informasi berikut: `selectionRule` Kueri yang menentukan perangkat klien mana yang menjadi anggota grup perangkat ini. Saat perangkat klien terhubung, perangkat inti mengevaluasi aturan pemilihan ini untuk menentukan apakah perangkat klien adalah anggota grup perangkat ini. Jika perangkat klien adalah anggota, perangkat inti akan menggunakan kebijakan grup perangkat ini untuk mengotorisasi tindakan perangkat klien. Setiap aturan pemilihan terdiri dari setidaknya satu *klausa aturan pemilihan*, yang merupakan kueri ekspresi tunggal yang dapat mencocokkan perangkat klien. Aturan pemilihan menggunakan sintaks kueri yang sama dengan pengindeksan AWS IoT armada. *Untuk informasi selengkapnya tentang sintaks aturan pemilihan, lihat sintaks [kueri pengindeksan AWS IoT armada di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) Pengembang.AWS IoT Core * Gunakan wildcard `*` untuk mencocokkan beberapa perangkat klien dengan satu pilihan klausul aturan. Anda dapat menggunakan wildcard ini di akhir nama objek untuk mencocokkan perangkat klien yang namanya dimulai dengan string yang Anda tentukan. Anda juga dapat menggunakan wildcard ini untuk mencocokkan semua perangkat klien. Untuk memilih nilai yang berisi karakter titik dua (`:`), lepaskan titik dua dengan karakter garis miring terbalik (`\\`). Dalam format seperti JSON, Anda harus melepaskan karakter ris miring terbalik, sehingga Anda memasukkan dua karakter ris miring terbalik sebelum karakter titik dua. Sebagai contoh, tentukan `thingName: MyTeam\\\\:ClientDevice1` untuk memilih objek yang namanya `MyTeam:ClientDevice1`. Anda dapat menentukan sebagai berikut: + `thingName` — Nama objek AWS IoT perangkat klien. **Example Contoh aturan pemilihan** Aturan seleksi berikut cocok dengan perangkat klien yang namanya `MyClientDevice1` atau `MyClientDevice2`. ``` thingName: MyClientDevice1 OR thingName: MyClientDevice2 ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan seleksi berikut cocok dengan perangkat klien yang namanya dimulai dengan `MyClientDevice`. ``` thingName: MyClientDevice* ``` **Example Contoh aturan pemilihan (cocok dengan semua perangkat)** Aturan seleksi berikut cocok dengan semua perangkat klien. ``` thingName: * ``` `policyName` Kebijakan izin yang berlaku untuk perangkat klien dalam grup perangkat ini. Tentukan nama kebijakan yang Anda tetapkan di objek `policies`. `policies` Kebijakan otorisasi perangkat klien untuk perangkat klien yang terhubung ke perangkat inti. Setiap kebijakan otorisasi menentukan serangkaian tindakan dan sumber daya tempat perangkat klien dapat melakukan tindakan tersebut. Objek ini berisi informasi berikut: `policyNameKey` Nama kebijakan otorisasi ini. Ganti *policyNameKey* dengan nama yang membantu Anda mengidentifikasi kebijakan otorisasi ini. Anda menggunakan nama kebijakan ini untuk menentukan kebijakan yang berlaku untuk grup perangkat. Objek ini berisi informasi berikut: `statementNameKey` Nama pernyataan kebijakan ini. Ganti *statementNameKey* dengan nama yang membantu Anda mengidentifikasi pernyataan kebijakan ini. Objek ini berisi informasi berikut: `operations` Daftar operasi untuk mengizinkan sumber daya dalam kebijakan ini. Anda dapat menyertakan salah satu dari operasi berikut: + `mqtt:connect` — Memberikan izin untuk terhubung ke perangkat inti. Perangkat klien harus memiliki izin ini untuk menyambung ke perangkat inti. Operasi ini mendukung sumber daya berikut: + `mqtt:clientId:deviceClientId` — Batasi akses berdasarkan ID klien yang digunakan perangkat klien untuk terhubung ke broker MQTT perangkat inti. Ganti *deviceClientId* dengan ID klien yang akan digunakan. + `mqtt:publish` — Memberikan izin untuk mempublikasikan pesan MQTT ke topik. Operasi ini mendukung sumber daya berikut: + `mqtt:topic:mqttTopic` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopic* dengan topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. + `mqtt:subscribe` — Memberikan izin untuk berlangganan filter topik MQTT untuk menerima pesan. Operasi ini mendukung sumber daya berikut: + `mqtt:topicfilter:mqttTopicFilter` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopicFilter* dengan filter topik yang akan digunakan. Sumber daya ini mendukung wildcard topik MQTT `+` dan `#`. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. Perangkat klien dapat berlangganan filter topik yang tepat yang Anda izinkan. Misalnya, jika Anda mengizinkan perangkat klien untuk berlangganan sumber daya `mqtt:topicfilter:client/+/status`, perangkat klien dapat berlangganan `client/+/status` tetapi bukan `client/client1/status`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua tindakan. `resources` Daftar operasi yang akan mengizinkan sumber daya dalam kebijakan ini. Tentukan sumber daya yang sesuai dengan operasi dalam kebijakan ini. Misalnya, Anda dapat menentukan daftar sumber daya topik MQTT (`mqtt:topic:mqttTopic`) dalam kebijakan yang menentukan operasi `mqtt:publish`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua sumber daya. Anda tidak dapat menggunakan wildcard `*` untuk mencocokkan pengidentifikasi sumber daya parsial. Misalnya, Anda dapat menentukan **"resources": "\$1"**, tetapi Anda tidak dapat menentukan **"resources": "mqtt:clientId:\$1"**. `statementDescription` (Opsional) Deskripsi untuk pernyataan kebijakan ini. `certificates` (Opsional) Opsi konfigurasi sertifikat untuk perangkat inti ini. Objek ini berisi informasi berikut: `serverCertificateValiditySeconds` (Opsional) Jumlah waktu (dalam detik) setelah sertifikat server MQTT lokal kedaluwarsa. Anda dapat mengonfigurasi opsi ini untuk menyesuaikan seberapa sering perangkat klien memutuskan sambungan dan menyambung kembali ke perangkat inti. Komponen ini memutar sertifikat server MQTT lokal 24 jam sebelum kedaluwarsa. Broker MQTT, seperti [komponen broker Moquette MQTT](mqtt-broker-moquette-component.md), menghasilkan sertifikat baru dan memulai ulang. Ketika ini terjadi, semua perangkat klien yang terhubung ke perangkat inti ini terputus. Perangkat klien dapat terhubung kembali ke perangkat inti setelah periode waktu yang singkat. Default: `604800` (7 hari) Nilai minimum: `172800` (2 hari) Nilai maksimum: `864000` (10 hari) `performance` (Opsional) Opsi konfigurasi kinerja untuk perangkat inti ini. Objek ini berisi informasi berikut: `maxActiveAuthTokens` (Opsional) Jumlah maksimum token otorisasi perangkat klien aktif. Anda dapat meningkatkan jumlah ini untuk mengaktifkan lebih banyak perangkat klien untuk terhubung ke perangkat inti tunggal tanpa mengautentikasi ulang mereka. Default: `2500` `cloudRequestQueueSize` (Opsional) Jumlah maksimum AWS Cloud permintaan untuk mengantri sebelum komponen ini menolak permintaan. Default: `100` `maxConcurrentCloudRequests` (Opsional) Jumlah maksimum permintaan bersamaan untuk dikirim ke. AWS Cloud Anda dapat meningkatkan angka ini untuk meningkatkan kinerja otentikasi pada perangkat inti tempat Anda menghubungkan sejumlah besar perangkat klien. Default: `1` `certificateAuthority` (Opsional) Opsi konfigurasi otoritas sertifikat untuk mengganti otoritas perantara perangkat inti dengan otoritas sertifikat perantara Anda sendiri. Objek ini berisi informasi berikut. CertificateURI Lokasi sertifikat. Ini bisa berupa URI sistem file atau URI yang menunjuk ke sertifikat yang disimpan dalam modul keamanan perangkat keras. `certificateChainUri` Lokasi rantai sertifikat untuk perangkat inti CA. Ini harus menjadi rantai sertifikat lengkap kembali ke CA root Anda. Ini bisa berupa URI sistem file atau URI yang menunjuk ke rantai sertifikat yang disimpan dalam modul keamanan perangkat keras. `privateKeyUri` Lokasi kunci pribadi perangkat inti. Ini bisa berupa URI sistem file atau URI yang menunjuk ke kunci pribadi sertifikat yang disimpan dalam modul keamanan perangkat keras. `security` (Opsional) Opsi konfigurasi keamanan untuk perangkat inti ini. Objek ini berisi informasi berikut. `clientDeviceTrustDurationMinutes` Durasi dalam hitungan menit bahwa informasi otentikasi perangkat klien dapat dipercaya sebelum diperlukan untuk mengautentikasi ulang dengan perangkat inti. Nilai default adalah 1. **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan yang ketat)** Contoh konfigurasi berikut menentukan untuk memungkinkan perangkat klien yang namanya dimulai dengan `MyClientDevice` untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyDeviceGroup": { "selectionRule": "thingName: MyClientDevice*", "policyName": "MyRestrictivePolicy" } }, "policies": { "MyRestrictivePolicy": { "AllowConnect": { "statementDescription": "Allow client devices to connect.", "operations": [ "mqtt:connect" ], "resources": [ "*" ] }, "AllowPublish": { "statementDescription": "Allow client devices to publish on test/topic.", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:test/topic" ] }, "AllowSubscribe": { "statementDescription": "Allow client devices to subscribe to test/topic/response.", "operations": [ "mqtt:subscribe" ], "resources": [ "mqtt:topicfilter:test/topic/response" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan permisif)** Contoh konfigurasi berikut menentukan untuk memungkinkan semua perangkat klien untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyPermissiveDeviceGroup": { "selectionRule": "thingName: *", "policyName": "MyPermissivePolicy" } }, "policies": { "MyPermissivePolicy": { "AllowAll": { "statementDescription": "Allow client devices to perform all actions.", "operations": [ "*" ], "resources": [ "*" ] } } } } } ``` ------ #### [ v2.2.x ] `deviceGroups` Grup perangkat adalah grup perangkat klien yang memiliki izin untuk menyambung dan berkomunikasi dengan perangkat inti. Gunakan aturan pemilihan untuk mengidentifikasi grup perangkat klien, dan menentukan *kebijakan otorisasi perangkat klien* yang menentukan izin untuk setiap grup perangkat. Objek ini berisi informasi berikut: `formatVersion` Versi format untuk objek konfigurasi ini. Pilih dari salah satu pilihan berikut: + `2021-03-05` `definitions` grup perangkat untuk perangkat inti ini. Setiap definisi menentukan *aturan pemilihan* untuk mengevaluasi apakah perangkat klien adalah anggota grup. Setiap definisi juga menentukan kebijakan izin yang akan diterapkan ke perangkat klien yang cocok dengan aturan pemilihan. Jika perangkat klien adalah anggota dari beberapa grup perangkat, izin perangkat terdiri dari kebijakan izin masing-masing grup. Objek ini berisi informasi berikut: `groupNameKey` Nama grup perangkat ini. Ganti *groupNameKey* dengan nama yang membantu Anda mengidentifikasi grup perangkat ini. Objek ini berisi informasi berikut: `selectionRule` Kueri yang menentukan perangkat klien mana yang menjadi anggota grup perangkat ini. Saat perangkat klien terhubung, perangkat inti mengevaluasi aturan pemilihan ini untuk menentukan apakah perangkat klien adalah anggota grup perangkat ini. Jika perangkat klien adalah anggota, perangkat inti akan menggunakan kebijakan grup perangkat ini untuk mengotorisasi tindakan perangkat klien. Setiap aturan pemilihan terdiri dari setidaknya satu *klausa aturan pemilihan*, yang merupakan kueri ekspresi tunggal yang dapat mencocokkan perangkat klien. Aturan pemilihan menggunakan sintaks kueri yang sama dengan pengindeksan AWS IoT armada. *Untuk informasi selengkapnya tentang sintaks aturan pemilihan, lihat sintaks [kueri pengindeksan AWS IoT armada di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) Pengembang.AWS IoT Core * Gunakan wildcard `*` untuk mencocokkan beberapa perangkat klien dengan satu pilihan klausul aturan. Anda dapat menggunakan wildcard ini di akhir nama objek untuk mencocokkan perangkat klien yang namanya dimulai dengan string yang Anda tentukan. Anda juga dapat menggunakan wildcard ini untuk mencocokkan semua perangkat klien. Untuk memilih nilai yang berisi karakter titik dua (`:`), lepaskan titik dua dengan karakter garis miring terbalik (`\\`). Dalam format seperti JSON, Anda harus melepaskan karakter ris miring terbalik, sehingga Anda memasukkan dua karakter ris miring terbalik sebelum karakter titik dua. Sebagai contoh, tentukan `thingName: MyTeam\\\\:ClientDevice1` untuk memilih objek yang namanya `MyTeam:ClientDevice1`. Anda dapat menentukan sebagai berikut: + `thingName` — Nama objek AWS IoT perangkat klien. **Example Contoh aturan pemilihan** Aturan seleksi berikut cocok dengan perangkat klien yang namanya `MyClientDevice1` atau `MyClientDevice2`. ``` thingName: MyClientDevice1 OR thingName: MyClientDevice2 ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan seleksi berikut cocok dengan perangkat klien yang namanya dimulai dengan `MyClientDevice`. ``` thingName: MyClientDevice* ``` **Example Contoh aturan pemilihan (cocok dengan semua perangkat)** Aturan seleksi berikut cocok dengan semua perangkat klien. ``` thingName: * ``` `policyName` Kebijakan izin yang berlaku untuk perangkat klien dalam grup perangkat ini. Tentukan nama kebijakan yang Anda tetapkan di objek `policies`. `policies` Kebijakan otorisasi perangkat klien untuk perangkat klien yang terhubung ke perangkat inti. Setiap kebijakan otorisasi menentukan serangkaian tindakan dan sumber daya tempat perangkat klien dapat melakukan tindakan tersebut. Objek ini berisi informasi berikut: `policyNameKey` Nama kebijakan otorisasi ini. Ganti *policyNameKey* dengan nama yang membantu Anda mengidentifikasi kebijakan otorisasi ini. Anda menggunakan nama kebijakan ini untuk menentukan kebijakan yang berlaku untuk grup perangkat. Objek ini berisi informasi berikut: `statementNameKey` Nama pernyataan kebijakan ini. Ganti *statementNameKey* dengan nama yang membantu Anda mengidentifikasi pernyataan kebijakan ini. Objek ini berisi informasi berikut: `operations` Daftar operasi untuk mengizinkan sumber daya dalam kebijakan ini. Anda dapat menyertakan salah satu dari operasi berikut: + `mqtt:connect` — Memberikan izin untuk terhubung ke perangkat inti. Perangkat klien harus memiliki izin ini untuk menyambung ke perangkat inti. Operasi ini mendukung sumber daya berikut: + `mqtt:clientId:deviceClientId` — Batasi akses berdasarkan ID klien yang digunakan perangkat klien untuk terhubung ke broker MQTT perangkat inti. Ganti *deviceClientId* dengan ID klien yang akan digunakan. + `mqtt:publish` — Memberikan izin untuk mempublikasikan pesan MQTT ke topik. Operasi ini mendukung sumber daya berikut: + `mqtt:topic:mqttTopic` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopic* dengan topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. + `mqtt:subscribe` — Memberikan izin untuk berlangganan filter topik MQTT untuk menerima pesan. Operasi ini mendukung sumber daya berikut: + `mqtt:topicfilter:mqttTopicFilter` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopicFilter* dengan filter topik yang akan digunakan. Sumber daya ini mendukung wildcard topik MQTT `+` dan `#`. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. Perangkat klien dapat berlangganan filter topik yang tepat yang Anda izinkan. Misalnya, jika Anda mengizinkan perangkat klien untuk berlangganan sumber daya `mqtt:topicfilter:client/+/status`, perangkat klien dapat berlangganan `client/+/status` tetapi bukan `client/client1/status`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua tindakan. `resources` Daftar operasi yang akan mengizinkan sumber daya dalam kebijakan ini. Tentukan sumber daya yang sesuai dengan operasi dalam kebijakan ini. Misalnya, Anda dapat menentukan daftar sumber daya topik MQTT (`mqtt:topic:mqttTopic`) dalam kebijakan yang menentukan operasi `mqtt:publish`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua sumber daya. Anda tidak dapat menggunakan wildcard `*` untuk mencocokkan pengidentifikasi sumber daya parsial. Misalnya, Anda dapat menentukan **"resources": "\$1"**, tetapi Anda tidak dapat menentukan **"resources": "mqtt:clientId:\$1"**. `statementDescription` (Opsional) Deskripsi untuk pernyataan kebijakan ini. `certificates` (Opsional) Opsi konfigurasi sertifikat untuk perangkat inti ini. Objek ini berisi informasi berikut: `serverCertificateValiditySeconds` (Opsional) Jumlah waktu (dalam detik) setelah sertifikat server MQTT lokal kedaluwarsa. Anda dapat mengonfigurasi opsi ini untuk menyesuaikan seberapa sering perangkat klien memutuskan sambungan dan menyambung kembali ke perangkat inti. Komponen ini memutar sertifikat server MQTT lokal 24 jam sebelum kedaluwarsa. Broker MQTT, seperti [komponen broker Moquette MQTT](mqtt-broker-moquette-component.md), menghasilkan sertifikat baru dan memulai ulang. Ketika ini terjadi, semua perangkat klien yang terhubung ke perangkat inti ini terputus. Perangkat klien dapat terhubung kembali ke perangkat inti setelah periode waktu yang singkat. Default: `604800` (7 hari) Nilai minimum: `172800` (2 hari) Nilai maksimum: `864000` (10 hari) `performance` (Opsional) Opsi konfigurasi kinerja untuk perangkat inti ini. Objek ini berisi informasi berikut: `maxActiveAuthTokens` (Opsional) Jumlah maksimum token otorisasi perangkat klien aktif. Anda dapat meningkatkan jumlah ini untuk mengaktifkan lebih banyak perangkat klien untuk terhubung ke perangkat inti tunggal tanpa mengautentikasi ulang mereka. Default: `2500` `cloudRequestQueueSize` (Opsional) Jumlah maksimum AWS Cloud permintaan untuk mengantri sebelum komponen ini menolak permintaan. Default: `100` `maxConcurrentCloudRequests` (Opsional) Jumlah maksimum permintaan bersamaan untuk dikirim ke. AWS Cloud Anda dapat meningkatkan angka ini untuk meningkatkan kinerja otentikasi pada perangkat inti tempat Anda menghubungkan sejumlah besar perangkat klien. Default: `1` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan yang ketat)** Contoh konfigurasi berikut menentukan untuk memungkinkan perangkat klien yang namanya dimulai dengan `MyClientDevice` untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyDeviceGroup": { "selectionRule": "thingName: MyClientDevice*", "policyName": "MyRestrictivePolicy" } }, "policies": { "MyRestrictivePolicy": { "AllowConnect": { "statementDescription": "Allow client devices to connect.", "operations": [ "mqtt:connect" ], "resources": [ "*" ] }, "AllowPublish": { "statementDescription": "Allow client devices to publish on test/topic.", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:test/topic" ] }, "AllowSubscribe": { "statementDescription": "Allow client devices to subscribe to test/topic/response.", "operations": [ "mqtt:subscribe" ], "resources": [ "mqtt:topicfilter:test/topic/response" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan permisif)** Contoh konfigurasi berikut menentukan untuk memungkinkan semua perangkat klien untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyPermissiveDeviceGroup": { "selectionRule": "thingName: *", "policyName": "MyPermissivePolicy" } }, "policies": { "MyPermissivePolicy": { "AllowAll": { "statementDescription": "Allow client devices to perform all actions.", "operations": [ "*" ], "resources": [ "*" ] } } } } } ``` ------ #### [ v2.1.x ] `deviceGroups` Grup perangkat adalah grup perangkat klien yang memiliki izin untuk menyambung dan berkomunikasi dengan perangkat inti. Gunakan aturan pemilihan untuk mengidentifikasi grup perangkat klien, dan menentukan *kebijakan otorisasi perangkat klien* yang menentukan izin untuk setiap grup perangkat. Objek ini berisi informasi berikut: `formatVersion` Versi format untuk objek konfigurasi ini. Pilih dari salah satu pilihan berikut: + `2021-03-05` `definitions` grup perangkat untuk perangkat inti ini. Setiap definisi menentukan *aturan pemilihan* untuk mengevaluasi apakah perangkat klien adalah anggota grup. Setiap definisi juga menentukan kebijakan izin yang akan diterapkan ke perangkat klien yang cocok dengan aturan pemilihan. Jika perangkat klien adalah anggota dari beberapa grup perangkat, izin perangkat terdiri dari kebijakan izin masing-masing grup. Objek ini berisi informasi berikut: `groupNameKey` Nama grup perangkat ini. Ganti *groupNameKey* dengan nama yang membantu Anda mengidentifikasi grup perangkat ini. Objek ini berisi informasi berikut: `selectionRule` Kueri yang menentukan perangkat klien mana yang menjadi anggota grup perangkat ini. Saat perangkat klien terhubung, perangkat inti mengevaluasi aturan pemilihan ini untuk menentukan apakah perangkat klien adalah anggota grup perangkat ini. Jika perangkat klien adalah anggota, perangkat inti akan menggunakan kebijakan grup perangkat ini untuk mengotorisasi tindakan perangkat klien. Setiap aturan pemilihan terdiri dari setidaknya satu *klausa aturan pemilihan*, yang merupakan kueri ekspresi tunggal yang dapat mencocokkan perangkat klien. Aturan pemilihan menggunakan sintaks kueri yang sama dengan pengindeksan AWS IoT armada. *Untuk informasi selengkapnya tentang sintaks aturan pemilihan, lihat sintaks [kueri pengindeksan AWS IoT armada di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) Pengembang.AWS IoT Core * Gunakan wildcard `*` untuk mencocokkan beberapa perangkat klien dengan satu pilihan klausul aturan. Anda dapat menggunakan wildcard ini di akhir nama objek untuk mencocokkan perangkat klien yang namanya dimulai dengan string yang Anda tentukan. Anda juga dapat menggunakan wildcard ini untuk mencocokkan semua perangkat klien. Untuk memilih nilai yang berisi karakter titik dua (`:`), lepaskan titik dua dengan karakter garis miring terbalik (`\\`). Dalam format seperti JSON, Anda harus melepaskan karakter ris miring terbalik, sehingga Anda memasukkan dua karakter ris miring terbalik sebelum karakter titik dua. Sebagai contoh, tentukan `thingName: MyTeam\\\\:ClientDevice1` untuk memilih objek yang namanya `MyTeam:ClientDevice1`. Anda dapat menentukan sebagai berikut: + `thingName` — Nama objek AWS IoT perangkat klien. **Example Contoh aturan pemilihan** Aturan seleksi berikut cocok dengan perangkat klien yang namanya `MyClientDevice1` atau `MyClientDevice2`. ``` thingName: MyClientDevice1 OR thingName: MyClientDevice2 ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan seleksi berikut cocok dengan perangkat klien yang namanya dimulai dengan `MyClientDevice`. ``` thingName: MyClientDevice* ``` **Example Contoh aturan pemilihan (cocok dengan semua perangkat)** Aturan seleksi berikut cocok dengan semua perangkat klien. ``` thingName: * ``` `policyName` Kebijakan izin yang berlaku untuk perangkat klien dalam grup perangkat ini. Tentukan nama kebijakan yang Anda tetapkan di objek `policies`. `policies` Kebijakan otorisasi perangkat klien untuk perangkat klien yang terhubung ke perangkat inti. Setiap kebijakan otorisasi menentukan serangkaian tindakan dan sumber daya tempat perangkat klien dapat melakukan tindakan tersebut. Objek ini berisi informasi berikut: `policyNameKey` Nama kebijakan otorisasi ini. Ganti *policyNameKey* dengan nama yang membantu Anda mengidentifikasi kebijakan otorisasi ini. Anda menggunakan nama kebijakan ini untuk menentukan kebijakan yang berlaku untuk grup perangkat. Objek ini berisi informasi berikut: `statementNameKey` Nama pernyataan kebijakan ini. Ganti *statementNameKey* dengan nama yang membantu Anda mengidentifikasi pernyataan kebijakan ini. Objek ini berisi informasi berikut: `operations` Daftar operasi untuk mengizinkan sumber daya dalam kebijakan ini. Anda dapat menyertakan salah satu dari operasi berikut: + `mqtt:connect` — Memberikan izin untuk terhubung ke perangkat inti. Perangkat klien harus memiliki izin ini untuk menyambung ke perangkat inti. Operasi ini mendukung sumber daya berikut: + `mqtt:clientId:deviceClientId` — Batasi akses berdasarkan ID klien yang digunakan perangkat klien untuk terhubung ke broker MQTT perangkat inti. Ganti *deviceClientId* dengan ID klien yang akan digunakan. + `mqtt:publish` — Memberikan izin untuk mempublikasikan pesan MQTT ke topik. Operasi ini mendukung sumber daya berikut: + `mqtt:topic:mqttTopic` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopic* dengan topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. + `mqtt:subscribe` — Memberikan izin untuk berlangganan filter topik MQTT untuk menerima pesan. Operasi ini mendukung sumber daya berikut: + `mqtt:topicfilter:mqttTopicFilter` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopicFilter* dengan filter topik yang akan digunakan. Sumber daya ini mendukung wildcard topik MQTT `+` dan `#`. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. Perangkat klien dapat berlangganan filter topik yang tepat yang Anda izinkan. Misalnya, jika Anda mengizinkan perangkat klien untuk berlangganan sumber daya `mqtt:topicfilter:client/+/status`, perangkat klien dapat berlangganan `client/+/status` tetapi bukan `client/client1/status`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua tindakan. `resources` Daftar operasi yang akan mengizinkan sumber daya dalam kebijakan ini. Tentukan sumber daya yang sesuai dengan operasi dalam kebijakan ini. Misalnya, Anda dapat menentukan daftar sumber daya topik MQTT (`mqtt:topic:mqttTopic`) dalam kebijakan yang menentukan operasi `mqtt:publish`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua sumber daya. Anda tidak dapat menggunakan wildcard `*` untuk mencocokkan pengidentifikasi sumber daya parsial. Misalnya, Anda dapat menentukan **"resources": "\$1"**, tetapi Anda tidak dapat menentukan **"resources": "mqtt:clientId:\$1"**. `statementDescription` (Opsional) Deskripsi untuk pernyataan kebijakan ini. `certificates` (Opsional) Opsi konfigurasi sertifikat untuk perangkat inti ini. Objek ini berisi informasi berikut: `serverCertificateValiditySeconds` (Opsional) Jumlah waktu (dalam detik) setelah sertifikat server MQTT lokal kedaluwarsa. Anda dapat mengonfigurasi opsi ini untuk menyesuaikan seberapa sering perangkat klien memutuskan sambungan dan menyambung kembali ke perangkat inti. Komponen ini memutar sertifikat server MQTT lokal 24 jam sebelum kedaluwarsa. Broker MQTT, seperti [komponen broker Moquette MQTT](mqtt-broker-moquette-component.md), menghasilkan sertifikat baru dan memulai ulang. Ketika ini terjadi, semua perangkat klien yang terhubung ke perangkat inti ini terputus. Perangkat klien dapat terhubung kembali ke perangkat inti setelah periode waktu yang singkat. Default: `604800` (7 hari) Nilai minimum: `172800` (2 hari) Nilai maksimum: `864000` (10 hari) **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan yang ketat)** Contoh konfigurasi berikut menentukan untuk memungkinkan perangkat klien yang namanya dimulai dengan `MyClientDevice` untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyDeviceGroup": { "selectionRule": "thingName: MyClientDevice*", "policyName": "MyRestrictivePolicy" } }, "policies": { "MyRestrictivePolicy": { "AllowConnect": { "statementDescription": "Allow client devices to connect.", "operations": [ "mqtt:connect" ], "resources": [ "*" ] }, "AllowPublish": { "statementDescription": "Allow client devices to publish on test/topic.", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:test/topic" ] }, "AllowSubscribe": { "statementDescription": "Allow client devices to subscribe to test/topic/response.", "operations": [ "mqtt:subscribe" ], "resources": [ "mqtt:topicfilter:test/topic/response" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan permisif)** Contoh konfigurasi berikut menentukan untuk memungkinkan semua perangkat klien untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyPermissiveDeviceGroup": { "selectionRule": "thingName: *", "policyName": "MyPermissivePolicy" } }, "policies": { "MyPermissivePolicy": { "AllowAll": { "statementDescription": "Allow client devices to perform all actions.", "operations": [ "*" ], "resources": [ "*" ] } } } } } ``` ------ #### [ v2.0.x ] `deviceGroups` Grup perangkat adalah grup perangkat klien yang memiliki izin untuk menyambung dan berkomunikasi dengan perangkat inti. Gunakan aturan pemilihan untuk mengidentifikasi grup perangkat klien, dan menentukan *kebijakan otorisasi perangkat klien* yang menentukan izin untuk setiap grup perangkat. Objek ini berisi informasi berikut: `formatVersion` Versi format untuk objek konfigurasi ini. Pilih dari salah satu pilihan berikut: + `2021-03-05` `definitions` grup perangkat untuk perangkat inti ini. Setiap definisi menentukan *aturan pemilihan* untuk mengevaluasi apakah perangkat klien adalah anggota grup. Setiap definisi juga menentukan kebijakan izin yang akan diterapkan ke perangkat klien yang cocok dengan aturan pemilihan. Jika perangkat klien adalah anggota dari beberapa grup perangkat, izin perangkat terdiri dari kebijakan izin masing-masing grup. Objek ini berisi informasi berikut: `groupNameKey` Nama grup perangkat ini. Ganti *groupNameKey* dengan nama yang membantu Anda mengidentifikasi grup perangkat ini. Objek ini berisi informasi berikut: `selectionRule` Kueri yang menentukan perangkat klien mana yang menjadi anggota grup perangkat ini. Saat perangkat klien terhubung, perangkat inti mengevaluasi aturan pemilihan ini untuk menentukan apakah perangkat klien adalah anggota grup perangkat ini. Jika perangkat klien adalah anggota, perangkat inti akan menggunakan kebijakan grup perangkat ini untuk mengotorisasi tindakan perangkat klien. Setiap aturan pemilihan terdiri dari setidaknya satu *klausa aturan pemilihan*, yang merupakan kueri ekspresi tunggal yang dapat mencocokkan perangkat klien. Aturan pemilihan menggunakan sintaks kueri yang sama dengan pengindeksan AWS IoT armada. *Untuk informasi selengkapnya tentang sintaks aturan pemilihan, lihat sintaks [kueri pengindeksan AWS IoT armada di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) Pengembang.AWS IoT Core * Gunakan wildcard `*` untuk mencocokkan beberapa perangkat klien dengan satu pilihan klausul aturan. Anda dapat menggunakan wildcard ini di akhir nama objek untuk mencocokkan perangkat klien yang namanya dimulai dengan string yang Anda tentukan. Anda juga dapat menggunakan wildcard ini untuk mencocokkan semua perangkat klien. Untuk memilih nilai yang berisi karakter titik dua (`:`), lepaskan titik dua dengan karakter garis miring terbalik (`\\`). Dalam format seperti JSON, Anda harus melepaskan karakter ris miring terbalik, sehingga Anda memasukkan dua karakter ris miring terbalik sebelum karakter titik dua. Sebagai contoh, tentukan `thingName: MyTeam\\\\:ClientDevice1` untuk memilih objek yang namanya `MyTeam:ClientDevice1`. Anda dapat menentukan sebagai berikut: + `thingName` — Nama objek AWS IoT perangkat klien. **Example Contoh aturan pemilihan** Aturan seleksi berikut cocok dengan perangkat klien yang namanya `MyClientDevice1` atau `MyClientDevice2`. ``` thingName: MyClientDevice1 OR thingName: MyClientDevice2 ``` **Example Contoh aturan seleksi (gunakan wildcard)** Aturan seleksi berikut cocok dengan perangkat klien yang namanya dimulai dengan `MyClientDevice`. ``` thingName: MyClientDevice* ``` **Example Contoh aturan pemilihan (cocok dengan semua perangkat)** Aturan seleksi berikut cocok dengan semua perangkat klien. ``` thingName: * ``` `policyName` Kebijakan izin yang berlaku untuk perangkat klien dalam grup perangkat ini. Tentukan nama kebijakan yang Anda tetapkan di objek `policies`. `policies` Kebijakan otorisasi perangkat klien untuk perangkat klien yang terhubung ke perangkat inti. Setiap kebijakan otorisasi menentukan serangkaian tindakan dan sumber daya tempat perangkat klien dapat melakukan tindakan tersebut. Objek ini berisi informasi berikut: `policyNameKey` Nama kebijakan otorisasi ini. Ganti *policyNameKey* dengan nama yang membantu Anda mengidentifikasi kebijakan otorisasi ini. Anda menggunakan nama kebijakan ini untuk menentukan kebijakan yang berlaku untuk grup perangkat. Objek ini berisi informasi berikut: `statementNameKey` Nama pernyataan kebijakan ini. Ganti *statementNameKey* dengan nama yang membantu Anda mengidentifikasi pernyataan kebijakan ini. Objek ini berisi informasi berikut: `operations` Daftar operasi untuk mengizinkan sumber daya dalam kebijakan ini. Anda dapat menyertakan salah satu dari operasi berikut: + `mqtt:connect` — Memberikan izin untuk terhubung ke perangkat inti. Perangkat klien harus memiliki izin ini untuk menyambung ke perangkat inti. Operasi ini mendukung sumber daya berikut: + `mqtt:clientId:deviceClientId` — Batasi akses berdasarkan ID klien yang digunakan perangkat klien untuk terhubung ke broker MQTT perangkat inti. Ganti *deviceClientId* dengan ID klien yang akan digunakan. + `mqtt:publish` — Memberikan izin untuk mempublikasikan pesan MQTT ke topik. Operasi ini mendukung sumber daya berikut: + `mqtt:topic:mqttTopic` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopic* dengan topik yang akan digunakan. Sumber daya ini tidak mendukung wildcard topik MQTT. + `mqtt:subscribe` — Memberikan izin untuk berlangganan filter topik MQTT untuk menerima pesan. Operasi ini mendukung sumber daya berikut: + `mqtt:topicfilter:mqttTopicFilter` — Membatasi akses berdasarkan topik MQTT di mana perangkat klien menerbitkan pesan. Ganti *mqttTopicFilter* dengan filter topik yang akan digunakan. Sumber daya ini mendukung wildcard topik MQTT `+` dan `#`. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. Perangkat klien dapat berlangganan filter topik yang tepat yang Anda izinkan. Misalnya, jika Anda mengizinkan perangkat klien untuk berlangganan sumber daya `mqtt:topicfilter:client/+/status`, perangkat klien dapat berlangganan `client/+/status` tetapi bukan `client/client1/status`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua tindakan. `resources` Daftar operasi yang akan mengizinkan sumber daya dalam kebijakan ini. Tentukan sumber daya yang sesuai dengan operasi dalam kebijakan ini. Misalnya, Anda dapat menentukan daftar sumber daya topik MQTT (`mqtt:topic:mqttTopic`) dalam kebijakan yang menentukan operasi `mqtt:publish`. Anda dapat menentukan wildcard `*` untuk mengizinkan akses ke semua sumber daya. Anda tidak dapat menggunakan wildcard `*` untuk mencocokkan pengidentifikasi sumber daya parsial. Misalnya, Anda dapat menentukan **"resources": "\$1"**, tetapi Anda tidak dapat menentukan **"resources": "mqtt:clientId:\$1"**. `statementDescription` (Opsional) Deskripsi untuk pernyataan kebijakan ini. **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan yang ketat)** Contoh konfigurasi berikut menentukan untuk memungkinkan perangkat klien yang namanya dimulai dengan `MyClientDevice` untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyDeviceGroup": { "selectionRule": "thingName: MyClientDevice*", "policyName": "MyRestrictivePolicy" } }, "policies": { "MyRestrictivePolicy": { "AllowConnect": { "statementDescription": "Allow client devices to connect.", "operations": [ "mqtt:connect" ], "resources": [ "*" ] }, "AllowPublish": { "statementDescription": "Allow client devices to publish on test/topic.", "operations": [ "mqtt:publish" ], "resources": [ "mqtt:topic:test/topic" ] }, "AllowSubscribe": { "statementDescription": "Allow client devices to subscribe to test/topic/response.", "operations": [ "mqtt:subscribe" ], "resources": [ "mqtt:topicfilter:test/topic/response" ] } } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (menggunakan kebijakan permisif)** Contoh konfigurasi berikut menentukan untuk memungkinkan semua perangkat klien untuk terhubung dan publish/subscribe pada semua topik. ``` { "deviceGroups": { "formatVersion": "2021-03-05", "definitions": { "MyPermissiveDeviceGroup": { "selectionRule": "thingName: *", "policyName": "MyPermissivePolicy" } }, "policies": { "MyPermissivePolicy": { "AllowAll": { "statementDescription": "Allow client devices to perform all actions.", "operations": [ "*" ], "resources": [ "*" ] } } } } } ``` ------ ## File log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.5.6 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.5.5 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.5.4 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.5.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.5.2 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.4.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.4.4 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.4.3 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.4.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.4.1 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.3.0 | Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. Fitur baru [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.2.3 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.2.1 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.0.4 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/client-device-auth-component.html) | | 2.0.2 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.0 | Versi awal. | # CloudWatch metrik Komponen CloudWatch metrik Amazon (`aws.greengrass.Cloudwatch`) menerbitkan metrik khusus dari perangkat inti Greengrass ke Amazon. CloudWatch Komponen ini memungkinkan komponen untuk mempublikasikan CloudWatch metrik, yang dapat Anda gunakan untuk memantau dan menganalisis lingkungan perangkat inti Greengrass. Untuk informasi selengkapnya, lihat [Menggunakan CloudWatch metrik](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/working_with_metrics.html) *Amazon di Panduan CloudWatch Pengguna Amazon*. Untuk memublikasikan CloudWatch metrik dengan komponen ini, terbitkan pesan ke topik tempat komponen ini berlangganan. Secara default, komponen ini berlangganan topik [publikasi/berlangganan lokal](ipc-publish-subscribe.md) `cloudwatch/metric/put`. Anda dapat menentukan topik lain, termasuk topik AWS IoT Core MQTT, saat Anda menerapkan komponen ini. Komponen ini mengumpulkan metrik yang berada di namespace yang sama dan menerbitkannya secara berkala. CloudWatch **catatan** Komponen ini menyediakan fungsionalitas yang mirip dengan konektor CloudWatch metrik di AWS IoT Greengrass V1. Untuk informasi selengkapnya, lihat [konektor CloudWatch metrik](https://docs.aws.amazon.com/greengrass/latest/developerguide/cloudwatch-metrics-connector.html) di Panduan *Pengembang AWS IoT Greengrass V1*. **Topics** + [Versi](#cloudwatch-metrics-component-versions) + [Tipe](#cloudwatch-metrics-component-type) + [Sistem operasi](#cloudwatch-metrics-component-os-support) + [Persyaratan](#cloudwatch-metrics-component-requirements) + [Dependensi](#cloudwatch-metrics-component-dependencies) + [Konfigurasi](#cloudwatch-metrics-component-configuration) + [Data input](#cloudwatch-metrics-component-input-data) + [Data output](#cloudwatch-metrics-component-output-data) + [Lisensi](#cloudwatch-metrics-component-licenses) + [Berkas log lokal](#cloudwatch-metrics-component-log-file) + [Changelog](#cloudwatch-metrics-component-changelog) + [Lihat juga](#cloudwatch-metrics-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 4.0.x + 3.2.x + 3.1.x + 3.0.x + 2.1.x + 2.0.x Untuk informasi tentang perubahan di setiap versi komponen, lihat [changelog](#cloudwatch-metrics-component-changelog). ## Tipe ------ #### [ v4.x - v3.x ] Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. ------ #### [ v2.x ] Komponen ini adalah komponen Lambda () `aws.greengrass.lambda`. [Inti [Greengrass](greengrass-nucleus-component.md) menjalankan fungsi Lambda komponen ini menggunakan komponen peluncur Lambda.](lambda-launcher-component.md) ------ Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi ------ #### [ v4.x - v3.x ] Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ------ #### [ v2.x ] Komponen ini hanya dapat diinstal pada perangkat inti Linux. ------ ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: ------ #### [ v4.x - v3.x ] + [Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH. + Pustaka Python berikut, termasuk dependensi apa pun, harus diinstal dan tersedia bagi pengguna yang menjalankan komponen: + [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2) + [AWS SDK untuk Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/) **catatan** Anda dapat mengatur `UseInstaller` konfigurasi `true` untuk menginstal pustaka ini secara otomatis ke lingkungan Python yang disediakan. + [Peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `cloudwatch:PutMetricData`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ Untuk informasi selengkapnya, lihat [referensi CloudWatch izin Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) *di Panduan CloudWatch Pengguna Amazon*. ------ #### [ 2.x ] + Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). + [Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH. + [Peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `cloudwatch:PutMetricData`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] } ``` ------ Untuk informasi selengkapnya, lihat [referensi CloudWatch izin Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) *di Panduan CloudWatch Pengguna Amazon*. + Untuk menerima data keluaran dari komponen ini, Anda harus menggabungkan pemutakhiran konfigurasi berikut untuk [komponen router langganan lama (`aws.greengrass.LegacySubscriptionRouter`) saat menerapkan komponen](legacy-subscription-router-component.md) ini. Konfigurasi ini menentukan topik di mana komponen ini menerbitkan tanggapan. ------ #### [ Legacy subscription router v2.1.x ] ``` { "subscriptions": { "aws-greengrass-cloudwatch": { "id": "aws-greengrass-cloudwatch", "source": "component:aws.greengrass.Cloudwatch", "subject": "cloudwatch/metric/put/status", "target": "cloud" } } } ``` ------ #### [ Legacy subscription router v2.0.x ] ``` { "subscriptions": { "aws-greengrass-cloudwatch": { "id": "aws-greengrass-cloudwatch", "source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version", "subject": "cloudwatch/metric/put/status", "target": "cloud" } } } ``` + Ganti *region* dengan Wilayah AWS yang Anda gunakan. + Ganti *version* dengan versi fungsi Lambda yang dijalankan komponen ini. Untuk menemukan versi fungsi Lambda, Anda harus melihat resep untuk versi komponen ini yang ingin Anda deploy. Buka halaman detail komponen ini di [konsol AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) tersebut, dan cari pasangan nilai kunci **Fungsi Lambda**. Pasangan kunci-nilai ini berisi nama dan versi fungsi Lambda. **penting** Anda harus memperbarui versi fungsi Lambda pada router langganan warisan setiap kali Anda men-deploy komponen ini. Hal ini memastikan bahwa Anda menggunakan versi fungsi Lambda yang benar untuk versi komponen yang Anda deploy. ------ Untuk informasi selengkapnya, lihat [Buat deployment](create-deployments.md). ------ ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `monitoring.region.amazonaws.com` | 443 | Ya | Unggah CloudWatch metrik. | ## 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](#cloudwatch-metrics-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 4.0.0 - 3.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 4.0.0 hingga 3.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.1.4 - 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 hingga 2.1.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.4 - 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 dan 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.2 - 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 dan 2.1.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.8 - 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 hingga 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | >=1.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=1.0.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ v4.x ] `PublishInterval` (Opsional) Jumlah detik maksimum untuk menunggu sebelum komponen menerbitkan metrik berkelompok untuk namespace tertentu. Untuk mengonfigurasi komponen untuk mempublikasikan metrik saat menerimanya, yang berarti tanpa batching, tentukan `0`. Komponen dipublikasikan CloudWatch setelah menerima 20 metrik di namespace yang sama atau setelah interval yang Anda tentukan. Komponen tidak menentukan urutan penerbitan peristiwa. Nilai ini bisa maksimal 900 detik. Default: 10 detik `MaxMetricsToRetain` (Opsional) Jumlah maksimum metrik di semua namespace untuk disimpan di memori sebelum komponen menggantikannya dengan metrik yang lebih baru. Batas ini berlaku bila perangkat inti tidak memiliki koneksi ke internet, sehingga komponen mem-buffer metrik untuk dipublikasikan nanti. Ketika buffer penuh, komponen menggantikan metrik tertua dengan yang lebih baru. Metrik dalam namespace tertentu hanya menggantikan metrik dalam namespace yang sama. Jika proses host untuk komponen terganggu, komponen tidak akan menyimpan metrik. Hal ini dapat terjadi selama deployment atau ketika perangkat inti restart, misalnya. Nilai ini harus setidaknya 2.000 metrik. Default: 5.000 metrik `InputTopic` (Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan `true` untuk`PubSubToIoTCore`, Anda dapat menggunakan wildcard MQTT (\$1 dan \$1) dalam topik ini. Default: `cloudwatch/metric/put` `OutputTopic` (Opsional) Topik di mana komponen menerbitkan tanggapan status. Default: `cloudwatch/metric/put/status` `PubSubToIoTCore` (Opsional) Nilai string yang menentukan apakah akan mempublikasikan dan berlangganan topik AWS IoT Core MQTT. Nilai yang didukung adalah `true` dan `false`. Default: `false` `LogLevel` (Opsional) Tingkat logging untuk komponen. Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARNING` + `ERROR` + `CRITICAL` Default: `INFO` `UseInstaller` (Opsional) Nilai Boolean yang menentukan apakah akan menggunakan skrip installer untuk menginstal dependensi Python komponen ini ke dalam lingkungan Python yang disediakan. Tetapkan nilai ini `true` untuk menginstal dependensi Python komponen ini secara otomatis. Ketika diatur ke`false`, Anda harus menginstal pustaka berikut, termasuk dependensi apa pun, dan membuatnya tersedia untuk lingkungan Python yang disediakan untuk pengguna yang menjalankan komponen. + [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2) + [AWS SDK untuk Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/) Default: `false` `PublishRegion` (Opsional) Wilayah AWS Untuk mempublikasikan CloudWatch metrik. Nilai ini menimpa Wilayah default untuk perangkat inti. Parameter ini diperlukan hanya untuk metrik lintas Wilayah. `accessControl` (Opsional) Objek yang berisi [kebijakan otorisasi](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk mempublikasikan dan berlangganan topik yang ditentukan. Jika Anda menentukan nilai kustom untuk `InputTopic` dan`OutputTopic`, Anda harus memperbarui nilai sumber daya dalam objek ini. Default: ``` { "aws.greengrass.ipc.pubsub": { "aws.greengrass.Cloudwatch:pubsub:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToTopic" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:pubsub:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToTopic" ], "resources": [ "cloudwatch/metric/put/status" ] } }, "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.Cloudwatch:mqttproxy:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:mqttproxy:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "cloudwatch/metric/put/status" ] } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi** ``` { "PublishInterval": 0, "PubSubToIoTCore": true } ``` ------ #### [ v3.x ] `PublishInterval` (Opsional) Jumlah detik maksimum untuk menunggu sebelum komponen menerbitkan metrik berkelompok untuk namespace tertentu. Untuk mengonfigurasi komponen untuk mempublikasikan metrik saat menerimanya, yang berarti tanpa batching, tentukan `0`. Komponen dipublikasikan CloudWatch setelah menerima 20 metrik di namespace yang sama atau setelah interval yang Anda tentukan. Komponen tidak menentukan urutan penerbitan peristiwa. Nilai ini bisa maksimal 900 detik. Default: 10 detik `MaxMetricsToRetain` (Opsional) Jumlah maksimum metrik di semua namespace untuk disimpan di memori sebelum komponen menggantikannya dengan metrik yang lebih baru. Batas ini berlaku bila perangkat inti tidak memiliki koneksi ke internet, sehingga komponen mem-buffer metrik untuk dipublikasikan nanti. Ketika buffer penuh, komponen menggantikan metrik tertua dengan yang lebih baru. Metrik dalam namespace tertentu hanya menggantikan metrik dalam namespace yang sama. Jika proses host untuk komponen terganggu, komponen tidak akan menyimpan metrik. Hal ini dapat terjadi selama deployment atau ketika perangkat inti restart, misalnya. Nilai ini harus setidaknya 2.000 metrik. Default: 5.000 metrik `InputTopic` (Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan `true` untuk`PubSubToIoTCore`, Anda dapat menggunakan wildcard MQTT (\$1 dan \$1) dalam topik ini. Default: `cloudwatch/metric/put` `OutputTopic` (Opsional) Topik di mana komponen menerbitkan tanggapan status. Default: `cloudwatch/metric/put/status` `PubSubToIoTCore` (Opsional) Nilai string yang menentukan apakah akan mempublikasikan dan berlangganan topik AWS IoT Core MQTT. Nilai yang didukung adalah `true` dan `false`. Default: `false` `LogLevel` (Opsional) Tingkat logging untuk komponen. Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARNING` + `ERROR` + `CRITICAL` Default: `INFO` `UseInstaller` (Opsional) Nilai Boolean yang menentukan apakah akan menggunakan skrip installer untuk menginstal dependensi Python komponen ini ke dalam lingkungan Python yang disediakan. Tetapkan nilai ini `false` untuk menggunakan skrip kustom atau menginstal dependensi secara manual. Ketika diatur ke`false`, Anda harus menginstal pustaka berikut, termasuk dependensi apa pun, dan membuatnya tersedia untuk lingkungan Python yang disediakan untuk pengguna yang menjalankan komponen. + [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2) + [AWS SDK untuk Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/) Default: `true` `PublishRegion` (Opsional) Wilayah AWS Untuk mempublikasikan CloudWatch metrik. Nilai ini menimpa Wilayah default untuk perangkat inti. Parameter ini diperlukan hanya untuk metrik lintas Wilayah. `accessControl` (Opsional) Objek yang berisi [kebijakan otorisasi](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk mempublikasikan dan berlangganan topik yang ditentukan. Jika Anda menentukan nilai kustom untuk `InputTopic` dan`OutputTopic`, Anda harus memperbarui nilai sumber daya dalam objek ini. Default: ``` { "aws.greengrass.ipc.pubsub": { "aws.greengrass.Cloudwatch:pubsub:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToTopic" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:pubsub:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToTopic" ], "resources": [ "cloudwatch/metric/put/status" ] } }, "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.Cloudwatch:mqttproxy:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:mqttproxy:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "cloudwatch/metric/put/status" ] } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi** ``` { "PublishInterval": 0, "PubSubToIoTCore": true } ``` ------ #### [ v2.x ] **catatan** Konfigurasi default komponen ini meliputi parameter fungsi Lambda. Kami sarankan Anda mengedit hanya parameter berikut untuk mengonfigurasi komponen ini pada perangkat Anda. `lambdaParams` Sebuah objek yang berisi parameter untuk fungsi Lambda komponen ini. Objek ini berisi informasi berikut: `EnvironmentVariables` Sebuah objek yang berisi parameter fungsi Lambda ini. Objek ini berisi informasi berikut: `PUBLISH_INTERVAL` (Opsional) Jumlah detik maksimum untuk menunggu sebelum komponen menerbitkan metrik berkelompok untuk namespace tertentu. Untuk mengonfigurasi komponen untuk mempublikasikan metrik saat menerimanya, yang berarti tanpa batching, tentukan `0`. Komponen dipublikasikan CloudWatch setelah menerima 20 metrik di namespace yang sama atau setelah interval yang Anda tentukan. Komponen tidak menjamin urutan di mana peristiwa dipublikasikan. Nilai ini bisa paling banyak 900 detik. Default: 10 detik `MAX_METRICS_TO_RETAIN` (Opsional) Jumlah maksimum metrik di semua namespace untuk disimpan di memori sebelum komponen menggantikannya dengan metrik yang lebih baru. Batas ini berlaku bila perangkat inti tidak memiliki koneksi ke internet, sehingga komponen mem-buffer metrik untuk dipublikasikan nanti. Ketika buffer penuh, komponen menggantikan metrik tertua dengan yang lebih baru. Metrik dalam namespace tertentu hanya menggantikan metrik dalam namespace yang sama. Jika proses host untuk komponen terganggu, komponen tidak akan menyimpan metrik. Hal ini dapat terjadi selama deployment atau ketika perangkat inti restart, misalnya. Nilai ini harus setidaknya 2.000 metrik. Default: 5.000 metrik `PUBLISH_REGION` (Opsional) Wilayah AWS Untuk mempublikasikan CloudWatch metrik. Nilai ini menimpa Wilayah default untuk perangkat inti. Parameter ini diperlukan hanya untuk metrik lintas Wilayah. `containerMode` (Opsional) Mode kontainerisasi untuk komponen ini. Pilih dari salah satu pilihan berikut: + `NoContainer` – Komponen tersebut tidak berjalan di lingkungan waktu aktif terisolasi. + `GreengrassContainer`— Komponen berjalan di lingkungan runtime yang terisolasi di dalam AWS IoT Greengrass wadah. Default: `GreengrassContainer` `containerParams` (Opsional) Sebuah objek yang berisi parameter kontainer untuk komponen ini. Komponen menggunakan parameter ini jika Anda menentukan `GreengrassContainer` untuk `containerMode`. Objek ini berisi informasi berikut: `memorySize` (Opsional) Jumlah memori (dalam kilobyte) yang akan dialokasikan ke komponen. Default ke 64 MB (65.535 KB). `pubsubTopics` (Opsional) Sebuah objek yang berisi topik di mana komponen berlangganan untuk menerima pesan. Anda dapat menentukan setiap topik dan apakah komponen berlangganan topik MQTT dari AWS IoT Core atau topik lokal. publish/subscribe Objek ini berisi informasi berikut: `0` - Ini adalah indeks himpunan sebagai string. Objek yang berisi informasi berikut: `type` (Opsional) Jenis publish/subscribe pesan yang digunakan komponen ini untuk berlangganan pesan. Pilih dari salah satu pilihan berikut: + `PUB_SUB` — Berlangganan pesan publish/subscribe lokal. Jika Anda memilih opsi ini, topik tidak dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). + `IOT_CORE`— Berlangganan pesan AWS IoT Core MQTT. Jika Anda memilih opsi ini, topik dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). Default: `PUB_SUB` `topic` (Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan `IotCore` untuk `type`, Anda dapat menggunakan wildcard MQTT (`+` dan `#`) dalam topik ini. **Example Contoh: Pembaruan gabungan konfigurasi (mode kontainer)** ``` { "containerMode": "GreengrassContainer" } ``` **Example Contoh: Pembaruan gabungan konfigurasi (tidak ada mode kontainer)** ``` { "containerMode": "NoContainer" } ``` ------ ## Data input Komponen ini menerima metrik pada topik berikut dan menerbitkan metrik ke. CloudWatch Secara default, komponen ini berlangganan publish/subscribe pesan lokal. Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). Dimulai dengan versi komponen v3.0.0, Anda dapat mengonfigurasi komponen ini secara opsional untuk berlangganan topik MQTT dengan menyetel parameter konfigurasi ke. `PubSubToIoTCore` `true` Untuk informasi selengkapnya tentang memublikasikan pesan ke topik MQTT di komponen kustom Anda, lihat. [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md) **Topik default:** `cloudwatch/metric/put` Pesan menerima properti berikut. Pesan input harus dalam format JSON. `request` Metrik dalam pesan ini. Objek permintaan berisi data metrik untuk dipublikasikan CloudWatch. Nilai metrik harus memenuhi spesifikasi [https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)operasi. Jenis: `object` yang berisi informasi berikut: `namespace` Namespace yang ditentukan pengguna untuk data metrik dalam permintaan ini. CloudWatch menggunakan ruang nama sebagai wadah untuk titik data metrik. Anda tidak dapat menentukan namespace yang dimulai dengan string yang sudah dipesan `AWS/`. Tipe: `string` Pola yang valid: `[^:].*` `metricData` Data untuk metrik tersebut. Jenis: `object` yang berisi informasi berikut: `metricName` Nama metrik. Tipe: `string` `value` Nilai untuk metrik. CloudWatch menolak nilai yang terlalu kecil atau terlalu besar. Nilai harus antara `8.515920e-109` dan `1.174271e+108` (Basis 10) atau `2e-360` dan `2e360` (Basis 2). CloudWatch tidak mendukung nilai-nilai khusus seperti`NaN`,`+Infinity`, dan`-Infinity`. Tipe: `double` `dimensions` (Opsional) Dimensi untuk metrik. Dimensi memberikan informasi tambahan tentang metrik dan datanya. Metrik dapat menentukan hingga 10 dimensi. Komponen ini secara otomatis menyertakan dimensi bernama`coreName`, di mana nilainya adalah nama perangkat inti. Jenis: `array` dari objek yang masing-masing berisi informasi berikut: `name` (Opsional) Nama dimensi. Tipe: `string` `value` (Opsional) Nilai dimensi. Tipe: `string` `timestamp` (Opsional) Waktu penerimaan data metrik, dinyatakan dalam detik jangka waktu Unix. Default untuk waktu di mana komponen menerima pesan. Tipe: `double` Jika Anda menggunakan antara versi 2.0.3 dan 2.0.7 dari komponen ini, sebaiknya Anda mengambil stempel waktu secara terpisah untuk setiap metrik saat Anda mengirim beberapa metrik dari satu sumber. Jangan menggunakan variabel untuk menyimpan cap waktu. `unit` (Opsional) Unit metrik. Tipe: `string` Nilai yang valid: `Seconds`, `Microseconds`, `Milliseconds`, `Bytes`, `Kilobytes`, `Megabytes`, `Gigabytes`, `Terabytes`, `Bits`, `Kilobits`, `Megabits`, `Gigabits`, `Terabits`, `Percent`, `Count`, `Bytes/Second`, `Kilobytes/Second`, `Megabytes/Second`, `Gigabytes/Second`, `Terabytes/Second`, `Bits/Second`, `Kilobits/Second`, `Megabits/Second`, `Gigabits/Second`, `Terabits/Second`, `Count/Second`, `None` Default ke `None`. **catatan** Semua kuota yang berlaku untuk CloudWatch `PutMetricData` API berlaku untuk metrik yang Anda terbitkan dengan komponen ini. Kuota berikut sangat penting: Batas 40 KB pada muatan API 20 metrik per permintaan API 150 transaksi per detik (TPS) untuk API `PutMetricData` Untuk informasi selengkapnya, lihat [kuota CloudWatch layanan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) di *Panduan CloudWatch Pengguna*. **Example Contoh input** ``` { "request": { "namespace": "Greengrass", "metricData": { "metricName": "latency", "dimensions": [ { "name": "hostname", "value": "test_hostname" } ], "timestamp": 1539027324, "value": 123.0, "unit": "Seconds" } } } ``` ## Data output Komponen ini menerbitkan tanggapan sebagai data keluaran pada publish/subscribe topik lokal berikut secara default. Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). Anda dapat mengonfigurasi komponen ini secara opsional untuk memublikasikan ke topik MQTT dengan menyetel parameter konfigurasi ke`PubSubToIoTCore`. `true` Untuk informasi selengkapnya tentang berlangganan pesan tentang topik MQTT di komponen kustom Anda, lihat. [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md) **catatan** Versi komponen 2.0.x mempublikasikan tanggapan sebagai data keluaran pada topik MQTT secara default. Anda harus menentukan topik sebagai `subject` dalam konfigurasi untuk [komponen router langganan lama](legacy-subscription-router-component.md). **Topik default:** `cloudwatch/metric/put/status` **Example Contoh output: Berhasil** Responsnya mencakup namespace data metrik dan `RequestId` bidang dari respons. CloudWatch ``` { "response": { "cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE", "namespace": "Greengrass", "status": "success" } } ``` **Example Contoh output: Gagal** ``` { "response" : { "namespace": "Greengrass", "error": "InvalidInputException", "error_message": "cw metric is invalid", "status": "fail" } } ``` **catatan** Jika komponen mendeteksi kesalahan yang dapat dicoba ulang, seperti kesalahan koneksi, ia akan mencoba ulang publikasi di batch berikutnya. ## Lisensi Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut: + [AWS SDK untuk Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0 + [botocore](https://pypi.org/project/botocore/)/Apache License 2.0 + [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License + [docutils](https://pypi.org/project/docutils/)/BSD License, Lisensi Publik Umum (GPL) GNU, Lisensi Dasar Perangkat Lunak Python, Domain Publik + [jmespath](https://pypi.org/project/jmespath/)/MIT License + [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0 + [urllib3](https://pypi.org/project/urllib3/)/MIT License Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Berkas log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.Cloudwatch.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.Cloudwatch.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. ------ #### [ v4.x - v3.x ] | **Versi** | **Perubahan** | | --- | --- | | 4.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html) | | 3.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html) | | 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html) | | 3.0.0 | Versi komponen CloudWatch metrik ini mengharapkan parameter konfigurasi yang berbeda dari versi 2.x. Jika Anda menggunakan konfigurasi non-default untuk versi 2.x, dan Anda ingin meningkatkan dari v2.x ke v3.x, Anda harus memperbarui konfigurasi komponen. Untuk informasi selengkapnya, lihat [konfigurasi komponen CloudWatch metrik](#cloudwatch-metrics-component-configuration). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html) | ------ #### [ v2.x ] | **Versi** | **Perubahan** | | --- | --- | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.2 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.1 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html) | | 2.0.8 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html) | | 2.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.6 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.5 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.4 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.3 | Versi awal. | ------ ## Lihat juga + [Menggunakan CloudWatch metrik Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) di * CloudWatch Panduan Pengguna Amazon* + [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)di *Referensi CloudWatch API Amazon* # AWS IoT Device Defender AWS IoT Device Defender Component (`aws.greengrass.DeviceDefender`) memberi tahu administrator tentang perubahan status perangkat inti Greengrass. Hal ini dapat membantu mengidentifikasi perilaku yang tidak biasa yang mungkin menunjukkan perangkat yang disusupi. Untuk informasi lebih lanjut, lihat [AWS IoT Device Defender](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html) dalam *Panduan Pengembang AWS IoT Core *. Komponen ini membaca metrik sistem pada perangkat inti. Kemudian, ia menerbitkan metrik ke AWS IoT Device Defender. Untuk informasi lebih lanjut tentang cara membaca dan menafsirkan metrik yang dilaporkan oleh komponen ini, lihat [Spesifikasi dokumen metrik perangkat](https://docs.aws.amazon.com/iot/latest/developerguide/detect-device-side-metrics.html#DetectMetricsMessagesSpec) dalam *Panduan Developer AWS IoT Core *. **catatan** Komponen ini menyediakan fungsionalitas yang mirip dengan konektor Device Defender di AWS IoT Greengrass V1. Untuk informasi selengkapnya, lihat [Konektor Pertahanan Perangkat](https://docs.aws.amazon.com/greengrass/latest/developerguide/device-defender-connector.html) dalam *Panduan Developer AWS IoT Greengrass V1 *. **Topics** + [Versi](#device-defender-component-versions) + [Tipe](#device-defender-component-type) + [Sistem operasi](#device-defender-component-os-support) + [Persyaratan](#device-defender-component-requirements) + [Dependensi](#device-defender-component-dependencies) + [Konfigurasi](#device-defender-component-configuration) + [Data input](#device-defender-component-input-data) + [Data output](#device-defender-component-output-data) + [File log lokal](#device-defender-component-log-file) + [Lisensi](#device-defender-component-licenses) + [Changelog](#device-defender-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 4.0.x + 3.1.x + 3.0.x + 2.0.x Untuk informasi tentang perubahan di setiap versi komponen, lihat [changelog](#device-defender-component-changelog). ## Tipe ------ #### [ v4.x - v3.x ] Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. ------ #### [ v2.x ] Komponen ini adalah komponen Lambda () `aws.greengrass.lambda`. [Inti [Greengrass](greengrass-nucleus-component.md) menjalankan fungsi Lambda komponen ini menggunakan komponen peluncur Lambda.](lambda-launcher-component.md) ------ Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi ------ #### [ v4.x - v3.x ] Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ------ #### [ v2.x ] Komponen ini hanya dapat diinstal pada perangkat inti Linux. ------ ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: ------ #### [ v4.x - v3.x ] + [Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH. + Pustaka Python berikut, termasuk dependensi apa pun, harus diinstal dan tersedia bagi pengguna yang menjalankan komponen: + [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2) + perpustakaan [cbor](https://pypi.org/project/cbor/). Versi 1.0.0 adalah versi terkini yang disahkan untuk bekerja dengan komponen. + [perpustakaan psutil](https://pypi.org/project/psutil/). Versi 5.7.0 adalah versi terkini yang disahkan untuk bekerja dengan komponen. **catatan** Anda dapat mengatur `UseInstaller` konfigurasi `true` untuk menginstal pustaka ini secara otomatis ke lingkungan Python yang disediakan. + AWS IoT Device Defender dikonfigurasi untuk menggunakan fitur Deteksi untuk memantau pelanggaran. Untuk informasi selengkapnya, lihat [Deteksi](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) di *AWS IoT Core Panduan Developer*. ------ #### [ v2.x ] + Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). + [Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH. + AWS IoT Device Defender dikonfigurasi untuk menggunakan fitur Deteksi untuk memantau pelanggaran. Untuk informasi selengkapnya, lihat [Deteksi](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) di *AWS IoT Core Panduan Developer*. + Pustaka [psutil](https://pypi.org/project/psutil/) diinstal pada perangkat inti. Versi 5.7.0 adalah versi terkini yang disahkan untuk bekerja dengan komponen. + Pustaka [cbor](https://pypi.org/project/cbor/) diinstal pada perangkat inti. Versi 1.0.0 adalah versi terkini yang disahkan untuk bekerja dengan komponen. + Untuk menerima data keluaran dari komponen ini, Anda harus menggabungkan pemutakhiran konfigurasi berikut untuk [komponen router langganan lama (`aws.greengrass.LegacySubscriptionRouter`) saat menerapkan komponen](legacy-subscription-router-component.md) ini. Konfigurasi ini menentukan topik di mana komponen ini menerbitkan tanggapan. ------ #### [ Legacy subscription router v2.1.x ] ``` { "subscriptions": { "aws-greengrass-device-defender": { "id": "aws-greengrass-device-defender", "source": "component:aws.greengrass.DeviceDefender", "subject": "$aws/things/+/defender/metrics/json", "target": "cloud" } } } ``` ------ #### [ Legacy subscription router v2.0.x ] ``` { "subscriptions": { "aws-greengrass-device-defender": { "id": "aws-greengrass-device-defender", "source": "arn:aws:lambda:region:aws:function:aws-greengrass-device-defender:version", "subject": "$aws/things/+/defender/metrics/json", "target": "cloud" } } } ``` + Ganti *region* dengan Wilayah AWS yang Anda gunakan. + Ganti *version* dengan versi fungsi Lambda yang dijalankan komponen ini. Untuk menemukan versi fungsi Lambda, Anda harus melihat resep untuk versi komponen ini yang ingin Anda deploy. Buka halaman detail komponen ini di [konsol AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) tersebut, dan cari pasangan nilai kunci **Fungsi Lambda**. Pasangan kunci-nilai ini berisi nama dan versi fungsi Lambda. **penting** Anda harus memperbarui versi fungsi Lambda pada router langganan warisan setiap kali Anda men-deploy komponen ini. Hal ini memastikan bahwa Anda menggunakan versi fungsi Lambda yang benar untuk versi komponen yang Anda deploy. ------ Untuk informasi selengkapnya, lihat [Buat deployment](create-deployments.md). ------ ## 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](#device-defender-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 4.0.0 - 3.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 4.0.0 hingga 3.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.0.12 - 2.0.17 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.12 hingga 2.0.17 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.12 - 2.0.16 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.16 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.10 - 2.0.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.10 dan 2.0.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | >=1.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | >=1.0.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ v4.x ] `PublishRetryCount` Berapa kali publikasi akan dicoba lagi. Minimal adalah 0. Maksimal 72. Default: 5 `SampleIntervalSeconds` (Opsional) Jumlah waktu dalam hitungan detik antara setiap siklus tempat komponen mengumpulkan dan melaporkan metrik. Nilai minimum adalah 300 detik (5 menit). Default: 300 detik `UseInstaller` (Opsional) Nilai Boolean yang menentukan apakah akan menggunakan skrip installer untuk menginstal dependensi Python komponen ini ke dalam lingkungan Python yang disediakan. Tetapkan nilai ini `true` untuk menginstal dependensi Python komponen ini secara otomatis. Ketika diatur ke`false`, Anda harus menginstal pustaka berikut, termasuk dependensi apa pun, dan membuatnya tersedia untuk lingkungan Python yang disediakan untuk pengguna yang menjalankan komponen. + [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2) + perpustakaan [cbor](https://pypi.org/project/cbor/). Versi 1.0.0 adalah versi terkini yang disahkan untuk bekerja dengan komponen. + [perpustakaan psutil](https://pypi.org/project/psutil/). Versi 5.7.0 adalah versi terkini yang disahkan untuk bekerja dengan komponen. Default: `false` ------ #### [ v3.x ] `PublishRetryCount` Berapa kali publikasi akan dicoba lagi. Fitur ini tersedia dalam versi 3.1.1. Minimal adalah 0. Maksimal 72. Default: 5 `SampleIntervalSeconds` (Opsional) Jumlah waktu dalam hitungan detik antara setiap siklus tempat komponen mengumpulkan dan melaporkan metrik. Nilai minimum adalah 300 detik (5 menit). Default: 300 detik `UseInstaller` (Opsional) Nilai Boolean yang menentukan apakah akan menggunakan skrip installer untuk menginstal dependensi Python komponen ini ke dalam lingkungan Python yang disediakan. Tetapkan nilai ini `false` untuk menggunakan skrip kustom atau menginstal dependensi secara manual. Ketika diatur ke`false`, Anda harus menginstal pustaka berikut, termasuk dependensi apa pun, dan membuatnya tersedia untuk lingkungan Python yang disediakan untuk pengguna yang menjalankan komponen. + [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2) + perpustakaan [cbor](https://pypi.org/project/cbor/). Versi 1.0.0 adalah versi terkini yang disahkan untuk bekerja dengan komponen. + [perpustakaan psutil](https://pypi.org/project/psutil/). Versi 5.7.0 adalah versi terkini yang disahkan untuk bekerja dengan komponen. Jika Anda menggunakan versi 3.0.0 atau 3.0.1 komponen ini pada perangkat inti yang Anda konfigurasikan untuk menggunakan proxy HTTPS, Anda harus menetapkan nilai ini ke. `false` Skrip penginstal tidak mendukung operasi di belakang proxy HTTPS dalam versi komponen ini. Default: `true` ------ #### [ v2.x ] **catatan** Konfigurasi default komponen ini meliputi parameter fungsi Lambda. Kami sarankan Anda mengedit hanya parameter berikut untuk mengonfigurasi komponen ini pada perangkat Anda. `lambdaParams` Sebuah objek yang berisi parameter untuk fungsi Lambda komponen ini. Objek ini berisi informasi berikut: `EnvironmentVariables` Sebuah objek yang berisi parameter fungsi Lambda ini. Objek ini berisi informasi berikut: `PROCFS_PATH` (Opsional) Jalur ke folder `/proc`. + Untuk menjalankan komponen ini di kontainer, gunakan nilai default, `/host-proc`. Komponen berjalan dalam kontainer secara default. + Untuk menjalankan komponen ini ketika tidak ada mode kontainer, tentukan `/proc` untuk parameter ini. Default: `/host-proc`. Ini adalah jalur default di mana komponen ini memasang folder `/proc` dalam kontainer. Komponen ini memiliki akses hanya-baca ke folder ini. `SAMPLE_INTERVAL_SECONDS` (Opsional) Jumlah waktu dalam hitungan detik antara setiap siklus tempat komponen mengumpulkan dan melaporkan metrik. Nilai minimum adalah 300 detik (5 menit). Default: 300 detik `containerMode` (Opsional) Mode kontainerisasi untuk komponen ini. Pilih dari salah satu pilihan berikut: + `GreengrassContainer`— Komponen berjalan di lingkungan runtime yang terisolasi di dalam AWS IoT Greengrass wadah. + `NoContainer` – Komponen tersebut tidak berjalan di lingkungan waktu aktif terisolasi. Jika Anda menentukan opsi ini, Anda harus menentukan `/proc` untuk parameter variabel lingkungan `PROCFS_PATH`. Default: `GreengrassContainer` `containerParams` (Opsional) Sebuah objek yang berisi parameter kontainer untuk komponen ini. Komponen menggunakan parameter ini jika Anda menentukan `GreengrassContainer` untuk `containerMode`. Objek ini berisi informasi berikut: `memorySize` (Opsional) Jumlah memori (dalam kilobyte) yang akan dialokasikan ke komponen. Defaultnya 50.000 KB. `pubsubTopics` (Opsional) Sebuah objek yang berisi topik di mana komponen berlangganan untuk menerima pesan. Anda dapat menentukan setiap topik dan apakah komponen berlangganan topik MQTT dari AWS IoT Core atau topik lokal. publish/subscribe Objek ini berisi informasi berikut: `0` - Ini adalah indeks himpunan sebagai string. Objek yang berisi informasi berikut: `type` (Opsional) Jenis publish/subscribe pesan yang digunakan komponen ini untuk berlangganan pesan. Pilih dari salah satu pilihan berikut: + `PUB_SUB` — Berlangganan pesan publish/subscribe lokal. Jika Anda memilih opsi ini, topik tidak dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). + `IOT_CORE`— Berlangganan pesan AWS IoT Core MQTT. Jika Anda memilih opsi ini, topik dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). Default: `PUB_SUB` `topic` (Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan `IotCore` untuk `type`, Anda dapat menggunakan wildcard MQTT (`+` dan `#`) dalam topik ini. **Example Contoh: Pembaruan gabungan konfigurasi (mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "PROCFS_PATH": "/host_proc" } }, "containerMode": "GreengrassContainer" } ``` **Example Contoh: Pembaruan gabungan konfigurasi (tidak ada mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "PROCFS_PATH": "/proc" } }, "containerMode": "NoContainer" } ``` ------ ## Data input Komponen ini tidak menerima pesan sebagai data input. ## Data output Komponen ini menerbitkan metrik keamanan ke topik cadangan berikut untuk. AWS IoT Device Defender Komponen ini diganti *coreDeviceName* dengan nama perangkat inti saat menerbitkan metrik. **Topik (AWS IoT Core MQTT):** `$aws/things/coreDeviceName/defender/metrics/json` **Example Contoh Output** ``` { "header": { "report_id": 1529963534, "version": "1.0" }, "metrics": { "listening_tcp_ports": { "ports": [ { "interface": "eth0", "port": 24800 }, { "interface": "eth0", "port": 22 }, { "interface": "eth0", "port": 53 } ], "total": 3 }, "listening_udp_ports": { "ports": [ { "interface": "eth0", "port": 5353 }, { "interface": "eth0", "port": 67 } ], "total": 2 }, "network_stats": { "bytes_in": 1157864729406, "bytes_out": 1170821865, "packets_in": 693092175031, "packets_out": 738917180 }, "tcp_connections": { "established_connections":{ "connections": [ { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" }, { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" } ], "total": 2 } } } } ``` Untuk informasi lebih lanjut tentang metrik yang dilaporkan oleh komponen ini, lihat [spesifikasi dokumen metrik perangkat](https://docs.aws.amazon.com/iot/latest/developerguide/detect-device-side-metrics.html#DetectMetricsMessagesSpec) dalam *Panduan Developer AWS IoT Core *. ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.DeviceDefender.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.DeviceDefender.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.DeviceDefender.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.DeviceDefender.log -Tail 10 -Wait ``` ------ ## Lisensi Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. ------ #### [ v4.x - v3.x ] | **Versi** | **Perubahan** | | --- | --- | | 4.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/device-defender-component.html) | | 3.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/device-defender-component.html) | | 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/device-defender-component.html) | | 3.0.1 | Memperbaiki masalah dengan cara komponen menghitung nilai delta untuk metrik. | | 3.0.0 | Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. Versi awal. | ------ #### [ v2.x ] | **Versi** | **Perubahan** | | --- | --- | | 2.0.17 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.0.16 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.0.11 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.0.10 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.0.9 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.6 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.5 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.4 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.3 | Versi awal. | ------ # Spooler disk Komponen spooler disk (`aws.greengrass.DiskSpooler`) menawarkan opsi penyimpanan persisten untuk pesan yang dikumpulkan dari perangkat inti Greengrass ke. AWS IoT Core Komponen ini akan menyimpan pesan keluar ini pada disk. **Topics** + [Versi](#disk-spooler-component-versions) + [Tipe](#disk-spooler-component-type) + [Sistem operasi](#disk-spooler-component-os-support) + [Persyaratan](#disk-spooler-component-requirements) + [Dependensi](#disk-spooler-component-dependencies) + [Penggunaan](#disk-spooler-component-usage) + [Berkas log lokal](#disk-spooler-component-log-file) + [Changelog](#disk-spooler-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 1.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + `storageType`harus diatur `Disk` untuk menggunakan komponen ini. Anda dapat mengatur ini dalam konfigurasi inti [Greengrass](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration). + `maxSizeInBytes`tidak boleh dikonfigurasi agar lebih besar dari ruang yang tersedia di perangkat. Anda dapat mengatur ini dalam konfigurasi inti [Greengrass](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration). + Komponen spooler disk didukung untuk berjalan di VPC. ## 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](#disk-spooler-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 1.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.17.0 | Keras | ------ #### [ 1.0. ] Tabel berikut mencantumkan dependensi untuk versi 1.0.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.16.0 | Keras | ------ #### [ 1.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.15.0 | Keras | ------ #### [ 1.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.14.0 | Keras | ------ #### [ 1.0.1 – 1.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.1 hingga 1.0.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.13.0 | Keras | ------ #### [ 1.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Penggunaan Untuk menggunakan komponen spooler disk, `aws.greengrass.DiskSpooler` harus digunakan. Untuk mengkonfigurasi dan menggunakan komponen ini, Anda harus mengatur `pluginName` ke`aws.greengrass.DiskSpooler`. ## Berkas log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 1.0.8 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 1.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 1.0.6 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 1.0.5 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 1.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/disk-spooler-component.html) | | 1.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/disk-spooler-component.html) | | 1.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/disk-spooler-component.html) | | 1.0.1 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 1.0.0 | Versi awal. | # Manajer aplikasi Docker Komponen manajer aplikasi Docker (`aws.greengrass.DockerApplicationManager`) memungkinkan AWS IoT Greengrass untuk mengunduh gambar Docker dari pendaftar gambar publik dan pendaftar pribadi yang dihosting di Amazon Elastic Container Registry (Amazon ECR). Ini juga memungkinkan AWS IoT Greengrass untuk mengelola kredensitas secara otomatis untuk mengunduh gambar dengan aman dari repositori pribadi di Amazon ECR. Ketika Anda mengembangkan komponen kustom yang menjalankan kontainer Docker, sertakan manajer aplikasi Docker sebagai dependensi untuk men-download gambar Docker yang ditetapkan sebagai artefak dalam komponen Anda. Untuk informasi selengkapnya, lihat [Jalankan kontainer Docker](run-docker-container.md). **Topics** + [Versi](#docker-application-manager-component-versions) + [Tipe](#docker-application-manager-component-type) + [Sistem operasi](#docker-application-manager-component-os-support) + [Persyaratan](#docker-application-manager-component-requirements) + [Dependensi](#docker-application-manager-component-dependencies) + [Konfigurasi](#docker-application-manager-component-configuration) + [Berkas log lokal](#docker-application-manager-component-log-file) + [Changelog](#docker-application-manager-component-changelog) + [Lihat juga](#docker-application-manager-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + [Docker Engine](https://docs.docker.com/engine/) 1.9.1 atau yang lebih baru diinstal pada perangkat inti Greengrass. Versi 20.10 adalah versi terbaru yang diverifikasi untuk bekerja dengan perangkat lunak AWS IoT Greengrass Core. Anda harus menginstal Docker langsung pada perangkat inti sebelum Anda menyebarkan komponen yang menjalankan kontainer Docker. + Daemon Docker dimulai dan berjalan pada perangkat inti sebelum Anda men-deploy komponen ini. + Docker gambar disimpan di salah satu sumber gambar yang didukung berikut: + Repositori gambar publik dan privat di Amazon Elastic Container Registry (Amazon ECR) + Repositori Hub Docker publik + Registri Terpercaya Docker publik + Gambar Docker disertakan sebagai artefak dalam komponen kontainer Docker kustom Anda. Gunakan format URI berikut untuk menentukan gambar Docker Anda: + Gambar Amazon ECR privat: `docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]` + Citra Amazon ECR publik: `docker:public.ecr.aws/repository/image[:tag|@digest]` + Gambar Hub Docker publik: `docker:name[:tag|@digest]` Untuk informasi selengkapnya, lihat [Jalankan kontainer Docker](run-docker-container.md). **catatan** Jika Anda tidak menentukan tanda gambar atau digest gambar di URI artefak untuk gambar, maka manajer aplikasi Docker akan menarik versi terbaru yang tersedia dari gambar tersebut ketika Anda menggunakan komponen kontainer Docker kustom Anda. Untuk memastikan bahwa semua perangkat inti menjalankan versi gambar yang sama, sebaiknya sertakan tag gambar atau diges gambar di URI artefak. + Pengguna sistem yang menjalankan komponen kontainer Docker harus memiliki izin root atau administrator, atau Anda harus mengonfigurasi Docker untuk menjalankannya sebagai pengguna non-root atau non-admistrator. + Pada perangkat Linux, Anda dapat menambahkan pengguna ke `docker` grup untuk memanggil `docker` perintah tanpa`sudo`. + Pada perangkat Windows, Anda dapat menambahkan pengguna ke `docker-users` grup untuk memanggil `docker` perintah tanpa hak istimewa adminstrator. ------ #### [ Linux or Unix ] Untuk menambahkan`ggc_user`, atau pengguna non-root yang Anda gunakan untuk menjalankan komponen kontainer Docker, ke `docker` grup, jalankan perintah berikut. ``` sudo usermod -aG docker ggc_user ``` Untuk informasi selengkapnya, lihat [Mengelola Docker sebagai pengguna non-root](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user). ------ #### [ Windows Command Prompt (CMD) ] Untuk menambahkan`ggc_user`, atau pengguna yang Anda gunakan untuk menjalankan komponen kontainer Docker, ke `docker-users` grup, jalankan perintah berikut sebagai administrator. ``` net localgroup docker-users ggc_user /add ``` ------ #### [ Windows PowerShell ] Untuk menambahkan`ggc_user`, atau pengguna yang Anda gunakan untuk menjalankan komponen kontainer Docker, ke `docker-users` grup, jalankan perintah berikut sebagai administrator. ``` Add-LocalGroupMember -Group docker-users -Member ggc_user ``` ------ + Jika Anda [mengkonfigurasi perangkat lunak AWS IoT Greengrass Core untuk menggunakan proxy jaringan](configure-greengrass-core-v2.md#configure-alpn-network-proxy), Anda harus [mengkonfigurasi Docker untuk menggunakan server proxy yang sama](https://docs.docker.com/network/proxy/). + Jika gambar Docker Anda disimpan dalam registri privat Amazon ECR, maka Anda harus menyertakan komponen layanan pertukaran token sebagai dependensi dalam komponen kontainer Docker. Juga, [peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `ecr:GetAuthorizationToken`, `ecr:BatchGetImage`, dan `ecr:GetDownloadUrlForLayer`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "ecr:GetAuthorizationToken", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer" ], "Resource": [ "*" ], "Effect": "Allow" } ] } ``` ------ ``` ``` + Komponen manajer aplikasi docker didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan. + Komponen manajer aplikasi docker harus memiliki konektivitas untuk mengunduh gambar. Misalnya, jika Anda menggunakan ECR, Anda harus memiliki konektivitas ke titik akhir berikut. + `*.dkr.ecr.region.amazonaws.com`(Titik akhir VPC) `com.amazonaws.region.ecr.dkr` + `api.ecr.region.amazonaws.com`(Titik akhir VPC) `com.amazonaws.region.ecr.api` ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `ecr.region.amazonaws.com` | 443 | Tidak | Diperlukan jika Anda mengunduh gambar Docker dari Amazon ECR. | | `hub.docker.com` `registry.hub.docker.com/v1` | 443 | Tidak | Diperlukan jika Anda mengunduh gambar Docker dari Docker Hub. | ## 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](#docker-application-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.0.15 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.15 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.17.0 | Lunak | ------ #### [ 2.0.14 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.14 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.16.0 | Lunak | ------ #### [ 2.0.13 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.13 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.15.0 | Lunak | ------ #### [ 2.0.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.14.0 | Lunak | ------ #### [ 2.0.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.13.0 | Lunak | ------ #### [ 2.0.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.10 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Lunak | ------ #### [ 2.0.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Lunak | ------ #### [ 2.0.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Lunak | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Lunak | ------ #### [ 2.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Lunak | ------ #### [ 2.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Lunak | ------ #### [ 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Lunak | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Lunak | ------ #### [ 2.0.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Lunak | ------ #### [ 2.0.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Lunak | ------ #### [ 2.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. ## Berkas log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.0.16 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.0.15 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.0.14 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.0.13 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.0.12 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.0.11 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.0.10 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.0.9 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.0.6 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.0.5 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.0.4 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.0 | Versi awal. | ## Lihat juga + [Jalankan kontainer Docker](run-docker-container.md) # Konektor tepi untuk Kinesis Video Streams Konektor tepi untuk `aws.iot.EdgeConnectorForKVS` komponen Kinesis Video Streams () membaca umpan video dari kamera lokal dan menerbitkan aliran ke Kinesis Video Streams. Anda dapat mengonfigurasi komponen ini untuk membaca umpan video dari kamera Internet Protocol (IP) menggunakan Real Time Streaming Protocol (RTSP). Kemudian, Anda dapat mengatur dasbor di [Grafana Terkelola Amazon](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) atau server Grafana lokal untuk memantau dan berinteraksi dengan aliran video. Anda dapat mengintegrasikan komponen ini AWS IoT TwinMaker untuk menampilkan dan mengontrol aliran video di dasbor Grafana. AWS IoT TwinMaker adalah AWS layanan yang memungkinkan Anda membangun kembar digital operasional sistem fisik. Anda dapat menggunakan AWS IoT TwinMaker untuk memvisualisasikan data dari sensor, kamera, dan aplikasi perusahaan bagi Anda untuk melacak pabrik fisik, bangunan, atau pabrik industri Anda. Anda juga dapat menggunakan data ini untuk memantau operasi, mendiagnosis kesalahan, dan memperbaiki kesalahan. Untuk informasi lebih lanjut, lihat [Apa itu AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) dalam *AWS IoT TwinMaker User Guide*. Komponen ini menyimpan konfigurasinya di AWS IoT SiteWise, yang merupakan AWS layanan yang memodelkan dan menyimpan data industri. Dalam AWS IoT SiteWise, *aset* mewakili objek seperti perangkat, peralatan, atau kelompok objek lain. Untuk mengonfigurasi dan menggunakan komponen ini, Anda membuat AWS IoT SiteWise aset untuk setiap perangkat inti Greengrass dan untuk setiap kamera IP yang terhubung ke setiap perangkat inti. Setiap aset memiliki properti yang Anda konfigurasikan untuk mengontrol fitur, seperti streaming langsung, unggahan sesuai permintaan, dan caching lokal. Untuk menentukan URL untuk setiap kamera, Anda membuat rahasia AWS Secrets Manager yang berisi URL kamera. Jika kamera memerlukan otentikasi, Anda juga menentukan nama pengguna dan kata sandi di URL. Kemudian, Anda menentukan rahasia itu di properti aset untuk kamera IP. Komponen ini mengunggah aliran video setiap kamera ke aliran video Kinesis. Anda menentukan nama aliran video Kinesis tujuan dalam konfigurasi AWS IoT SiteWise aset untuk setiap kamera. Jika aliran video Kinesis tidak ada, komponen ini membuatnya untuk Anda. AWS IoT TwinMaker menyediakan skrip yang dapat Anda jalankan untuk membuat AWS IoT SiteWise aset dan rahasia Secrets Manager ini. Untuk informasi selengkapnya tentang cara membuat sumber daya ini, serta cara menginstal, mengonfigurasi, dan menggunakan komponen ini, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. **catatan** Konektor tepi untuk komponen Kinesis Video Streams hanya tersedia dalam hal berikut: Wilayah AWS AS Timur (Virginia Utara) AS Barat (Oregon) Eropa (Frankfurt) Eropa (Irlandia) Asia Pasifik (Singapura) Asia Pasifik (Tokyo) Asia Pacific (Seoul) Asia Pasifik (Sydney) Asia Pasifik (Mumbai) Tiongkok (Beijing) **Topics** + [Versi](#kvs-edge-connector-component-versions) + [Jenis](#kvs-edge-connector-component-type) + [Sistem operasi](#kvs-edge-connector-component-os-support) + [Persyaratan](#kvs-edge-connector-component-requirements) + [Dependensi](#kvs-edge-connector-component-dependencies) + [Konfigurasi](#kvs-edge-connector-component-configuration) + [Lisensi](#kvs-edge-connector-component-licenses) + [Penggunaan](#kvs-edge-connector-component-usage) + [File log lokal](#kvs-edge-connector-component-log-file) + [Changelog](#kvs-edge-connector-component-changelog) + [Lihat juga](#kvs-edge-connector-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 1.0.x ## Jenis Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Anda dapat menerapkan komponen ini hanya ke perangkat inti tunggal, karena konfigurasi komponen harus unik untuk setiap perangkat inti. Anda tidak dapat menerapkan komponen ini ke grup perangkat inti. + [GStreamer](https://gstreamer.freedesktop.org)1.18.4 atau yang lebih baru diinstal pada perangkat inti. Untuk informasi selengkapnya, lihat [Menginstal GStreamer](https://gstreamer.freedesktop.org/documentation/installing/index.html?gi-language=c). Pada perangkat dengan`apt`, Anda dapat menjalankan perintah berikut untuk menginstal GStreamer. ``` sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps sudo apt install -y gstreamer1.0-libav sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools ``` + AWS IoT SiteWise Aset untuk setiap perangkat inti. AWS IoT SiteWise Aset ini mewakili perangkat inti. Untuk informasi selengkapnya tentang cara membuat aset ini, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. + AWS IoT SiteWise Aset untuk setiap kamera IP yang Anda sambungkan ke setiap perangkat inti. AWS IoT SiteWise Aset ini mewakili kamera yang mengalirkan video ke setiap perangkat inti. Setiap aset kamera harus dikaitkan dengan aset untuk perangkat inti yang terhubung ke kamera. Aset kamera memiliki properti yang dapat Anda konfigurasikan untuk menentukan aliran video Kinesis, rahasia otentikasi, dan parameter streaming video. Untuk informasi selengkapnya tentang cara membuat dan mengonfigurasi aset kamera, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. + AWS Secrets Manager Rahasia untuk setiap kamera IP. Rahasia ini harus mendefinisikan pasangan kunci-nilai, di mana kuncinya`RTSPStreamUrl`, dan nilainya adalah URL untuk kamera. Jika kamera memerlukan otentikasi, sertakan nama pengguna dan kata sandi di URL ini. Anda dapat menggunakan skrip untuk membuat rahasia saat Anda membuat sumber daya yang dibutuhkan komponen ini. Untuk informasi selengkapnya, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. Anda juga dapat menggunakan konsol Secrets Manager dan API untuk membuat rahasia tambahan. Untuk informasi selengkapnya, lihat [Membuat rahasia](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) di *Panduan AWS Secrets Manager Pengguna*. + Peran [pertukaran token Greengrass](device-service-role.md) harus mengizinkan tindakan AWS Secrets Manager berikut,, dan AWS IoT SiteWise Kinesis Video Streams, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. **catatan** Kebijakan contoh ini memungkinkan perangkat untuk mendapatkan nilai rahasia bernama **IPCamera1Url** dan**IPCamera2Url**. Saat Anda mengonfigurasi setiap kamera IP, Anda menentukan rahasia yang berisi URL untuk kamera itu. Jika kamera memerlukan otentikasi, Anda juga menentukan nama pengguna dan kata sandi di URL. Peran pertukaran token perangkat inti harus memungkinkan akses ke rahasia untuk setiap kamera IP untuk terhubung. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera1Url", "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera2Url" ] }, { "Action": [ "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:DescribeAsset", "iotsitewise:DescribeAssetModel", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "kinesisvideo:CreateStream", "kinesisvideo:DescribeStream", "kinesisvideo:GetDataEndpoint", "kinesisvideo:PutMedia", "kinesisvideo:TagStream" ], "Effect": "Allow", "Resource": [ "*" ] } ] } ``` ------ **catatan** Jika Anda menggunakan AWS Key Management Service kunci yang dikelola pelanggan untuk mengenkripsi rahasia, peran perangkat juga harus mengizinkan `kms:Decrypt` tindakan. ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `kinesisvideo.region.amazonaws.com` | 443 | Ya | Unggah data ke Kinesis Video Streams. | | `data.iotsitewise.region.amazonaws.com` | 443 | Ya | Publikasikan metadata streaming video ke. AWS IoT SiteWise | | `secretsmanager.region.amazonaws.com` | 443 | Ya | Unduh rahasia URL kamera ke 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](#kvs-edge-connector-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. Tabel berikut mencantumkan dependensi untuk versi 1.0.0 hingga 1.0.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=2.0.3 | Keras | | [Manajer aliran](stream-manager-component.md) | >=2.0.9 | Keras | Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `SiteWiseAssetIdForHub` ID AWS IoT SiteWise aset yang mewakili perangkat inti ini. Untuk informasi selengkapnya tentang cara membuat aset ini dan menggunakannya untuk berinteraksi dengan komponen ini, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. **Example Contoh: Pembaruan gabungan konfigurasi** ``` { "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` ## Lisensi Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut: + [Penjadwal Pekerjaan Kuarsa/Lisensi](http://www.quartz-scheduler.org/) Apache 2.0 + [Binding Java untuk GStreamer 1.x/GNU](https://github.com/gstreamer-java/gst1-java-core) Lesser General Public License v3.0 ## Penggunaan Untuk mengonfigurasi dan berinteraksi dengan komponen ini, Anda dapat mengatur properti pada AWS IoT SiteWise aset yang mewakili perangkat inti dan kamera IP tempat ia terhubung. Anda juga dapat memvisualisasikan dan berinteraksi dengan aliran video di dasbor Grafana melalui. AWS IoT TwinMaker Untuk informasi selengkapnya, lihat [integrasi AWS IoT TwinMaker video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) di *Panduan AWS IoT TwinMaker Pengguna*. ## File log lokal Komponen ini menggunakan file log berikut. ``` /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ``` sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log ``` ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 1.0.5 | Perbaikan bug umum dan perbaikan. | | 1.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/kvs-edge-connector-component.html) | | 1.0.3 | Perbaikan bug umum dan perbaikan. | | 1.0.1 | Perbaikan bug umum dan perbaikan. | | 1.0.0 | Versi awal. | ## Lihat juga + [Apa itu AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) di *Panduan AWS IoT TwinMaker Pengguna* + [AWS IoT TwinMaker integrasi video](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) dalam *Panduan AWS IoT TwinMaker Pengguna* + [Apa itu AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) di *Panduan AWS IoT SiteWise Pengguna* + [Memperbarui nilai atribut](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-attribute-values.html) dalam *Panduan AWS IoT SiteWise Pengguna* + [Apa itu AWS Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) dalam *AWS Secrets Manager Panduan Penggguna* + [Membuat dan mengelola rahasia](https://docs.aws.amazon.com/secretsmanager/latest/userguide/managing-secrets.html) di *Panduan AWS Secrets Manager Pengguna* # Greengrass CLI Komponen Greengrass CLI (`aws.greengrass.Cli`) menyediakan antarmuka baris perintah lokal yang dapat Anda gunakan pada perangkat inti untuk mengembangkan dan debug komponen secara lokal. Greengrass CLI memungkinkan Anda untuk membuat deployment lokal dan me-restart komponen pada perangkat inti, misalnya. Anda dapat menginstal komponen ini ketika Anda menginstal perangkat lunak AWS IoT Greengrass Core. Untuk informasi selengkapnya, lihat [Tutorial: Memulai dengan AWS IoT Greengrass V2](getting-started.md). **penting** Kami menyarankan Anda menggunakan komponen ini hanya di lingkungan pengembangan, bukan lingkungan produksi. Komponen ini menyediakan akses ke informasi dan operasi yang biasanya tidak Anda perlukan di lingkungan produksi. Ikuti prinsip hak istimewa paling sedikit dengan menerapkan komponen ini hanya ke perangkat inti di mana Anda membutuhkannya. Setelah Anda menginstal komponen ini, jalankan perintah berikut untuk melihat dokumentasi bantuan. Ketika komponen ini diinstal, komponen tersebut menambahkan tautan simbolik ke `greengrass-cli` dalam folder `/greengrass/v2/bin`. Anda dapat menjalankan Greengrass CLI dari jalur ini atau menambahkannya ke variabel lingkungan `PATH` Anda untuk menjalankan `greengrass-cli` tanpa jalur absolutnya. ------ #### [ Linux or Unix ] ``` /greengrass/v2/bin/greengrass-cli help ``` ------ #### [ Windows ] ``` C:\greengrass\v2\bin\greengrass-cli help ``` ------ Perintah berikut me-restart komponen bernama `com.example.HelloWorld`, misalnya. ------ #### [ Linux or Unix ] ``` sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld" ``` ------ #### [ Windows ] ``` C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld" ``` ------ Untuk informasi selengkapnya, lihat [Antarmuka Baris Perintah Greengrass](gg-cli.md). **Topics** + [Versi](#greengrass-cli-component-versions) + [Tipe](#greengrass-cli-component-type) + [Sistem operasi](#greengrass-cli-component-os-support) + [Persyaratan](#greengrass-cli-component-requirements) + [Dependensi](#greengrass-cli-component-dependencies) + [Konfigurasi](#greengrass-cli-component-configuration) + [File log lokal](#greengrass-cli-component-log-file) + [Changelog](#greengrass-cli-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.17.x + 2.16.x + 2.15.x + 2.14.x + 2.13.x + 2.12.x + 2.11.x + 2.10.x + 2.9.x + 2.8.x + 2.7.x + 2.6.x + 2.5.x + 2.4.x + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Anda harus diberi wewenang untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Core. AWS IoT Greengrass Lakukan salah satu langkah berikut untuk menggunakan Greengrass CLI: + Gunakan pengguna sistem yang menjalankan perangkat lunak AWS IoT Greengrass Core. + Gunakan pengguna dengan izin root atau adminstratif. Pada perangkat inti Linux, Anda dapat menggunakan `sudo` untuk mendapatkan izin root. + Gunakan pengguna sistem yang berada dalam grup yang Anda tentukan dalam parameter `AuthorizedPosixGroups` atau `AuthorizedWindowsGroups` konfigurasi saat Anda menerapkan komponen. Untuk informasi selengkapnya, lihat konfigurasi [komponen CLI Greengrass](#greengrass-cli-component-configuration). + Komponen CLI Greengrass didukung untuk berjalan di VPC. ## 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](#greengrass-cli-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.16.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.16.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.17.0 | Lunak | ------ #### [ 2.15.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.15.1 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Lunak | ------ #### [ 2.15.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.15.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Lunak | ------ #### [ 2.14.0 – 2.14.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.14.0 dan 2.14.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.15.0 | Lunak | ------ #### [ 2.13.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.13.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.14.0 | Lunak | ------ #### [ 2.12.0 – 2.12.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.12.0 hingga 2.12.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.13.0 | Lunak | ------ #### [ 2.11.0 – 2.11.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.11.0 hingga 2.11.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Lunak | ------ #### [ 2.10.0 – 2.10.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.10.0 hingga 2.10.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Lunak | ------ #### [ 2.9.0 – 2.9.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.9.0 hingga 2.9.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Lunak | ------ #### [ 2.8.0 – 2.8.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.8.0 dan 2.8.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.9.0 | Lunak | ------ #### [ 2.7.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.7.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.8.0 | Lunak | ------ #### [ 2.6.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.6.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.7.0 | Lunak | ------ #### [ 2.5.0 – 2.5.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.0 hingga 2.5.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Lunak | ------ #### [ 2.4.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Lunak | ------ #### [ 2.3.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Lunak | ------ #### [ 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Lunak | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Lunak | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.1.0 | Lunak | **catatan** Versi kompatibel minimum dari nukleus Greengrass sesuai dengan versi patch komponen Greengrass CLI. ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ 2.5.x - 2.14.x ] `AuthorizedPosixGroups` (Opsional) String yang berisi daftar kelompok sistem yang dipisahkan dengan koma. Anda mengizinkan grup sistem ini untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Inti. AWS IoT Greengrass Anda dapat menentukan nama grup atau grup IDs. Misalnya, `group1,1002,group3` mengotorisasi tiga grup sistem (`group1`, `1002`, dan `group3`) untuk menggunakan Greengrass CLI. Jika Anda tidak menentukan grup apa pun untuk diotorisasi, Anda dapat menggunakan Greengrass CLI sebagai `sudo` pengguna root () atau sebagai pengguna sistem yang menjalankan perangkat lunak Core. AWS IoT Greengrass `AuthorizedWindowsGroups` (Opsional) String yang berisi daftar kelompok sistem yang dipisahkan dengan koma. Anda mengizinkan grup sistem ini untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Inti. AWS IoT Greengrass Anda dapat menentukan nama grup atau grup IDs. Misalnya, `group1,1002,group3` mengotorisasi tiga grup sistem (`group1`, `1002`, dan `group3`) untuk menggunakan Greengrass CLI. Jika Anda tidak menentukan grup apa pun untuk diotorisasi, Anda dapat menggunakan CLI Greengrass sebagai administrator atau sebagai pengguna sistem yang menjalankan perangkat lunak Core. AWS IoT Greengrass **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk mengotorisasi tiga grup sistem POSIX (`group1`,`1002`, dan`group3`) dan dua kelompok pengguna Windows (`Device Operators`dan`QA Engineers`) untuk menggunakan CLI Greengrass. ``` { "AuthorizedPosixGroups": "group1,1002,group3", "AuthorizedWindowsGroups": "Device Operators,QA Engineers" } ``` ------ #### [ 2.4.x - 2.0.x ] `AuthorizedPosixGroups` (Opsional) String yang berisi daftar kelompok sistem yang dipisahkan dengan koma. Anda mengizinkan grup sistem ini untuk menggunakan CLI Greengrass untuk berinteraksi dengan perangkat lunak Inti. AWS IoT Greengrass Anda dapat menentukan nama grup atau grup IDs. Misalnya, `group1,1002,group3` mengotorisasi tiga grup sistem (`group1`, `1002`, dan `group3`) untuk menggunakan Greengrass CLI. Jika Anda tidak menentukan grup apa pun untuk diotorisasi, Anda dapat menggunakan Greengrass CLI sebagai `sudo` pengguna root () atau sebagai pengguna sistem yang menjalankan perangkat lunak Core. AWS IoT Greengrass **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut akan menentukan untuk mengotorisasi tiga kelompok sistem (`group1`, `1002`, dan `group3`) untuk menggunakan Greengrass CLI. ``` { "AuthorizedPosixGroups": "group1,1002,group3" } ``` ------ ## File log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.17.0 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.16.1 | Versi diperbarui untuk Greengrass nucleus versi 2.16.1 rilis. | | 2.16.0 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.15.1 | Versi diperbarui untuk Greengrass nucleus versi 2.15.1 rilis. | | 2.15.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html) | | 2.14.3 | Versi diperbarui untuk Greengrass nucleus versi 2.14.3 rilis. | | 2.14.2 | Versi diperbarui untuk Greengrass nucleus versi 2.14.2 rilis. | | 2.14.1 | Versi diperbarui untuk Greengrass nucleus versi 2.14.1 rilis. | | 2.14.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html) | | 2.13.0 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.12.6 | Versi diperbarui untuk Greengrass nucleus versi 2.12.6 rilis. | | 2.12.5 | Versi diperbarui untuk Greengrass nucleus versi 2.12.5 rilis. | | 2.12.4 | Versi diperbarui untuk Greengrass nucleus versi 2.12.4 rilis. | | 2.12.3 | Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. Versi diperbarui untuk Greengrass nucleus versi 2.12.3 rilis. | | 2.12.2 | Versi diperbarui untuk Greengrass nucleus versi 2.12.2 rilis. | | 2.12.1 | Versi diperbarui untuk Greengrass nucleus versi 2.12.1 rilis. | | 2.12.0 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.11.3 | Versi diperbarui untuk Greengrass nucleus versi 2.11.3 rilis. | | 2.11.2 | Versi diperbarui untuk Greengrass nucleus versi 2.11.2 rilis. | | 2.11.1 | Versi diperbarui untuk Greengrass nucleus versi 2.11.1 rilis. | | 2.11.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html) | | 2.10.3 | Versi diperbarui untuk Greengrass nucleus versi 2.10.3 rilis. | | 2.10.2 | Versi diperbarui untuk Greengrass nucleus versi 2.10.2 rilis. | | 2.10.1 | Versi diperbarui untuk Greengrass nucleus versi 2.10.1 rilis. | | 2.10.0 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.9.6 | Versi diperbarui untuk Greengrass nucleus versi 2.9.6 rilis. | | 2.9.5 | Versi diperbarui untuk Greengrass nucleus versi 2.9.5 rilis. | | 2.9.4 | Versi diperbarui untuk Greengrass nucleus versi 2.9.4 rilis. | | 2.9.3 | Versi diperbarui untuk Greengrass nucleus versi 2.9.3 rilis. | | 2.9.2 | Versi diperbarui untuk Greengrass nucleus versi 2.9.2 rilis. | | 2.9.1 | Versi diperbarui untuk Greengrass nucleus versi 2.9.1 rilis. | | 2.9.0 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.8.1 | Versi diperbarui untuk Greengrass nucleus versi 2.8.1 rilis. | | 2.8.0 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.7.0 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html) | | 2.5.6 | Versi diperbarui untuk Greengrass nucleus versi 2.5.6 rilis. | | 2.5.5 | Versi diperbarui untuk Greengrass nucleus versi 2.5.5 rilis. | | 2.5.4 | Versi diperbarui untuk Greengrass nucleus versi 2.5.4 rilis. | | 2.5.3 | Versi diperbarui untuk Greengrass nucleus versi 2.5.3 rilis. | | 2.5.2 | Versi diperbarui untuk Greengrass nucleus versi 2.5.2 rilis. | | 2.5.1 | Versi diperbarui untuk Greengrass nucleus versi 2.5.1 rilis. | | 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html) | | 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/greengrass-cli-component.html) | | 2.3.0 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.2.0 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.0 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.5 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.0.5. | | 2.0.4 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.0.4. | | 2.0.3 | Versi awal. | # Detektor IP Komponen detektor IP (`aws.greengrass.clientdevices.IPDetector`) melakukan hal berikut: + Memantau informasi konektivitas jaringan perangkat inti Greengrass. Informasi ini mencakup titik akhir jaringan perangkat inti dan port tempat broker MQTT beroperasi. + Memperbarui informasi konektivitas perangkat inti di layanan AWS IoT Greengrass cloud. Perangkat klien dapat menggunakan penemuan cloud Greengrass untuk mengambil informasi konektivitas perangkat inti terkait. Kemudian, perangkat klien dapat mencoba untuk menyambung ke setiap perangkat inti sampai berhasil terhubung. **catatan** Perangkat klien adalah perangkat IoT lokal yang terhubung ke perangkat inti Greengrass untuk mengirim pesan MQTT dan data yang akan diproses. Untuk informasi selengkapnya, lihat [Berinteraksilah dengan perangkat IoT lokal](interact-with-local-iot-devices.md). Komponen detektor IP menggantikan informasi konektivitas perangkat inti yang ada dengan informasi dideteksinya. Karena komponen ini menghapus informasi yang ada, Anda dapat menggunakan komponen detektor IP, atau secara manual mengelola informasi konektivitas. **Topics** + [Versi](#ip-detector-component-versions) + [Tipe](#ip-detector-component-type) + [Sistem operasi](#ip-detector-component-os-support) + [Persyaratan](#ip-detector-component-requirements) + [Dependensi](#ip-detector-component-dependencies) + [Konfigurasi](#ip-detector-component-configuration) + [Berkas log lokal](#ip-detector-component-log-file) + [Changelog](#ip-detector-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + [Peran layanan Greengrass](greengrass-service-role.md) harus dikaitkan dengan Akun AWS Anda dan mengizinkan serta izin. `iot:GetThingShadow` `iot:UpdateThingShadow` + AWS IoT Kebijakan perangkat inti harus mengizinkan `greengrass:UpdateConnectivityInfo` izin. Untuk informasi selengkapnya, lihat [AWS IoT kebijakan untuk operasi pesawat data](device-auth.md#iot-policies) dan [AWS IoT Kebijakan minimal untuk mendukung perangkat klien](device-auth.md#client-device-support-minimal-iot-policy). + Jika Anda mengonfigurasi komponen broker MQTT perangkat inti untuk menggunakan port selain port default 8883, Anda harus menggunakan detektor IP v2.1.0 atau yang lebih baru. Konfigurasikan untuk melaporkan port tempat broker beroperasi. + Jika Anda memiliki penataan jaringan yang kompleks, komponen detektor IP mungkin tidak dapat mengidentifikasi titik akhir di mana perangkat klien dapat menyambung ke perangkat inti. Jika komponen detektor IP tidak dapat mengelola titik akhir, Anda harus secara manual mengelola titik akhir perangkat inti sebagai gantinya. Sebagai contoh, jika perangkat inti berada di belakang router yang meneruskan port broker MQTT ke sana, Anda harus menentukan alamat IP router sebagai titik akhir untuk perangkat inti. Untuk informasi selengkapnya, lihat [Kelola titik akhir perangkat inti](manage-core-device-endpoints.md). + Komponen detektor IP didukung untuk berjalan di VPC. ## 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](#ip-detector-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.2.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.17.0 | Lunak | ------ #### [ 2.2.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.16.0 | Lunak | ------ #### [ 2.2.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.15.0 | Lunak | ------ #### [ 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.14.0 | Lunak | ------ #### [ 2.1.8 – 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 dan 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.13.0 | Lunak | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.12.0 | Lunak | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.11.0 | Lunak | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.10.0 | Lunak | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | Lunak | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Lunak | ------ #### [ 2.1.0 and 2.0.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 dan 2.0.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Lunak | ------ #### [ 2.0.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Lunak | ------ #### [ 2.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ 2.2.x ] `defaultPort` (Opsional) Port broker MQTT untuk melaporkan kapan komponen ini mendeteksi alamat IP. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883. Default: `8883` `includeIPv4LoopbackAddrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama. Default: `false` `includeIPv4LinkLocalAddrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis. Default: `false` `includeIPv6LoopbackAddrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan uji di mana perangkat inti dan perangkat klien berjalan pada sistem yang sama. Anda harus mengatur `includeIPv4Addrs` ke `false` dan `includeIPv6Addrs` `true` untuk menggunakan opsi ini. Default: `false` `includeIPv6LinkLocalAddrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Protokol Konfigurasi Host Dinamis (DHCP) atau alamat IP yang ditetapkan secara statis. Anda harus mengatur `includeIPv4Addrs` ke `false` dan `includeIPv6Addrs` `true` untuk menggunakan opsi ini. Default: `false` `includeIPv4Addrs` (Opsional) Default diatur ke`true`. Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv4 alamat yang ditemukan di perangkat inti. Default: `true` `includeIPv6Addrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv6 alamat yang ditemukan di perangkat inti. Setel `includeIPv4Addrs` `false` untuk menggunakan opsi ini. Default: `false` ------ #### [ 2.1.x ] `defaultPort` (Opsional) Port broker MQTT untuk melaporkan kapan komponen ini mendeteksi alamat IP. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883. Default: `8883` `includeIPv4LoopbackAddrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama. Default: `false` `includeIPv4LinkLocalAddrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis. Default: `false` ------ #### [ 2.0.x ] `includeIPv4LoopbackAddrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama. Default: `false` `includeIPv4LinkLocalAddrs` (Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis. Default: `false` ------ ## Berkas log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.2.4 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.2.3 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.2.2 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.2.1 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.2.0 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/ip-detector-component.html) | | 2.1.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/ip-detector-component.html) | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/ip-detector-component.html) | | 2.1.1 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/ip-detector-component.html) | | 2.0.2 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.0 | Versi awal. | # Firehouse Komponen Firehose (`aws.greengrass.KinesisFirehose`) menerbitkan data melalui aliran pengiriman Amazon Data Firehose ke tujuan, seperti Amazon S3, Amazon Redshift, dan Amazon Service. OpenSearch Untuk informasi selengkapnya, lihat [Apa itu Amazon Data Firehose?](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html) di Panduan *Pengembang Firehose Data Amazon*. Untuk mempublikasikan aliran pengiriman Kinesis dengan komponen ini, publikasikan pesan ke topik yang berlangganan komponen ini. Secara default, komponen ini berlangganan topik [publish/subscribe](ipc-publish-subscribe.md) `kinesisfirehose/message` dan `kinesisfirehose/message/binary/#` lokal. Anda dapat menentukan topik lain, termasuk topik AWS IoT Core MQTT, saat Anda menerapkan komponen ini. **catatan** Komponen ini menyediakan fungsionalitas yang mirip dengan konektor Firehose di AWS IoT Greengrass V1. Untuk informasi selengkapnya, lihat [Konektor Firehose di Panduan](https://docs.aws.amazon.com/greengrass/latest/developerguide/kinesis-firehose-connector.html) Pengembang *AWS IoT Greengrass V1*. **Topics** + [Versi](#kinesis-firehose-component-versions) + [Jenis](#kinesis-firehose-component-type) + [Sistem operasi](#kinesis-firehose-component-os-support) + [Persyaratan](#kinesis-firehose-component-requirements) + [Dependensi](#kinesis-firehose-component-dependencies) + [Konfigurasi](#kinesis-firehose-component-configuration) + [Data input](#kinesis-firehose-component-input-data) + [Data output](#kinesis-firehose-component-output-data) + [Berkas log lokal](#kinesis-firehose-component-log-file) + [Lisensi](#kinesis-firehose-component-licenses) + [Changelog](#kinesis-firehose-component-changelog) + [Lihat juga](#kinesis-firehose-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 2.1.x + 2.0.x ## Jenis Komponen ini adalah komponen Lambda () `aws.greengrass.lambda`. [Inti [Greengrass](greengrass-nucleus-component.md) menjalankan fungsi Lambda komponen ini menggunakan komponen peluncur Lambda.](lambda-launcher-component.md) Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). + [Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH. + [Peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `firehose:PutRecord`, dan `firehose:PutRecordBatch`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "firehose:PutRecord", "firehose:PutRecordBatch" ], "Effect": "Allow", "Resource": [ "arn:aws:firehose:us-east-1:123456789012:deliverystream/stream-name" ] } ] } ``` ------ Anda dapat secara dinamis menimpa aliran pengiriman default dalam muatan pesan masukan untuk komponen ini. Jika aplikasi Anda menggunakan fitur ini, kebijakan IAM harus mencakup semua aliran target sebagai sumber daya. Anda dapat memberikan akses terperinci atau bersyarat ke sumber daya (misalnya, dengan menggunakan skema penamaan wildcard `*`). + Untuk menerima data keluaran dari komponen ini, Anda harus menggabungkan pemutakhiran konfigurasi berikut untuk [komponen router langganan lama (`aws.greengrass.LegacySubscriptionRouter`) saat menerapkan komponen](legacy-subscription-router-component.md) ini. Konfigurasi ini menentukan topik di mana komponen ini menerbitkan tanggapan. ------ #### [ Legacy subscription router v2.1.x ] ``` { "subscriptions": { "aws-greengrass-kinesisfirehose": { "id": "aws-greengrass-kinesisfirehose", "source": "component:aws.greengrass.KinesisFirehose", "subject": "kinesisfirehose/message/status", "target": "cloud" } } } ``` ------ #### [ Legacy subscription router v2.0.x ] ``` { "subscriptions": { "aws-greengrass-kinesisfirehose": { "id": "aws-greengrass-kinesisfirehose", "source": "arn:aws:lambda:region:aws:function:aws-greengrass-kinesisfirehose:version", "subject": "kinesisfirehose/message/status", "target": "cloud" } } } ``` + Ganti *region* dengan Wilayah AWS yang Anda gunakan. + Ganti *version* dengan versi fungsi Lambda yang dijalankan komponen ini. Untuk menemukan versi fungsi Lambda, Anda harus melihat resep untuk versi komponen ini yang ingin Anda deploy. Buka halaman detail komponen ini di [konsol AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) tersebut, dan cari pasangan nilai kunci **Fungsi Lambda**. Pasangan kunci-nilai ini berisi nama dan versi fungsi Lambda. **penting** Anda harus memperbarui versi fungsi Lambda pada router langganan warisan setiap kali Anda men-deploy komponen ini. Hal ini memastikan bahwa Anda menggunakan versi fungsi Lambda yang benar untuk versi komponen yang Anda deploy. ------ Untuk informasi selengkapnya, lihat [Buat deployment](create-deployments.md). + Komponen Firehose didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan. + Komponen Firehose harus memiliki konektivitas `firehose.region.amazonaws.com` yang memiliki titik akhir VPC. `com.amazonaws.region.kinesis-firehose` ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `firehose.region.amazonaws.com` | 443 | Ya | Unggah data ke Firehose. | ## 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](#kinesis-firehose-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.8 - 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 dan 2.1.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | >=1.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=1.0.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. **catatan** Konfigurasi default komponen ini meliputi parameter fungsi Lambda. Kami sarankan Anda mengedit hanya parameter berikut untuk mengonfigurasi komponen ini pada perangkat Anda. `lambdaParams` Sebuah objek yang berisi parameter untuk fungsi Lambda komponen ini. Objek ini berisi informasi berikut: `EnvironmentVariables` Sebuah objek yang berisi parameter fungsi Lambda ini. Objek ini berisi informasi berikut: `DEFAULT_DELIVERY_STREAM_ARN` ARN dari aliran pengiriman Firehose default tempat komponen mengirim data. Anda dapat menimpa aliran tujuan dengan properti `delivery_stream_arn` dalam muatan pesan masukan. Peran perangkat inti harus memungkinkan tindakan yang diperlukan pada semua aliran pengiriman target. Untuk informasi selengkapnya, lihat [Persyaratan](#kinesis-firehose-component-requirements). `PUBLISH_INTERVAL` (Opsional) Jumlah maksimum detik untuk menunggu sebelum komponen menerbitkan data batch ke Firehose. Untuk mengonfigurasi komponen untuk mempublikasikan metrik saat menerimanya, yang berarti tanpa batching, tentukan `0`. Nilai ini bisa paling banyak 900 detik. Default: 10 detik `DELIVERY_STREAM_QUEUE_SIZE` (Opsional) Jumlah maksimum rekaman yang disimpan dalam memori sebelum komponen menolak catatan baru untuk aliran pengiriman yang sama. Nilai ini harus setidaknya berisi 2.000 catatan. Default: 5.000 catatan `containerMode` (Opsional) Mode kontainerisasi untuk komponen ini. Pilih dari salah satu pilihan berikut: + `NoContainer` – Komponen tersebut tidak berjalan di lingkungan waktu aktif terisolasi. + `GreengrassContainer`— Komponen berjalan di lingkungan runtime yang terisolasi di dalam AWS IoT Greengrass wadah. Default: `GreengrassContainer` `containerParams` (Opsional) Sebuah objek yang berisi parameter kontainer untuk komponen ini. Komponen menggunakan parameter ini jika Anda menentukan `GreengrassContainer` untuk `containerMode`. Objek ini berisi informasi berikut: `memorySize` (Opsional) Jumlah memori (dalam kilobyte) yang akan dialokasikan ke komponen. Default ke 64 MB (65.535 KB). `pubsubTopics` (Opsional) Sebuah objek yang berisi topik di mana komponen berlangganan untuk menerima pesan. Anda dapat menentukan setiap topik dan apakah komponen berlangganan topik MQTT dari AWS IoT Core atau topik lokal. publish/subscribe Objek ini berisi informasi berikut: `0` - Ini adalah indeks himpunan sebagai string. Objek yang berisi informasi berikut: `type` (Opsional) Jenis publish/subscribe pesan yang digunakan komponen ini untuk berlangganan pesan. Pilih dari salah satu pilihan berikut: + `PUB_SUB` — Berlangganan pesan publish/subscribe lokal. Jika Anda memilih opsi ini, topik tidak dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). + `IOT_CORE`— Berlangganan pesan AWS IoT Core MQTT. Jika Anda memilih opsi ini, topik dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). Default: `PUB_SUB` `topic` (Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan `IotCore` untuk `type`, Anda dapat menggunakan wildcard MQTT (`+` dan `#`) dalam topik ini. **Example Contoh: Pembaruan gabungan konfigurasi (mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "DEFAULT_DELIVERY_STREAM_ARN": "arn:aws:firehose:us-west-2:123456789012:deliverystream/mystream" } }, "containerMode": "GreengrassContainer" } ``` **Example Contoh: Pembaruan gabungan konfigurasi (tidak ada mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "DEFAULT_DELIVERY_STREAM_ARN": "arn:aws:firehose:us-west-2:123456789012:deliverystream/mystream" } }, "containerMode": "NoContainer" } ``` ## Data input Komponen ini menerima konten pengaliran pada topik berikut dan mengirimkan konten ke aliran pengiriman target. Komponen menerima dua jenis data input: + Data JSON pada topik `kinesisfirehose/message`. + Data biner pada topik `kinesisfirehose/message/binary/#`. **Topik default untuk data JSON (penerbitan/berlangganan lokal):** `kinesisfirehose/message` Pesan menerima properti berikut. Pesan input harus dalam format JSON. `request` Data yang akan dikirim ke aliran pengiriman dan aliran pengiriman target, jika berbeda dari pengaliran default. Jenis: `object` yang berisi informasi berikut: `data` Data yang akan dikirim ke aliran pengiriman. Tipe: `string` `delivery_stream_arn` (Opsional) ARN dari aliran pengiriman Firehose target. Tentukan properti ini untuk menimpa aliran pengiriman default. Tipe: `string` `id` ID acak untuk permintaan. Gunakan properti ini untuk memetakan permintaan inpun untuk respons output. Ketika Anda menentukan properti ini, komponen menetapkan properti `id` di objek respons untuk nilai ini. Tipe: `string` **Example Contoh input** ``` { "request": { "delivery_stream_arn": "arn:aws:firehose:region:account-id:deliverystream/stream2-name", "data": "Data to send to the delivery stream." }, "id": "request123" } ``` **Topik default untuk data biner (penerbitan/berlangganan lokal):** `kinesisfirehose/message/binary/#` Gunakan topik ini untuk mengirim pesan yang berisi data biner. Komponen tidak mengurai data biner. Komponen mengalirkan data sebagaimana adanya. Untuk memetakan permintaan masukan untuk respons output, ganti wildcard `#` di topik pesan dengan ID permintaan arbitrer. Misalnya, jika Anda mempublikasikan pesan ke `kinesisfirehose/message/binary/request123`, properti `id` di objek respons akan ditetapkan ke `request123`. Jika Anda tidak ingin memetakan permintaan ke respons, Anda dapat mempublikasikan pesan ke `kinesisfirehose/message/binary/`. Pastikan untuk menyertakan garis miring (`/`). ## Data output Komponen ini menerbitkan tanggapan sebagai data output pada topik MQTT berikut secara default. Anda harus menentukan topik ini sebagai `subject` dalam konfigurasi untuk [komponen router langganan warisan](legacy-subscription-router-component.md). Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). **Topik default (AWS IoT Core MQTT):** `kinesisfirehose/message/status` **Example Contoh Output** Tanggapan berisi status setiap catatan data yang dikirim dalam batch. ``` { "response": [ { "ErrorCode": "error", "ErrorMessage": "test error", "id": "request123", "status": "fail" }, { "firehose_record_id": "xyz2", "id": "request456", "status": "success" }, { "firehose_record_id": "xyz3", "id": "request890", "status": "success" } ] } ``` **catatan** Jika komponen mendeteksi kesalahan yang dapat dicoba ulang, seperti kesalahan koneksi, ia akan mencoba ulang publikasi di batch berikutnya. ## Berkas log lokal Komponen ini menggunakan file log berikut. ``` /greengrass/v2/logs/aws.greengrass.KinesisFirehose.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.KinesisFirehose.log ``` ## Lisensi Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut: + [AWS SDK untuk Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0 + [botocore](https://pypi.org/project/botocore/)/Apache License 2.0 + [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License + [docutils](https://pypi.org/project/docutils/)/BSD License, Lisensi Publik Umum (GPL) GNU, Lisensi Dasar Perangkat Lunak Python, Domain Publik + [jmespath](https://pypi.org/project/jmespath/)/MIT License + [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0 + [urllib3](https://pypi.org/project/urllib3/)/MIT License Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.2 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.1 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/kinesis-firehose-component.html) | | 2.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.6 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.5 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.4 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.3 | Versi awal. | ## Lihat juga + [Apa itu Amazon Data Firehose?](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html) di Panduan *Pengembang Firehose Data Amazon* # Peluncur Lambda Komponen peluncur Lambda (`aws.greengrass.LambdaLauncher`) memulai dan menghentikan AWS Lambda fungsi pada AWS IoT Greengrass perangkat inti. Komponen ini juga mengatur kontainerisasi apa pun dan menjalankan proses sebagai pengguna yang Anda tentukan. **catatan** Ketika Anda men-deploy komponen fungsi Lambda ke perangkat inti, deployment juga mencakup komponen ini. Untuk informasi selengkapnya, lihat [Jalankan AWS Lambda fungsi](run-lambda-functions.md). **Topics** + [Versi](#lambda-launcher-component-versions) + [Tipe](#lambda-launcher-component-type) + [Sistem operasi](#lambda-launcher-component-os-support) + [Persyaratan](#lambda-launcher-component-requirements) + [Dependensi](#lambda-launcher-component-dependencies) + [Konfigurasi](#lambda-launcher-component-configuration) + [File log lokal](#lambda-launcher-component-log-file) + [Changelog](#lambda-launcher-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). + Komponen peluncur Lambda didukung untuk berjalan di VPC. ## 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](#lambda-launcher-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.0.11 – 2.0.13 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.11 hingga 2.0.13 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Manajer Lambda](lambda-manager-component.md) | >=2.0.0 <2.4.0 | Keras | ------ #### [ 2.0.9 – 2.0.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.9 hingga 2.0.10 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Manajer Lambda](lambda-manager-component.md) | >=2.0.0 <2.3.0 | Keras | ------ #### [ 2.0.4 - 2.0.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 hingga 2.0.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Manajer Lambda](lambda-manager-component.md) | >=2.0.0 <2.2.0 | Keras | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Manajer Lambda](lambda-manager-component.md) | >=2.0.3 <2.1.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. ## File log lokal Komponen ini menggunakan file log berikut. ``` /greengrass/v2/logs/lambdaFunctionComponentName.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan path ke folder AWS IoT Greengrass root, dan ganti *lambdaFunctionComponentName* dengan nama komponen fungsi Lambda yang diluncurkan komponen ini. ``` sudo tail -f /greengrass/v2/logs/lambdaFunctionComponentName.log ``` ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.0.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-launcher-component.html) | | 2.0.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-launcher-component.html) | | 2.0.11 | Support untuk Lambda manager 2.3.0. | | 2.0.10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-launcher-component.html) | | 2.0.9 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.7 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.6 | Peningkatan performa umum dan perbaikan bug. | | 2.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-launcher-component.html) | | 2.0.3 | Versi awal. | # Manajer Lambda Komponen manajer Lambda (`aws.greengrass.LambdaManager`) mengelola item kerja dan komunikasi interproses untuk AWS Lambda fungsi yang berjalan pada perangkat inti Greengrass. **catatan** Ketika Anda men-deploy komponen fungsi Lambda ke perangkat inti, deployment juga mencakup komponen ini. Untuk informasi selengkapnya, lihat [Jalankan AWS Lambda fungsi](run-lambda-functions.md). **Topics** + [Versi](#lambda-manager-component-versions) + [Sistem operasi](#lambda-manager-component-os-support) + [Tipe](#lambda-manager-component-type) + [Persyaratan](#lambda-manager-component-requirements) + [Dependensi](#lambda-manager-component-dependencies) + [Konfigurasi](#lambda-manager-component-configuration) + [Berkas log lokal](#lambda-manager-component-log-file) + [Changelog](#lambda-manager-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). + Komponen manajer Lambda didukung untuk berjalan di VPC. ## 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](#lambda-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.3.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.17.0 | Lunak | ------ #### [ 2.3.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Lunak | ------ #### [ 2.3.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Lunak | ------ #### [ 2.3.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Lunak | ------ #### [ 2.3.2 and 2.3.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.2 dan 2.3.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | ------ #### [ 2.2.10 and 2.3.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.10 dan 2.3.1 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | ------ #### [ 2.2.8 and 2.2.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.8 dan 2.2.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | ------ #### [ 2.2.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | ------ #### [ 2.2.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 2.2.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 2.2.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 2.2.1 - 2.2.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.1 hingga 2.2.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Lunak | ------ #### [ 2.1.3 and 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 dan 2.1.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `logHandlerMode` Hanya untuk manajer lambda versi 2.3.0\$1 Digunakan untuk memilih implementasi manajer log Lambda untuk digunakan. Tetapkan nilainya `optimized` untuk menggunakan lebih sedikit utas untuk membaca log lambda. `getResultTimeoutInSecond` (Opsional) Jumlah waktu maksimum dalam detik yang dapat dijalankan oleh fungsi Lambda sebelum waktunya habis. Default: `60` ## Berkas log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ``` /greengrass/v2/logs/greengrass.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.3.8 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.3.7 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.3.6 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.3.4 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.3.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.3.2 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.2.11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.2.10 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.2.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.2.8 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.2.7 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.2.6 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.2.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.2.4 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-manager-component.html) | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.0 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.3 | Versi awal. | # Runtime Lambda Komponen runtime Lambda (`aws.greengrass.LambdaRuntimes`) menyediakan runtime yang digunakan perangkat inti Greengrass untuk menjalankan fungsi. AWS Lambda **catatan** Ketika Anda men-deploy komponen fungsi Lambda ke perangkat inti, deployment juga mencakup komponen ini. Untuk informasi selengkapnya, lihat [Jalankan AWS Lambda fungsi](run-lambda-functions.md). **Topics** + [Versi](#lambda-runtimes-component-versions) + [Tipe](#lambda-runtimes-component-type) + [Sistem operasi](#lambda-runtimes-component-os-support) + [Persyaratan](#lambda-runtimes-component-requirements) + [Dependensi](#lambda-runtimes-component-dependencies) + [Konfigurasi](#lambda-runtimes-component-configuration) + [Berkas log lokal](#lambda-runtimes-component-log-file) + [Changelog](#lambda-runtimes-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). + Komponen runtime Lambda didukung untuk berjalan di VPC. ## Dependensi Komponen ini tidak memiliki dependensi apa pun. ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. ## Berkas log lokal Komponen ini tidak mengeluarkan log. ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.0.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/lambda-runtimes-component.html) | | 2.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.6 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.5 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.4 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.3 | Versi awal. | # Router langganan warisan Router langganan warisan (`aws.greengrass.LegacySubscriptionRouter`) mengelola langganan pada perangkat inti Greengrass. Langganan adalah fitur AWS IoT Greengrass V1 yang menentukan topik yang dapat digunakan fungsi Lambda untuk pengiriman pesan MQTT pada perangkat inti. Untuk informasi selengkapnya, lihat [Langganan terkelola dalam alur kerja olahpesan MQTT](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-sec.html#gg-msg-workflow) di *Panduan Developer V1 AWS IoT Greengrass *. Anda dapat menggunakan komponen ini untuk mengaktifkan langganan komponen konektor dan komponen fungsi Lambda yang menggunakan Core AWS IoT Greengrass SDK. **catatan** Komponen router langganan lama hanya diperlukan jika fungsi Lambda Anda menggunakan fungsi `publish()` di Core AWS IoT Greengrass SDK. Jika Anda memperbarui kode fungsi Lambda Anda untuk menggunakan antarmuka komunikasi antarproses (IPC) di AWS IoT Device SDK V2, Anda tidak perlu menggunakan komponen router langganan lama. Untuk informasi lebih lanjut, lihat layanan [komunikasi antar proses](interprocess-communication.md) berikut ini: [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md) [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md) **Topics** + [Versi](#legacy-subscription-router-component-versions) + [Tipe](#legacy-subscription-router-component-type) + [Sistem operasi](#legacy-subscription-router-component-os-support) + [Persyaratan](#legacy-subscription-router-component-requirements) + [Dependensi](#legacy-subscription-router-component-dependencies) + [Konfigurasi](#legacy-subscription-router-component-configuration) + [File log lokal](#legacy-subscription-router-component-log-file) + [Changelog](#legacy-subscription-router-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Router langganan lama didukung untuk berjalan di VPC. ## 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](#legacy-subscription-router-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.15 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.15 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.17.0 | Lunak | ------ #### [ 2.1.14 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.14 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Lunak | ------ #### [ 2.1.13 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.13 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Lunak | ------ #### [ 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Lunak | ------ #### [ 2.1.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ v2.1.x ] `subscriptions` (Opsional) Langganan yang akan diaktifkan pada perangkat inti. Ini adalah objek, di mana setiap kunci adalah ID unik, dan setiap nilai adalah objek yang mendefinisikan langganan untuk konektor itu. Anda harus mengonfigurasi langganan saat menerapkan komponen konektor V1 atau fungsi Lambda yang menggunakan Core SDK. AWS IoT Greengrass Setiap objek langganan berisi informasi berikut. `id` ID unik langganan ini. ID ini harus sesuai dengan kunci untuk objek langganan ini. `source` Fungsi Lambda yang menggunakan AWS IoT Greengrass Core SDK untuk mempublikasikan pesan MQTT pada topik yang Anda tentukan. `subject` Tentukan satu dari yang berikut ini: + Nama komponen fungsi Lambda pada perangkat inti. Tentukan nama komponen dengan prefiks `component:`, seperti **component:com.example.HelloWorldLambda**. + Amazon Resource Name (ARN) dari fungsi Lambda pada perangkat inti. **penting** Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut. Anda harus menentukan Nama Sumber Daya Amazon (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti `$LATEST`. Untuk menggunakan langganan untuk komponen konektor V1, tentukan nama komponen atau ARN dari komponen konektor fungsi Lambda. `subject` Topik MQTT atau filter topik di mana sumber dan target dapat mempublikasikan dan menerima pesan. Nilai ini mendukung wildcard topik `+` dan `#`. `target` Target yang menerima pesan MQTT pada topik yang Anda tentukan di `subject`. Langganan menentukan bahwa `source` fungsi menerbitkan pesan MQTT AWS IoT Core ke atau ke fungsi Lambda pada perangkat inti. Tentukan satu dari yang berikut ini: + `cloud`. `source`Fungsi ini menerbitkan pesan MQTT ke. AWS IoT Core + Nama komponen fungsi Lambda pada perangkat inti. Tentukan nama komponen dengan prefiks `component:`, seperti **component:com.example.HelloWorldLambda**. + Amazon Resource Name (ARN) dari fungsi Lambda pada perangkat inti. **penting** Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut. Anda harus menentukan Nama Sumber Daya Amazon (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti `$LATEST`. Default: Tidak ada langganan **Example Contoh pembaruan konfigurasi (mendefinisikan langganan ke AWS IoT Core)** Contoh berikut menentukan bahwa komponen fungsi `com.example.HelloWorldLambda` Lambda menerbitkan pesan MQTT pada topik. AWS IoT Core `hello/world` ``` { "subscriptions": { "Greengrass_HelloWorld_to_cloud": { "id": "Greengrass_HelloWorld_to_cloud", "source": "component:com.example.HelloWorldLambda", "subject": "hello/world", "target": "cloud" } } } ``` **Example Contoh pembaruan konfigurasi (mendefinisikan langganan ke fungsi Lambda)** Contoh berikut menetapkan bahwa komponen fungsi Lambda `com.example.HelloWorldLambda` menerbitkan pesan MQTT untuk komponen fungsi Lambda `com.example.MessageRelay` pada topik `hello/world`. ``` { "subscriptions": { "Greengrass_HelloWorld_to_MessageRelay": { "id": "Greengrass_HelloWorld_to_MessageRelay", "source": "component:com.example.HelloWorldLambda", "subject": "hello/world", "target": "component:com.example.MessageRelay" } } } ``` ------ #### [ v2.0.x ] `subscriptions` (Opsional) Langganan yang akan diaktifkan pada perangkat inti. Ini adalah objek, di mana setiap kunci adalah ID unik, dan setiap nilai adalah objek yang mendefinisikan langganan untuk konektor itu. Anda harus mengonfigurasi langganan saat menerapkan komponen konektor V1 atau fungsi Lambda yang menggunakan Core SDK. AWS IoT Greengrass Setiap objek langganan berisi informasi berikut. `id` ID unik langganan ini. ID ini harus sesuai dengan kunci untuk objek langganan ini. `source` Fungsi Lambda yang menggunakan AWS IoT Greengrass Core SDK untuk mempublikasikan pesan MQTT pada topik yang Anda tentukan. `subject` Tentukan hal berikut: + Amazon Resource Name (ARN) dari fungsi Lambda pada perangkat inti. **penting** Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut. Anda harus menentukan Nama Sumber Daya Amazon (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti `$LATEST`. Untuk menggunakan langganan untuk komponen konektor V1, tentukan ARN dari komponen konektor fungsi Lambda. `subject` Topik MQTT atau filter topik di mana sumber dan target dapat mempublikasikan dan menerima pesan. Nilai ini mendukung wildcard topik `+` dan `#`. `target` Target yang menerima pesan MQTT pada topik yang Anda tentukan di `subject`. Langganan menentukan bahwa `source` fungsi menerbitkan pesan MQTT AWS IoT Core ke atau ke fungsi Lambda pada perangkat inti. Tentukan satu dari yang berikut ini: + `cloud`. `source`Fungsi ini menerbitkan pesan MQTT ke. AWS IoT Core + Amazon Resource Name (ARN) dari fungsi Lambda pada perangkat inti. **penting** Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut. Anda harus menentukan Nama Sumber Daya Amazon (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti `$LATEST`. Default: Tidak ada langganan **Example Contoh pembaruan konfigurasi (mendefinisikan langganan ke AWS IoT Core)** Contoh berikut menentukan bahwa `Greengrass_HelloWorld` fungsi menerbitkan pesan MQTT pada topik. AWS IoT Core `hello/world` ``` "subscriptions": { "Greengrass_HelloWorld_to_cloud": { "id": "Greengrass_HelloWorld_to_cloud", "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5", "subject": "hello/world", "target": "cloud" } } ``` **Example Contoh pembaruan konfigurasi (mendefinisikan langganan ke fungsi Lambda)** Contoh berikut menetapkan bahwa fungsi `Greengrass_HelloWorld` menerbitkan pesan MQTT ke `Greengrass_MessageRelay` pada topik `hello/world`. ``` "subscriptions": { "Greengrass_HelloWorld_to_MessageRelay": { "id": "Greengrass_HelloWorld_to_MessageRelay", "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5", "subject": "hello/world", "target": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_MessageRelay:5" } } ``` ------ ## File log lokal Komponen ini tidak mengeluarkan log. ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | Versi | Perubahan | | --- | --- | | 2.1.16 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.1.15 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.1.14 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.1.13 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/legacy-subscription-router-component.html) | | 2.0.3 | Versi awal. | # Konsol debug lokal Komponen konsol debug lokal (`aws.greengrass.LocalDebugConsole`) menyediakan dasbor lokal yang menampilkan informasi tentang perangkat AWS IoT Greengrass inti Anda dan komponennya. Anda dapat menggunakan dasbor ini untuk men-debug perangkat inti Anda dan mengelola komponen lokal. **penting** Kami menyarankan Anda menggunakan komponen ini hanya di lingkungan pengembangan, bukan lingkungan produksi. Komponen ini menyediakan akses ke informasi dan operasi yang biasanya tidak Anda perlukan di lingkungan produksi. Ikuti prinsip hak istimewa paling sedikit dengan menerapkan komponen ini hanya ke perangkat inti di mana Anda membutuhkannya. **Topics** + [Versi](#local-debug-console-component-versions) + [Tipe](#local-debug-console-component-type) + [Sistem operasi](#local-debug-console-component-os-support) + [Persyaratan](#local-debug-console-component-requirements) + [Dependensi](#local-debug-console-component-dependencies) + [Konfigurasi](#local-debug-console-component-configuration) + [Penggunaan](#local-debug-console-component-usage) + [File log lokal](#local-debug-console-component-log-file) + [Changelog](#local-debug-console-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.4.x + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Anda menggunakan nama pengguna dan kata sandi untuk masuk ke dasbor. Nama pengguna, yaitu `debug`, disediakan untuk Anda. Anda harus menggunakan AWS IoT Greengrass CLI untuk membuat kata sandi sementara yang mengautentikasi Anda dengan dasbor pada perangkat inti. Anda harus dapat menggunakan AWS IoT Greengrass CLI untuk menggunakan konsol debug lokal. Untuk informasi lebih lanjut, lihat [Persyaratan Greengrass CLI](greengrass-cli-component.md#greengrass-cli-component-requirements). Untuk informasi lebih lanjut tentang cara membuat kata sandi dan masuk, lihat [Penggunaan komponen konsol debug lokal](#local-debug-console-component-usage). + Komponen konsol debug lokal didukung untuk berjalan di VPC. ## 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](#local-debug-console-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.4.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.17.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.10.0 <2.17.0 | Keras | ------ #### [ 2.4.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.16.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.10.0 <2.16.0 | Keras | ------ #### [ 2.4.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.15.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.10.0 <2.15.0 | Keras | ------ #### [ 2.4.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.14.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.10.0 <2.14.0 | Keras | ------ #### [ 2.4.1 – 2.4.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.1 hingga 2.4.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.13.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.10.0 <2.13.0 | Keras | ------ #### [ 2.4.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.4.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.12.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.10.0 <2.12.0 | Keras | ------ #### [ 2.3.0 and 2.3.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.0 dan 2.3.1 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.10.0 <2.12.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.10.0 <2.12.0 | Keras | ------ #### [ 2.2.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.12.0 | Keras | ------ #### [ 2.2.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.8 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.11.0 | Keras | ------ #### [ 2.2.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.10.0 | Keras | ------ #### [ 2.2.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.9.0 | Keras | ------ #### [ 2.2.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.8.0 | Keras | ------ #### [ 2.2.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.7.0 | Keras | ------ #### [ 2.2.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.6.0 | Keras | ------ #### [ 2.2.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.5.0 | Keras | ------ #### [ 2.2.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.4.0 | Keras | ------ #### [ 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.3.0 | Keras | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.1.0 <2.2.0 | Keras | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Lunak | | [CLI Greengrass](greengrass-cli-component.md) | >=2.0.3 <2.1.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ v2.1.x - v2.4.x ] `httpsEnabled` (Opsional) Anda dapat mengaktifkan HTTPS komunikasi untuk konsol debug lokal. Jika Anda mengaktifkan HTTPS komunikasi, konsol debug lokal akan membuat sertifikat yang ditandatangani sendiri. Peramban web menampilkan peringatan keamanan untuk situs web yang menggunakan sertifikat yang ditandatangani sendiri, sehingga Anda harus memverifikasi sertifikat secara manual. Kemudian, Anda dapat melewati peringatan ini. Untuk informasi selengkapnya, lihat [Penggunaan](#local-debug-console-component-usage). Default: `true` `port` (Opsional) Port tempat untuk menyediakan konsol debug lokal. Default: `1441` `websocketPort` (Opsional) Port websocket yang akan digunakan untuk konsol debug lokal. Default: `1442` `bindHostname` (Opsional) Nama host yang akan digunakan untuk konsol debug lokal. Jika Anda [menjalankan perangkat lunak AWS IoT Greengrass Core dalam wadah Docker](run-greengrass-docker.md), atur parameter ini ke`0.0.0.0`, sehingga Anda dapat membuka konsol debug lokal di luar wadah Docker. Default: `localhost` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk membuka konsol debug lokal pada port non-default dan menonaktifkan HTTPS. ``` { "httpsEnabled": false, "port": "10441", "websocketPort": "10442" } ``` ------ #### [ v2.0.x ] `port` (Opsional) Port tempat untuk menyediakan konsol debug lokal. Default: `1441` `websocketPort` (Opsional) Port websocket yang akan digunakan untuk konsol debug lokal. Default: `1442` `bindHostname` (Opsional) Nama host yang akan digunakan untuk konsol debug lokal. Jika Anda [menjalankan perangkat lunak AWS IoT Greengrass Core dalam wadah Docker](run-greengrass-docker.md), atur parameter ini ke`0.0.0.0`, sehingga Anda dapat membuka konsol debug lokal di luar wadah Docker. Default: `localhost` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk membuka konsol debug lokal pada port non-default. ``` { "port": "10441", "websocketPort": "10442" } ``` ------ ## Penggunaan Untuk menggunakan konsol debug lokal, buat sesi dari Greengrass CLI. Ketika Anda membuat sesi, Greengrass CLI akan menyediakan nama pengguna dan kata sandi sementara yang dapat Anda gunakan untuk masuk ke konsol debug lokal. Ikuti petunjuk ini untuk membuka konsol debug lokal pada perangkat inti atau komputer pengembangan Anda. ------ #### [ v2.1.x - v2.4.x ] Dalam versi 2.1.0 dan kemudian, konsol debug lokal menggunakan HTTPS secara default. Ketika HTTPS diaktifkan, konsol debug lokal membuat sertifikat yang ditandatangani sendiri untuk mengamankan sambungan. Peramban web Anda akan menunjukkan peringatan keamanan ketika Anda membuka konsol debug lokal karena sertifikat yang ditandatangani sendiri ini. Ketika Anda membuat sesi dengan Greengrass CLI, output akan mencakup sidik jari sertifikat, sehingga Anda dapat memverifikasi bahwa sertifikat itu sah dan sambungan aman. Anda dapat menonaktifkan HTTPS. Untuk informasi lebih lanjut, lihat [konfigurasi konsol debug lokal](#local-debug-console-component-configuration). **Untuk membuka konsol debug lokal** 1. (Opsional) Untuk melihat konsol debug lokal pada komputer pengembangan Anda, Anda dapat meneruskan port konsol melalui SSH. Namun, Anda harus mengaktifkan opsi `AllowTcpForwarding` di file konfigurasi SSH perangkat inti Anda. Opsi ini diatur secara default. Jalankan perintah berikut pada komputer pengembangan Anda untuk melihat dasbor di `localhost:1441` pada komputer pengembangan Anda. ``` ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address ``` **catatan** Anda dapat mengubah port default dari `1441` dan `1442`. Untuk informasi lebih lanjut, lihat [konfigurasi konsol debug lokal](#local-debug-console-component-configuration). 1. Buat sesi untuk menggunakan konsol debug lokal. Ketika Anda membuat sesi, Anda membuat kata sandi yang Anda gunakan untuk mengautentikasi. Konsol debug lokal memerlukan kata sandi untuk meningkatkan keamanan, karena Anda dapat menggunakan komponen ini untuk melihat informasi penting dan melakukan operasi pada perangkat inti. Konsol debug lokal juga menciptakan sertifikat untuk mengamankan sambungan jika Anda mengaktifkan HTTPS dalam konfigurasi komponen. HTTPS tidak diaktifkan secara default. Gunakan AWS IoT Greengrass CLI untuk membuat sesi. Perintah ini menghasilkan kata sandi 43 karakter acak yang akan kedaluwarsa setelah 8 jam. Ganti `/greengrass/v2` atau *C:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass V2 root. ------ #### [ Linux or Unix ] ``` sudo /greengrass/v2/bin/greengrass-cli get-debug-password ``` ------ #### [ Windows ] ``` C:\greengrass\v2\bin\greengrass-cli get-debug-password ``` ------ Perintah output terlihat seperti contoh berikut jika Anda telah mengonfigurasi konsol debug lokal untuk menggunakan HTTPS. Anda menggunakan sidik jari sertifikat untuk memverifikasi bahwa sambungan aman ketika Anda membuka konsol debug lokal. ``` Username: debug Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE Password expires at: 2021-04-01T17:01:43.921999931-07:00 The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console. Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints. SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1 ``` Komponen tampilan debug menciptakan sesi yang berlangsung selama 8 jam. Setelah itu, Anda harus menghasilkan kata sandi baru untuk melihat konsol debug lokal lagi. 1. Buka dan masuk ke dasbor. Lihat dasbor pada perangkat inti Greengrass Anda, atau pada komputer pengembangan Anda jika Anda meneruskan port melalui SSH. Lakukan salah satu tindakan berikut: + Jika Anda mengaktifkan HTTPS di konsol debug lokal, yang merupakan pengaturan default, lakukan hal berikut: 1. Buka `https://localhost:1441` pada perangkat inti Greengrass Anda, atau pada komputer pengembangan Anda jika Anda meneruskan port melalui SSH. Peramban Anda mungkin akan menampilkan peringatan keamanan tentang sertifikat keamanan yang tidak valid. 1. Jika peramban Anda menampilkan peringatan keamanan, verifikasi bahwa sertifikat itu sah dan lewati peringatan keamanan. Lakukan hal-hal berikut: 1. Temukan sidik jari SHA-256 atau SHA-1 untuk sertifikat itu, dan verifikasi bahwa ia cocok dengan sidik jari SHA-256 atau SHA-1 yang dicetak oleh perintah `get-debug-password` sebelumnya. Peramban Anda mungkin akan menyediakan satu atau kedua sidik jari itu. Lihat dokumentasi peramban Anda untuk melihat sertifikat dan sidik jarinya. Di beberapa peramban, sidik jari sertifikat disebut sidik jari. **catatan** Jika sidik jari sertifikat tidak cocok, buka [Step 2](#local-debug-console-component-create-session-step) untuk membuat sesi baru. Jika sidik jari sertifikat masih tidak cocok, koneksi Anda mungkin tidak aman. 1. Jika sidik jari sertifikat cocok, lewati peringatan keamanan peramban Anda untuk membuka konsol debug lokal. Lihat dokumentasi peramban Anda untuk melewati peringatan keamanan peramban. 1. Masuk ke situs web dengan menggunakan nama pengguna dan kata sandi yang dicetak oleh perintah `get-debug-password` sebelumnya. Konsol debug lokal terbuka. 1. Jika konsol debug lokal menunjukkan kesalahan yang mengatakan tidak dapat terhubung ke konsol WebSocket karena jabat tangan TLS gagal, Anda harus melewati peringatan keamanan yang ditandatangani sendiri untuk URL tersebut. WebSocket ![\[Kesalahan jabat tangan WebSocket TLS di konsol debug lokal.\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/images/local-debug-console/websocket-tls-handshake-error.png) Lakukan hal-hal berikut: 1. Buka `https://localhost:1442` di peramban yang sama di mana Anda membuka konsol debug lokal. 1. Verifikasi sertifikat dan lewati peringatan keamanan. Peramban Anda mungkin akan menampilkan halaman HTTP 404 setelah Anda melewati peringatan. 1. Buka `https://localhost:1441` lagi. Konsol debug lokal menunjukkan informasi tentang perangkat inti. + Jika Anda menonaktifkan HTTPS di konsol debug lokal, lakukan hal berikut: 1. Buka `http://localhost:1441` pada perangkat inti, atau buka pada komputer pengembangan Anda jika Anda meneruskan port melalui SSH. 1. Masuk ke situs web dengan menggunakan nama pengguna dan kata sandi yang dicetak oleh perintah `get-debug-password` sebelumnya. Konsol debug lokal terbuka. ------ #### [ v2.0.x ] **Untuk membuka konsol debug lokal** 1. (Opsional) Untuk melihat konsol debug lokal pada komputer pengembangan Anda, Anda dapat meneruskan port konsol melalui SSH. Namun, Anda harus mengaktifkan opsi `AllowTcpForwarding` di file konfigurasi SSH perangkat inti Anda. Opsi ini diatur secara default. Jalankan perintah berikut pada komputer pengembangan Anda untuk melihat dasbor di `localhost:1441` pada komputer pengembangan Anda. ``` ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address ``` **catatan** Anda dapat mengubah port default dari `1441` dan `1442`. Untuk informasi lebih lanjut, lihat [konfigurasi konsol debug lokal](#local-debug-console-component-configuration). 1. Buat sesi untuk menggunakan konsol debug lokal. Ketika Anda membuat sesi, Anda membuat kata sandi yang Anda gunakan untuk mengautentikasi. Konsol debug lokal memerlukan kata sandi untuk meningkatkan keamanan, karena Anda dapat menggunakan komponen ini untuk melihat informasi penting dan melakukan operasi pada perangkat inti. Gunakan AWS IoT Greengrass CLI untuk membuat sesi. Perintah ini menghasilkan kata sandi 43 karakter acak yang akan kedaluwarsa setelah 8 jam. Ganti `/greengrass/v2` atau *C:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass V2 root. ------ #### [ Linux or Unix ] ``` sudo /greengrass/v2/bin/greengrass-cli get-debug-password ``` ------ #### [ Windows ] ``` C:\greengrass\v2\bin\greengrass-cli get-debug-password ``` ------ Perintah output terlihat seperti contoh berikut. ``` Username: debug Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE Password will expire at: 2021-04-01T17:01:43.921999931-07:00 ``` Komponen tampilan debug menciptakan sesi yang berlangsung selama 4 jam, dan kemudian Anda harus menghasilkan kata sandi baru untuk melihat konsol debug lokal lagi. 1. Buka `http://localhost:1441` pada perangkat inti, atau buka pada komputer pengembangan Anda jika Anda meneruskan port melalui SSH. 1. Masuk ke situs web dengan menggunakan nama pengguna dan kata sandi yang dicetak oleh perintah `get-debug-password` sebelumnya. Konsol debug lokal terbuka. ------ ## File log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.4.7 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.4.6 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.4.5 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.4.4 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.4.3 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/local-debug-console-component.html) | | 2.4.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/local-debug-console-component.html) | | 2.4.1 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/local-debug-console-component.html) | | 2.3.1 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.3.0 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/local-debug-console-component.html) | | 2.2.7 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.2.6 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.2.5 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.2.4 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/local-debug-console-component.html) | | 2.2.2 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.2.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.2.0 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/local-debug-console-component.html) | | 2.0.3 | Versi awal. | # Manajer log **Awas** Sebaiknya upgrade ke Log Manager v2.3.5 atau yang lebih baru. Versi 2.3.5 mengoptimalkan penulisan konfigurasi Log Manager, mengurangi operasi IO dan meningkatkan kecepatan unggah log, kinerja perangkat secara keseluruhan, dan mungkin memperpanjang masa pakai perangkat. Komponen pengelola log (`aws.greengrass.LogManager`) mengunggah log dari perangkat AWS IoT Greengrass inti ke Amazon CloudWatch Logs. Anda dapat meng-upload log dari inti Greengrass, komponen Greengrass lainnya, dan aplikasi dan layanan lain yang bukan komponen Greengrass. Untuk informasi selengkapnya tentang cara memantau CloudWatch log di Log dan pada sistem file lokal, lihat[Memantau AWS IoT Greengrass log](monitor-logs.md). Pertimbangan berikut berlaku saat Anda menggunakan komponen pengelola log untuk menulis ke CloudWatch Log: + **Penundaan log** Komponen pengelola log versi 2.2.8 (dan sebelumnya) memproses dan mengunggah log hanya dari file log yang diputar. Secara default, perangkat lunak AWS IoT Greengrass Core memutar file log setiap jam atau setelah 1.024 KB. Akibatnya, komponen pengelola log mengunggah log hanya setelah perangkat lunak AWS IoT Greengrass Core atau komponen Greengrass menulis log senilai lebih dari 1.024 KB. Anda dapat mengonfigurasi batas ukuran file log yang lebih rendah untuk menyebabkan file log diputar lebih sering. Hal ini menyebabkan komponen pengelola log mengunggah CloudWatch log ke Log lebih sering. Komponen pengelola log versi 2.3.0 (dan yang lebih baru) memproses dan mengunggah semua log. Saat Anda menulis log baru, pengelola log versi 2.3.0 (dan yang lebih baru) memproses dan langsung mengunggah file log aktif itu alih-alih menunggu untuk diputar. Ini berarti Anda dapat melihat log baru dalam 5 menit atau kurang. Komponen pengelola log mengunggah log baru secara berkala. Secara default, komponen pengelola log mengunggah log baru setiap 5 menit. Anda dapat mengonfigurasi interval unggahan yang lebih rendah, sehingga komponen pengelola log mengunggah CloudWatch log ke Log lebih sering dengan mengonfigurasi log. `periodicUploadIntervalSec` Untuk informasi selengkapnya tentang cara mengonfigurasi interval periodik ini, lihat [Konfigurasi](https://docs.aws.amazon.com/greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration). Log dapat diunggah dalam waktu dekat dari sistem file Greengrass yang sama. Jika Anda perlu mengamati log secara real time, pertimbangkan untuk menggunakan [log sistem file](monitor-logs.md#access-local-logs). **catatan** Jika Anda menggunakan sistem file yang berbeda untuk menulis log, pengelola log kembali ke perilaku di komponen pengelola log versi 2.2.8 dan yang lebih lama. Untuk informasi tentang mengakses log sistem file, lihat [Mengakses log sistem file](https://docs.aws.amazon.com/greengrass/v2/developerguide/monitor-logs.html#access-local-logs). + **Jam miring** Komponen pengelola log menggunakan proses penandatanganan Signature Version 4 standar untuk membuat permintaan API ke CloudWatch Log. Jika waktu sistem pada perangkat inti tidak sinkron lebih dari 15 menit, maka CloudWatch Log menolak permintaan. Untuk informasi selengkapnya, lihat [Proses penandatanganan Versi Tanda Tangan 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) di *Referensi Umum AWS*. Untuk informasi tentang grup log dan pengaliran log yang padanya komponen ini meng-upload log, lihat [Penggunaan](#log-manager-component-usage). **Topics** + [Versi](#log-manager-component-versions) + [Tipe](#log-manager-component-type) + [Sistem operasi](#log-manager-component-os-support) + [Persyaratan](#log-manager-component-requirements) + [Dependensi](#log-manager-component-dependencies) + [Konfigurasi](#log-manager-component-configuration) + [Penggunaan](#log-manager-component-usage) + [Berkas log lokal](#log-manager-component-log-file) + [Changelog](#log-manager-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + [Peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `logs:CreateLogGroup`, `logs:CreateLogStream`, `logs:PutLogEvents`, dan `logs:DescribeLogStreams`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams" ], "Effect": "Allow", "Resource": "arn:aws:logs:*:*:*" } ] } ``` **catatan** Peran perangkat [Greengrass yang Anda buat saat menginstal perangkat](device-service-role.md) lunak Core menyertakan izin AWS IoT Greengrass dalam kebijakan contoh ini secara default. Untuk informasi selengkapnya, lihat [Menggunakan kebijakan berbasis identitas (kebijakan IAM) untuk Log CloudWatch di Panduan Pengguna](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-identity-based-access-control-cwl.html) Log *Amazon CloudWatch *. + Komponen pengelola log didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan. + Komponen pengelola log harus memiliki konektivitas `logs.region.amazonaws.com` yang memiliki titik akhir VPC. `com.amazonaws.us-east-1.logs` ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `logs.region.amazonaws.com` | 443 | Tidak | Diperlukan jika Anda menulis log ke CloudWatch Log. | ## 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](#log-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.3.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.17.0 | Lunak | ------ #### [ 2.3.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.16.0 | Lunak | ------ #### [ 2.3.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.15.0 | Lunak | ------ #### [ 2.3.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.8 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.14.0 | Lunak | ------ #### [ 2.3.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.13.0 | Lunak | ------ #### [ 2.3.5 and 2.3.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.5 dan 2.3.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Lunak | ------ #### [ 2.3.3 – 2.3.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.3 hingga 2.3.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Lunak | ------ #### [ 2.2.8 – 2.3.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.8 hingga 2.3.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Lunak | ------ #### [ 2.2.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Lunak | ------ #### [ 2.2.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Lunak | ------ #### [ 2.2.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Lunak | ------ #### [ 2.2.1 - 2.2.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.1 - 2.2.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Lunak | ------ #### [ 2.1.3 and 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 dan 2.2.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Lunak | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Lunak | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ v2.3.10 ] `logsUploaderConfiguration` (Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut: `systemLogsConfiguration` [(Opsional) Konfigurasi untuk log sistem perangkat lunak AWS IoT Greengrass Core, yang mencakup log dari inti [Greengrass](greengrass-nucleus-component.md) dan komponen plugin.](develop-greengrass-components.md#component-types) Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log mengelola log sistem. Objek ini berisi informasi berikut: `uploadToCloudWatch` (Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log. Default: `false` `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen [inti Greengrass](greengrass-nucleus-component.md) untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, `JSON` tentukan parameter [format logging](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`). Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukan. `diskSpaceLimitUnit` Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua. Parameter ini setara dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total maksimum. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `componentLogsConfigurationMap` (Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. Setiap `componentName` objek dalam peta ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log. Kami sangat menyarankan menggunakan satu kunci konfigurasi per komponen. Anda hanya boleh menargetkan sekelompok file yang hanya memiliki satu file log yang secara aktif ditulis saat menggunakan file`logFileRegex`. Tidak mengikuti rekomendasi ini dapat menyebabkan log duplikat diunggah. CloudWatch [Jika Anda menargetkan beberapa file log aktif dengan satu regex, kami sarankan Anda meningkatkan ke pengelola log v2.3.1 atau yang lebih baru dan pertimbangkan untuk mengubah konfigurasi Anda menggunakan konfigurasi contoh.](#log-manager-multiple-logs-v2.3.10) Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakan `componentLogsConfiguration` daftar alih-alih. `componentLogsConfigurationMap` Namun, kami sangat menyarankan Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk memodifikasi konfigurasi untuk komponen tertentu. Untuk informasi tentang `componentLogsConfiguration` parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini. *`componentName`* Konfigurasi log untuk *`componentName`* komponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini. Setiap objek berisi informasi berikut: `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori [modul AWS IoT Greengrass logging](https://github.com/aws-greengrass/aws-greengrass-logging-java). GitHub Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di `diskSpaceLimitUnit`. Setelah ukuran total file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini. Parameter ini terkait dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total maksimum untuk komponen ini. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `logFileDirectoryPath` (Opsional) Path ke folder yang berisi file log komponen ini. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Default: `/greengrass/v2/logs`. `logFileRegex` (Opsional) Ekspresi reguler yang menentukan format nama file log yang menggunakan komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di `logFileDirectoryPath`. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Jika komponen atau aplikasi Anda memutar file log, tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan **hello\$1world\$1\$1\$1\$1w\$1.log** untuk meng-upload log untuk aplikasi Hello World. Pola `\\\\w*` cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut: + `hello_world.log` – Berkas log terbaru untuk aplikasi Hello World. + `hello_world_2020_12_15_17_0.log` – Berkas log yang lebih lama untuk aplikasi Hello World. Default:`componentName\\\\w*.log`, di mana *componentName* nama komponen untuk konfigurasi log ini. `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `multiLineStartPattern` (Opsional) Ekspresi reguler yang mengidentifikasi kapan pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya. Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan. `periodicUploadIntervalSec` (Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah. Default: `300` (5 menit) Minimum: `0.000001` (1 mikrodetik) `updateToTlogIntervalSec` (Opsional) Periode dalam hitungan detik untuk seberapa sering nukleus menulis rincian peristiwa Amazon CloudWatch Events log-upload ke log transaksi lokal ()`config.tlog`. Default ke nilai yang ditentukan dalam. `periodicUploadIntervalSec` Anda dapat memodifikasi parameter ini untuk meningkatkan interval penulisan. Default: `periodicUploadIntervalSec` Minimal: `periodicUploadIntervalSec` `deprecatedVersionSupport` Menunjukkan apakah pengelola log harus menggunakan peningkatan kecepatan pencatatan yang diperkenalkan di pengelola log v2.3.5. Tetapkan nilai `false` untuk menggunakan perbaikan. Jika Anda menetapkan nilai ini `false` saat Anda memutakhirkan dari pengelola log v2.3.1 atau entri log duplikat sebelumnya dapat diunggah. Nilai default-nya `true`. **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log `com.example.HelloWorld` komponen ke CloudWatch Log. ``` { "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfigurationMap": { "com.example.HelloWorld": { "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "300", "deprecatedVersionSupport": "false" } ``` **Example Contoh: Konfigurasi untuk mengunggah beberapa file log aktif menggunakan pengelola log v2.3.1** Contoh konfigurasi berikut adalah contoh yang disarankan jika Anda ingin menargetkan beberapa file log aktif. Konfigurasi contoh ini menentukan file log aktif apa yang ingin Anda unggah. CloudWatch Menggunakan konfigurasi contoh konfigurasi ini juga akan mengunggah file yang diputar yang cocok dengan file. `logFileRegex` Contoh konfigurasi ini didukung pada pengelola log v2.3.1. ``` { "logsUploaderConfiguration": { "componentLogsConfigurationMap": { "com.example.A": { "logFileRegex": "com.example.A\\w*.log", "deleteLogFileAfterCloudUpload": "false" } "com.example.B": { "logFileRegex": "com.example.B\\w*.log", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "10" } ``` ------ #### [ v2.3.6 – v2.3.9 ] `logsUploaderConfiguration` (Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut: `systemLogsConfiguration` [(Opsional) Konfigurasi untuk log sistem perangkat lunak AWS IoT Greengrass Core, yang mencakup log dari inti [Greengrass](greengrass-nucleus-component.md) dan komponen plugin.](develop-greengrass-components.md#component-types) Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log mengelola log sistem. Objek ini berisi informasi berikut: `uploadToCloudWatch` (Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log. Default: `false` `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen [inti Greengrass](greengrass-nucleus-component.md) untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, `JSON` tentukan parameter [format logging](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`). Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukan. `diskSpaceLimitUnit` Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua. Parameter ini setara dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total maksimum. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `componentLogsConfigurationMap` (Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. Setiap `componentName` objek dalam peta ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log. Kami sangat menyarankan menggunakan satu kunci konfigurasi per komponen. Anda hanya boleh menargetkan sekelompok file yang hanya memiliki satu file log yang secara aktif ditulis saat menggunakan file`logFileRegex`. Tidak mengikuti rekomendasi ini dapat menyebabkan log duplikat diunggah. CloudWatch [Jika Anda menargetkan beberapa file log aktif dengan satu regex, kami sarankan Anda meningkatkan ke pengelola log v2.3.1 atau yang lebih baru dan pertimbangkan untuk mengubah konfigurasi Anda menggunakan konfigurasi contoh.](#log-manager-multiple-logs-v2.3.1) Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakan `componentLogsConfiguration` daftar alih-alih. `componentLogsConfigurationMap` Namun, kami sangat menyarankan Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk memodifikasi konfigurasi untuk komponen tertentu. Untuk informasi tentang `componentLogsConfiguration` parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini. *`componentName`* Konfigurasi log untuk *`componentName`* komponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini. Setiap objek berisi informasi berikut: `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori [modul AWS IoT Greengrass logging](https://github.com/aws-greengrass/aws-greengrass-logging-java). GitHub Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di `diskSpaceLimitUnit`. Setelah ukuran total file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini. Parameter ini terkait dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total maksimum untuk komponen ini. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `logFileDirectoryPath` (Opsional) Path ke folder yang berisi file log komponen ini. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Default: `/greengrass/v2/logs`. `logFileRegex` (Opsional) Ekspresi reguler yang menentukan format nama file log yang menggunakan komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di `logFileDirectoryPath`. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Jika komponen atau aplikasi Anda memutar file log, tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan **hello\$1world\$1\$1\$1\$1w\$1.log** untuk meng-upload log untuk aplikasi Hello World. Pola `\\\\w*` cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut: + `hello_world.log` – Berkas log terbaru untuk aplikasi Hello World. + `hello_world_2020_12_15_17_0.log` – Berkas log yang lebih lama untuk aplikasi Hello World. Default:`componentName\\\\w*.log`, di mana *componentName* nama komponen untuk konfigurasi log ini. `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `multiLineStartPattern` (Opsional) Ekspresi reguler yang mengidentifikasi kapan pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya. Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan. `periodicUploadIntervalSec` (Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah. Default: `300` (5 menit) Minimum: `0.000001` (1 mikrodetik) `deprecatedVersionSupport` Menunjukkan apakah pengelola log harus menggunakan peningkatan kecepatan pencatatan yang diperkenalkan di pengelola log v2.3.5. Tetapkan nilai `false` untuk menggunakan perbaikan. Jika Anda menetapkan nilai ini `false` saat Anda memutakhirkan dari pengelola log v2.3.1 atau entri log duplikat sebelumnya dapat diunggah. Nilai default-nya `true`. **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log `com.example.HelloWorld` komponen ke CloudWatch Log. ``` { "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfigurationMap": { "com.example.HelloWorld": { "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "300", "deprecatedVersionSupport": "false" } ``` **Example Contoh: Konfigurasi untuk mengunggah beberapa file log aktif menggunakan pengelola log v2.3.1** Contoh konfigurasi berikut adalah contoh yang disarankan jika Anda ingin menargetkan beberapa file log aktif. Konfigurasi contoh ini menentukan file log aktif apa yang ingin Anda unggah. CloudWatch Menggunakan konfigurasi contoh konfigurasi ini juga akan mengunggah file yang diputar yang cocok dengan file. `logFileRegex` Contoh konfigurasi ini didukung pada pengelola log v2.3.1. ``` { "logsUploaderConfiguration": { "componentLogsConfigurationMap": { "com.example.A": { "logFileRegex": "com.example.A\\w*.log", "deleteLogFileAfterCloudUpload": "false" } "com.example.B": { "logFileRegex": "com.example.B\\w*.log", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "10" } ``` ------ #### [ v2.3.0 – 2.3.5 ] `logsUploaderConfiguration` (Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut: `systemLogsConfiguration` [(Opsional) Konfigurasi untuk log sistem perangkat lunak AWS IoT Greengrass Core, yang mencakup log dari inti [Greengrass](greengrass-nucleus-component.md) dan komponen plugin.](develop-greengrass-components.md#component-types) Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log mengelola log sistem. Objek ini berisi informasi berikut: `uploadToCloudWatch` (Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log. Default: `false` `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen [inti Greengrass](greengrass-nucleus-component.md) untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, `JSON` tentukan parameter [format logging](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`). Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukan. `diskSpaceLimitUnit` Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua. Parameter ini setara dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total maksimum. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `componentLogsConfigurationMap` (Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. Setiap `componentName` objek dalam peta ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log. Kami sangat menyarankan menggunakan satu kunci konfigurasi per komponen. Anda hanya boleh menargetkan sekelompok file yang hanya memiliki satu file log yang secara aktif ditulis saat menggunakan file`logFileRegex`. Tidak mengikuti rekomendasi ini dapat menyebabkan log duplikat diunggah. CloudWatch [Jika Anda menargetkan beberapa file log aktif dengan satu regex, kami sarankan Anda meningkatkan ke pengelola log v2.3.1 dan pertimbangkan untuk mengubah konfigurasi Anda menggunakan konfigurasi contoh.](#log-manager-multiple-logs-v2.3.1) Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakan `componentLogsConfiguration` daftar alih-alih. `componentLogsConfigurationMap` Namun, kami sangat menyarankan Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk memodifikasi konfigurasi untuk komponen tertentu. Untuk informasi tentang `componentLogsConfiguration` parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini. *`componentName`* Konfigurasi log untuk *`componentName`* komponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini. Setiap objek berisi informasi berikut: `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori [modul AWS IoT Greengrass logging](https://github.com/aws-greengrass/aws-greengrass-logging-java). GitHub Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di `diskSpaceLimitUnit`. Setelah ukuran total file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini. Parameter ini terkait dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total maksimum untuk komponen ini. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `logFileDirectoryPath` (Opsional) Path ke folder yang berisi file log komponen ini. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Default: `/greengrass/v2/logs`. `logFileRegex` (Opsional) Ekspresi reguler yang menentukan format nama file log yang menggunakan komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di `logFileDirectoryPath`. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Jika komponen atau aplikasi Anda memutar file log, tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan **hello\$1world\$1\$1\$1\$1w\$1.log** untuk meng-upload log untuk aplikasi Hello World. Pola `\\\\w*` cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut: + `hello_world.log` – Berkas log terbaru untuk aplikasi Hello World. + `hello_world_2020_12_15_17_0.log` – Berkas log yang lebih lama untuk aplikasi Hello World. Default:`componentName\\\\w*.log`, di mana *componentName* nama komponen untuk konfigurasi log ini. `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `multiLineStartPattern` (Opsional) Ekspresi reguler yang mengidentifikasi kapan pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya. Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan. `periodicUploadIntervalSec` (Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah. Default: `300` (5 menit) Minimum: `0.000001` (1 mikrodetik) **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log `com.example.HelloWorld` komponen ke CloudWatch Log. ``` { "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfigurationMap": { "com.example.HelloWorld": { "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "300" } ``` **Example Contoh: Konfigurasi untuk mengunggah beberapa file log aktif menggunakan pengelola log v2.3.1** Contoh konfigurasi berikut adalah contoh yang disarankan jika Anda ingin menargetkan beberapa file log aktif. Konfigurasi contoh ini menentukan file log aktif apa yang ingin Anda unggah. CloudWatch Menggunakan konfigurasi contoh konfigurasi ini juga akan mengunggah file yang diputar yang cocok dengan file. `logFileRegex` Contoh konfigurasi ini didukung pada pengelola log v2.3.1. ``` { "logsUploaderConfiguration": { "componentLogsConfigurationMap": { "com.example.A": { "logFileRegex": "com.example.A\\w*.log", "deleteLogFileAfterCloudUpload": "false" } "com.example.B": { "logFileRegex": "com.example.B\\w*.log", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "10" } ``` ------ #### [ v2.2.x ] `logsUploaderConfiguration` (Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut: `systemLogsConfiguration` [(Opsional) Konfigurasi untuk log sistem perangkat lunak AWS IoT Greengrass Core, yang mencakup log dari inti [Greengrass](greengrass-nucleus-component.md) dan komponen plugin.](develop-greengrass-components.md#component-types) Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log mengelola log sistem. Objek ini berisi informasi berikut: `uploadToCloudWatch` (Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log. Default: `false` `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen [inti Greengrass](greengrass-nucleus-component.md) untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, `JSON` tentukan parameter [format logging](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`). Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukan. `diskSpaceLimitUnit` Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua. Parameter ini setara dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total maksimum. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `componentLogsConfigurationMap` (Opsional) Peta konfigurasi log untuk komponen pada perangkat inti. Setiap `componentName` objek dalam peta ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log. Jika Anda memutakhirkan dari versi pengelola log lebih awal dari v2.2.0, Anda dapat terus menggunakan `componentLogsConfiguration` daftar alih-alih. `componentLogsConfigurationMap` Namun, kami sangat menyarankan Anda menggunakan format peta sehingga Anda dapat menggunakan menggabungkan dan mengatur ulang pembaruan untuk memodifikasi konfigurasi untuk komponen tertentu. Untuk informasi tentang `componentLogsConfiguration` parameter, lihat parameter konfigurasi untuk v2.1.x komponen ini. *`componentName`* Konfigurasi log untuk *`componentName`* komponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini. Setiap objek berisi informasi berikut: `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori [modul AWS IoT Greengrass logging](https://github.com/aws-greengrass/aws-greengrass-logging-java). GitHub Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di `diskSpaceLimitUnit`. Setelah ukuran total file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini. Parameter ini terkait dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total maksimum untuk komponen ini. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `logFileDirectoryPath` (Opsional) Path ke folder yang berisi file log komponen ini. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Default: `/greengrass/v2/logs`. `logFileRegex` (Opsional) Ekspresi reguler yang menentukan format nama file log yang menggunakan komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di `logFileDirectoryPath`. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Jika komponen atau aplikasi Anda memutar file log, tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan **hello\$1world\$1\$1\$1\$1w\$1.log** untuk meng-upload log untuk aplikasi Hello World. Pola `\\\\w*` cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut: + `hello_world.log` – Berkas log terbaru untuk aplikasi Hello World. + `hello_world_2020_12_15_17_0.log` – Berkas log yang lebih lama untuk aplikasi Hello World. Default:`componentName\\\\w*.log`, di mana *componentName* nama komponen untuk konfigurasi log ini. `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `multiLineStartPattern` (Opsional) Ekspresi reguler yang mengidentifikasi kapan pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya. Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan. `periodicUploadIntervalSec` (Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah. Default: `300` (5 menit) Minimum: `0.000001` (1 mikrodetik) **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log `com.example.HelloWorld` komponen ke CloudWatch Log. ``` { "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfigurationMap": { "com.example.HelloWorld": { "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } } }, "periodicUploadIntervalSec": "300" } ``` ------ #### [ v2.1.x ] `logsUploaderConfiguration` (Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut: `systemLogsConfiguration` [(Opsional) Konfigurasi untuk log sistem perangkat lunak AWS IoT Greengrass Core, yang mencakup log dari inti [Greengrass](greengrass-nucleus-component.md) dan komponen plugin.](develop-greengrass-components.md#component-types) Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log mengelola log sistem. Objek ini berisi informasi berikut: `uploadToCloudWatch` (Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log. Default: `false` `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen [inti Greengrass](greengrass-nucleus-component.md) untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, `JSON` tentukan parameter [format logging](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`). Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukan. `diskSpaceLimitUnit` Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua. Parameter ini setara dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total maksimum. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `componentLogsConfiguration` (Opsional) Daftar konfigurasi log untuk komponen pada perangkat inti. Setiap konfigurasi dalam daftar ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log Setiap objek berisi informasi berikut: `componentName` Nama komponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini. `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori [modul AWS IoT Greengrass logging](https://github.com/aws-greengrass/aws-greengrass-logging-java). GitHub Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di `diskSpaceLimitUnit`. Setelah ukuran total file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini. Parameter ini terkait dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total maksimum untuk komponen ini. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `logFileDirectoryPath` (Opsional) Path ke folder yang berisi file log komponen ini. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Default: `/greengrass/v2/logs`. `logFileRegex` (Opsional) Ekspresi reguler yang menentukan format nama file log yang menggunakan komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di `logFileDirectoryPath`. Anda tidak perlu menentukan parameter ini untuk komponen Greengrass yang mencetak pada output standar (stdout) dan kesalahan standar (stderr). Jika komponen atau aplikasi Anda memutar file log, tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan **hello\$1world\$1\$1\$1\$1w\$1.log** untuk meng-upload log untuk aplikasi Hello World. Pola `\\\\w*` cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut: + `hello_world.log` – Berkas log terbaru untuk aplikasi Hello World. + `hello_world_2020_12_15_17_0.log` – Berkas log yang lebih lama untuk aplikasi Hello World. Default:`componentName\\\\w*.log`, di mana *componentName* nama komponen untuk konfigurasi log ini. `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `multiLineStartPattern` (Opsional) Ekspresi reguler yang mengidentifikasi kapan pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya. Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan. `periodicUploadIntervalSec` (Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah. Default: `300` (5 menit) Minimum: `0.000001` (1 mikrodetik) **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log `com.example.HelloWorld` komponen ke CloudWatch Log. ``` { "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfiguration": [ { "componentName": "com.example.HelloWorld", "minimumLogLevel": "INFO", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } ] }, "periodicUploadIntervalSec": "300" } ``` ------ #### [ v2.0.x ] `logsUploaderConfiguration` (Opsional) Konfigurasi untuk log yang di-upload oleh komponen manajer log. Objek ini berisi informasi berikut: `systemLogsConfiguration` (Opsional) Konfigurasi untuk log sistem perangkat lunak AWS IoT Greengrass Core. Tentukan konfigurasi ini untuk mengaktifkan komponen pengelola log mengelola log sistem. Objek ini berisi informasi berikut: `uploadToCloudWatch` (Opsional) Anda dapat mengunggah log sistem ke CloudWatch Log. Default: `false` `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika Anda mengonfigurasi komponen [inti Greengrass](greengrass-nucleus-component.md) untuk mengeluarkan log format JSON. Untuk mengaktifkan log format JSON, `JSON` tentukan parameter [format logging](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`). Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum file log sistem Greengrass, di unit yang Anda tentukan. `diskSpaceLimitUnit` Setelah ukuran total file log sistem Greengrass melebihi ukuran total maksimum ini, AWS IoT Greengrass perangkat lunak Core menghapus file log sistem Greengrass tertua. Parameter ini setara dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log sistem Greengrass total maksimum. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `componentLogsConfiguration` (Opsional) Daftar konfigurasi log untuk komponen pada perangkat inti. Setiap konfigurasi dalam daftar ini mendefinisikan konfigurasi log untuk komponen atau aplikasi. Komponen pengelola log mengunggah log komponen ini ke CloudWatch Log Setiap objek berisi informasi berikut: `componentName` Nama komponen atau aplikasi untuk konfigurasi log ini. Anda dapat menentukan nama komponen Greengrass atau nilai lain untuk mengidentifikasi grup log ini. `minimumLogLevel` (Opsional) Tingkat minimum pesan log untuk diunggah. Level minimum ini hanya berlaku jika log komponen ini menggunakan format JSON tertentu, yang dapat Anda temukan di repositori [modul AWS IoT Greengrass logging](https://github.com/aws-greengrass/aws-greengrass-logging-java). GitHub Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `diskSpaceLimit` (Opsional) Ukuran total maksimum semua file log sistem untuk komponen ini, di unit yang Anda tentukan di `diskSpaceLimitUnit`. Setelah ukuran total file log komponen ini melebihi ukuran total maksimum ini, perangkat lunak AWS IoT Greengrass Core menghapus file log tertua komponen ini. Parameter ini terkait dengan parameter [batas ukuran log](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) dari komponen inti [Greengrass](greengrass-nucleus-component.md). Perangkat lunak AWS IoT Greengrass Core menggunakan minimum dua nilai sebagai ukuran log total maksimum untuk komponen ini. `diskSpaceLimitUnit` (Opsional) Unit untuk `diskSpaceLimit`. Pilih dari salah satu pilihan berikut: + `KB` – kilobyte + `MB` – megabyte + `GB` – gigabyte Default: `KB` `logFileDirectoryPath` Path ke folder yang berisi file log komponen ini. Untuk mengunggah log komponen Greengrass, **`/greengrass/v2`/logs** tentukan, dan ganti `/greengrass/v2` dengan folder root Greengrass Anda. `logFileRegex` Ekspresi reguler yang menentukan format nama file log yang digunakan oleh komponen atau aplikasi. Komponen manajer log menggunakan ekspresi reguler ini untuk mengidentifikasi file log dalam folder di `logFileDirectoryPath`. Untuk meng-upload log komponen Greengrass tentukan regex yang cocok dengan nama file log yang diputar. Misalnya, Anda dapat menentukan **com.example.HelloWorld\$1\$1w\$1.log** untuk meng-upload log untuk aplikasi Hello World. Pola `\\w*` cocok dengan nol atau lebih karakter kata, yang meliputi karakter alfanumerik dan garis bawah. Regex ini cocok dengan file log dengan dan tanpa cap waktu dalam namanya. Dalam contoh ini, manajer log meng-upload file log berikut: + `com.example.HelloWorld.log` – Berkas log terbaru untuk komponen Hello World. + `com.example.HelloWorld_2020_12_15_17_0.log` – Berkas log yang lebih lama untuk komponen Hello World. Inti Greengrass menambahkan stempel waktu putar pada file log. `deleteLogFileAfterCloudUpload` (Opsional) Anda dapat menghapus file log setelah komponen pengelola log mengunggah CloudWatch log ke Log. Default: `false` `multiLineStartPattern` (Opsional) Ekspresi reguler yang mengidentifikasi kapan pesan log pada baris baru adalah pesan log baru. Jika ekspresi reguler tidak cocok dengan baris baru, komponen pengelola log menambahkan baris baru ke pesan log untuk baris sebelumnya. Secara default, komponen pengelola log memeriksa apakah baris dimulai dengan karakter spasi putih, seperti tab atau spasi. Jika tidak, pengelola log menangani baris itu sebagai pesan log baru. Jika tidak, itu menambahkan baris itu ke pesan log saat ini. Perilaku ini memastikan bahwa komponen pengelola log tidak membagi pesan yang menjangkau beberapa baris, seperti jejak tumpukan. `periodicUploadIntervalSec` (Opsional) Periode dalam detik di mana komponen manajer log memeriksa file log baru yang akan diunggah. Default: `300` (5 menit) Minimum: `0.000001` (1 mikrodetik) **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk meng-upload log sistem dan log `com.example.HelloWorld` komponen ke CloudWatch Log. ``` { "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true", "minimumLogLevel": "INFO", "diskSpaceLimit": "10", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" }, "componentLogsConfiguration": [ { "componentName": "com.example.HelloWorld", "minimumLogLevel": "INFO", "logFileDirectoryPath": "/greengrass/v2/logs", "logFileRegex": "com.example.HelloWorld\\w*.log", "diskSpaceLimit": "20", "diskSpaceLimitUnit": "MB", "deleteLogFileAfterCloudUpload": "false" } ] }, "periodicUploadIntervalSec": "300" } ``` ------ ## Penggunaan Komponen manajer log meng-upload ke grup log dan pengaliran log berikut. ------ #### [ 2.1.0 and later ] **Nama grup log** ``` /aws/greengrass/componentType/region/componentName ``` Nama grup log menggunakan variabel berikut: + `componentType` — Jenis komponen, yang dapat berupa salah satu dari berikut ini: + `GreengrassSystemComponent`— Grup log ini mencakup log untuk komponen inti dan plugin, yang berjalan di JVM yang sama dengan inti Greengrass. Komponen ini merupakan bagian dari inti [Greengrass](greengrass-nucleus-component.md). + `UserComponent`— Grup log ini mencakup log untuk komponen generik, komponen Lambda, dan aplikasi lain di perangkat. Komponen ini bukan bagian dari inti Greengrass. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). + `region`— AWS Wilayah yang digunakan perangkat inti. + `componentName` — Nama komponen. Untuk log sistem, nilai ini adalah `System`. **Nama aliran log** ``` /date/thing/thingName ``` Nama aliran log menggunakan variabel berikut: + `date` — Tanggal log, seperti `2020/12/15`. Komponen manajer log menggunakan format `yyyy/MM/dd`. + `thingName` - Nama perangkat inti. Jika nama objek berisi titik dua (`:`), manajer log akan menggantikan titik dua dengan tanda tambah (`+`). ------ #### [ 2.0.x ] **Nama grup log** ``` /aws/greengrass/componentType/region/componentName ``` Nama grup log menggunakan variabel berikut: + `componentType` — Jenis komponen, yang dapat berupa salah satu dari berikut ini: + `GreengrassSystemComponent` — Komponen adalah bagian dari [nukleus Greengrass](greengrass-nucleus-component.md). + `UserComponent` — Komponen adalah bagian dari nukleus Greengrass. Manajer log menggunakan jenis ini untuk komponen Greengrass dan aplikasi lainnya pada perangkat. + `region`— AWS Wilayah yang digunakan perangkat inti. + `componentName` — Nama komponen. Untuk log sistem, nilai ini adalah `System`. **Nama aliran log** ``` /date/deploymentTargets/thingName ``` Nama aliran log menggunakan variabel berikut: + `date` — Tanggal log, seperti `2020/12/15`. Komponen manajer log menggunakan format `yyyy/MM/dd`. + `deploymentTargets` — Objek-objek yang deployment-nya meliputi komponen. Komponen manajer log memisahkan setiap target dengan garis miring. Jika komponen berjalan pada perangkat inti sebagai hasil dari deployment lokal, nilai ini adalah `LOCAL_DEPLOYMENT`. Pertimbangkan contoh di mana Anda memiliki perangkat inti bernama `MyGreengrassCore`, dan perangkat inti tersebut memiliki dua deployment: + Deployment yang menargetkan perangkat inti, `MyGreengrassCore`. + Deployment yang menargetkan grup objek bernama `MyGreengrassCoreGroup`, yang berisi perangkat inti. `deploymentTargets` untuk perangkat inti ini adalah `thing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup`. + `thingName` - Nama perangkat inti. ------ ### Format untuk entri log. Inti Greengrass menulis file log dalam format string atau JSON. Untuk log sistem, Anda mengontrol format dengan mengatur `format` bidang `logging` entri. Anda dapat menemukan `logging` entri di file konfigurasi komponen inti Greengrass. Untuk informasi selengkapnya, lihat [konfigurasi nukleus Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration). Format teks adalah bentuk bebas dan menerima string apa pun. Pesan layanan status armada berikut adalah contoh logging berformat string: ``` 2023-03-26T18:18:27.271Z [INFO] (pool-1-thread-2) com.aws.greengrass.status.FleetStatusService: fss-status-update-published. Status update published to FSS. {trigger=CADENCE, serviceName=FleetStatusService, currentState=RUNNING} ``` Anda harus menggunakan format JSON jika Anda ingin melihat log dengan perintah log [CLI Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/gg-cli-logs.html) atau berinteraksi dengan log secara terprogram. Contoh berikut menguraikan bentuk JSON: ``` { "loggerName": , "level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">, "eventType": , "cause": , "contexts": {}, "thread": , "message": , "timestamp": # Needs to be epoch time } ``` Untuk mengontrol output log komponen Anda, Anda dapat menggunakan opsi `minimumLogLevel` konfigurasi. Untuk menggunakan opsi ini, komponen Anda harus menulis entri lognya dalam format JSON. Anda harus menggunakan format yang sama dengan file log sistem. ## Berkas log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.3.12 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.3.11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.3.10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.3.9 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.3.8 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.3.7 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.3.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.3.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.3.3 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.3.0 | Kami menyarankan Anda meningkatkan ke Greengrass nucleus 2.9.1 saat Anda meningkatkan ke pengelola log 2.3.0. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.2.8 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.2.7 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.2.6 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.2.5 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.2.1 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/log-manager-component.html) | | 2.0.x | Versi awal. | # Komponen machine learning AWS IoT Greengrass menyediakan komponen pembelajaran mesin berikut yang dapat Anda terapkan ke perangkat yang didukung untuk [melakukan inferensi pembelajaran mesin](perform-machine-learning-inference.md) menggunakan model yang dilatih di Amazon SageMaker AI atau dengan model pra-terlatih Anda sendiri yang disimpan di Amazon S3. AWS menyediakan kategori komponen pembelajaran mesin berikut: + **Komponen model**—Berisi model machine learning sebagai artefak Greengrass. + **Komponen waktu aktif**—Berisi skrip yang menginstal kerangka kerja machine learning dan dependensinya pada perangkat inti Greengrass. + **Komponen Inferensi**—Berisi kode inferensi dan mencakup dependensi komponen untuk menginstal kerangka machine learning dan mengunduh model machine learning yang telah dilatih sebelumnya. Anda dapat menggunakan kode inferensi sampel dan model yang telah dilatih sebelumnya dalam komponen pembelajaran mesin AWS yang disediakan untuk melakukan klasifikasi gambar dan deteksi objek menggunakan DLR dan Lite. TensorFlow Untuk melakukan inferensi pembelajaran mesin khusus dengan model Anda sendiri yang disimpan di Amazon S3, atau menggunakan kerangka kerja pembelajaran mesin yang berbeda, Anda dapat menggunakan resep komponen publik ini sebagai templat untuk membuat komponen pembelajaran mesin khusus. Untuk informasi selengkapnya, lihat [Sesuaikan komponen machine learning Anda](ml-customization.md). AWS IoT Greengrass juga mencakup komponen AWS yang disediakan untuk mengelola instalasi dan siklus hidup agen SageMaker AI Edge Manager pada perangkat inti Greengrass. Dengan SageMaker AI Edge Manager, Anda dapat menggunakan model Amazon SageMaker AI Neo yang dikompilasi langsung di perangkat inti Anda. Untuk informasi selengkapnya, lihat [Gunakan Amazon SageMaker AI Edge Manager di perangkat inti Greengrass](use-sagemaker-edge-manager.md). Tabel berikut mencantumkan komponen pembelajaran mesin yang tersedia di AWS IoT Greengrass. **catatan** Beberapa komponen AWS yang disediakan bergantung pada versi minor spesifik dari inti Greengrass. Karena ketergantungan ini, Anda perlu memperbarui komponen ini saat memperbarui inti Greengrass ke versi minor baru. Untuk informasi tentang versi spesifik dari inti yang masing-masing komponen bergantung padanya, lihat topik komponen yang sesuai. Untuk informasi selengkapnya terkait cara memperbarui inti, lihat [Perbarui perangkat lunak AWS IoT Greengrass Core (OTA)](update-greengrass-core-v2.md). Ketika komponen memiliki tipe komponen generik dan Lambda, versi komponen saat ini adalah tipe generik dan versi komponen sebelumnya adalah tipe Lambda. | Komponen | Deskripsi | [Jenis komponen](develop-greengrass-components.md#component-types) | Sistem operasi yang didukung | [Sumber terbuka](open-source.md) | | --- | --- | --- | --- | --- | | [SageMaker Manajer AI Edge](sagemaker-edge-manager-component.md) | Menyebarkan agen Amazon SageMaker AI Edge Manager di perangkat inti Greengrass. | Generik | Linux, Windows | Tidak | | [Klasifikasi citra DLR](dlr-image-classification-component.md) | Komponen inferensi yang menggunakan penyimpanan model klasifikasi gambar DLR dan komponen waktu aktif DLR sebagai dependensi akan menginstal DLR, men-download model klasifikasi gambar sampel, dan melakukan inferensi klasifikasi gambar pada perangkat yang didukung. | Generik | Linux, Windows | Tidak | | [Deteksi objek DLR](dlr-object-detection-component.md) | Komponen inferensi yang menggunakan penyimpanan model deteksi gambar DLR dan komponen waktu aktif DLR sebagai dependensi akan menginstal DLR, men-download sampel model deteksi, dan melakukan inferensi deteksi gambar pada perangkat yang didukung. | Generik | Linux, Windows | Tidak | | [Penyimpanan model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | Komponen model yang berisi sampel ResNet -50 model klasifikasi gambar sebagai artefak Greengrass. | Generik | Linux, Windows | Tidak | | [Penyimpanan model deteksi DLR](dlr-object-detection-model-store-component.md) | Komponen model yang berisi model deteksi YOLOv3 objek sampel sebagai artefak Greengrass. | Generik | Linux, Windows | Tidak | | [Runtime DLR](dlr-component.md) | Komponen waktu aktif yang berisi skrip instalasi yang digunakan untuk menginstal DLR dan dependensinya pada perangkat inti Greengrass. | Generik | Linux, Windows | Tidak | | [TensorFlow Klasifikasi gambar ringan](tensorflow-lite-image-classification-component.md) | Komponen inferensi yang menggunakan penyimpanan model klasifikasi gambar TensorFlow Lite dan komponen runtime TensorFlow Lite sebagai dependensi untuk menginstal TensorFlow Lite, mengunduh model klasifikasi gambar sampel, dan melakukan inferensi klasifikasi gambar pada perangkat yang didukung. | Generik | Linux, Windows | Tidak | | [TensorFlow Deteksi objek Lite](tensorflow-lite-object-detection-component.md) | Komponen inferensi yang menggunakan penyimpanan model deteksi objek TensorFlow Lite dan komponen runtime TensorFlow Lite sebagai dependensi untuk menginstal TensorFlow Lite, mengunduh model deteksi objek sampel, dan melakukan inferensi deteksi objek pada perangkat yang didukung. | Generik | Linux, Windows | Tidak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | Komponen model yang berisi contoh model MobileNet v1 sebagai artefak Greengrass. | Generik | Linux, Windows | Tidak | | [TensorFlow Toko model deteksi objek Lite](tensorflow-lite-object-detection-model-store-component.md) | Komponen model yang berisi contoh model Single Shot Detection (SSD) sebagai MobileNet artefak Greengrass. | Generik | Linux, Windows | Tidak | | [TensorFlow Runtime ringan](tensorflow-lite-component.md) | Komponen runtime yang berisi skrip instalasi yang digunakan untuk menginstal TensorFlow Lite dan dependensinya pada perangkat inti Greengrass. | Generik | Linux, Windows | Tidak | # SageMaker Manajer AI Edge **penting** SageMaker AI Edge Manager dihentikan pada 26 April 2024. Untuk informasi selengkapnya tentang melanjutkan penerapan model Anda ke perangkat edge, lihat [SageMaker AI Edge Manager end of life](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-eol.html). Komponen Amazon SageMaker AI Edge Manager (`aws.greengrass.SageMakerEdgeManager`) menginstal biner agen SageMaker AI Edge Manager. SageMaker AI Edge Manager menyediakan manajemen model untuk perangkat edge sehingga Anda dapat mengoptimalkan, mengamankan, memantau, dan memelihara model pembelajaran mesin pada armada perangkat edge. Komponen SageMaker AI Edge Manager menginstal dan mengelola siklus hidup agen SageMaker AI Edge Manager di perangkat inti Anda. Anda juga dapat menggunakan SageMaker AI Edge Manager untuk mengemas dan menggunakan model yang dikompilasi SageMaker AI Neo sebagai komponen model pada perangkat inti Greengrass. Untuk informasi selengkapnya tentang penggunaan agen SageMaker AI Edge Manager di perangkat inti Anda, lihat[Gunakan Amazon SageMaker AI Edge Manager di perangkat inti Greengrass](use-sagemaker-edge-manager.md). SageMaker Komponen AI Edge Manager v1.3.x menginstal biner agen Edge Manager v1.20220822.836f3023. Untuk informasi lebih lanjut tentang agen Edge Manager versi biner, lihat [Agen Manajer Edge](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-device-fleet-about). **catatan** Komponen SageMaker AI Edge Manager hanya tersedia dalam hal berikut Wilayah AWS: AS Timur (Ohio) AS Timur (Virginia Utara) US West (Oregon) EU (Frankfurt) EU (Ireland) Asia Pasifik (Tokyo) **Topics** + [Versi](#sagemaker-edge-manager-component-versions) + [Tipe](#sagemaker-edge-manager-component-type) + [Sistem operasi](#sagemaker-edge-manager-component-os-support) + [Persyaratan](#sagemaker-edge-manager-component-requirements) + [Dependensi](#sagemaker-edge-manager-component-dependencies) + [Konfigurasi](#sagemaker-edge-manager-component-configuration) + [File log lokal](#sagemaker-edge-manager-component-log-file) + [Changelog](#sagemaker-edge-manager-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 1.3.x + 1.2.x + 1.1.x + 1.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## 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 yang berjalan di Amazon Linux 2, platform Linux berbasis Debian (x86\$164 atau Armv8), atau Windows (x86\$164). Jika Anda tidak memilikinya, lihat [Tutorial: Memulai dengan AWS IoT Greengrass V2](getting-started.md). + [Python](https://www.python.org/downloads/) 3.6 atau yang lebih baru, termasuk `pip` untuk versi Python Anda, diinstal pada perangkat inti anda. + [Peran perangkat Greengrass](device-service-role.md) yang dikonfigurasi dengan berikut ini: + Hubungan kepercayaan yang memungkinkan `credentials.iot.amazonaws.com` dan `sagemaker.amazonaws.com` untuk meneruskan peran, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "credentials.iot.amazonaws.com" }, "Action": "sts:AssumeRole" }, { "Effect": "Allow", "Principal": { "Service": "sagemaker.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` + Kebijakan yang dikelola [AmazonSageMakerEdgeDeviceFleetPolicy](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AmazonSageMakerEdgeDeviceFleetPolicy)IAM. + Tindakan `s3:PutObject`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "s3:PutObject" ], "Resource": [ "*" ], "Effect": "Allow" } ] } ``` + Bucket Amazon S3 yang dibuat sama Akun AWS dan Wilayah AWS sebagai perangkat inti Greengrass Anda. SageMaker AI Edge Manager memerlukan bucket S3 untuk membuat armada perangkat edge, dan menyimpan data sampel dari inferensi yang berjalan di perangkat Anda. Untuk informasi selengkapnya tentang pembuatan bucket S3, lihat [Memulai Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html). + Armada perangkat SageMaker AI edge yang menggunakan alias AWS IoT peran yang sama dengan perangkat inti Greengrass Anda. Untuk informasi selengkapnya, lihat [Buat armada perangkat edge](get-started-with-edge-manager-on-greengrass.md#create-edge-device-fleet-for-greengrass). + Perangkat inti Greengrass Anda terdaftar sebagai perangkat edge di armada perangkat AI Edge Anda. SageMaker Nama perangkat tepi harus cocok dengan nama AWS IoT benda untuk perangkat inti Anda. Untuk informasi selengkapnya, lihat [Daftarkan perangkat inti Greengrass Anda](get-started-with-edge-manager-on-greengrass.md#register-greengrass-core-device-in-sme). ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `edge.sagemaker.region.amazonaws.com` | 443 | Ya | Periksa status pendaftaran perangkat dan kirim metrik ke SageMaker AI. | | `*.s3.amazonaws.com` | 443 | Ya | Unggah data tangkapan ke bucket S3 yang Anda tentukan. Anda dapat mengganti `*` dengan nama setiap bucket tempat Anda mengunggah data. | ## 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](#sagemaker-edge-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 1.3.5 and 1.3.6 ] Tabel berikut mencantumkan dependensi untuk versi 1.3.5 dan 1.3.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.3.4 ] Tabel berikut mencantumkan dependensi untuk versi 1.3.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.3.3 ] Tabel berikut mencantumkan dependensi untuk versi 1.3.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.3.2 ] Tabel berikut mencantumkan dependensi untuk versi 1.3.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.3.1 ] Tabel berikut mencantumkan dependensi untuk versi 1.3.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.1.1 - 1.3.0 ] Tabel berikut mencantumkan dependensi untuk versi 1.1.1 - 1.3.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 1.1.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.0.1 and 1.0.2 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.1 dan 1.0.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 1.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. **catatan** Bagian ini menjelaskan parameter konfigurasi yang Anda tetapkan dalam komponen. Untuk informasi selengkapnya tentang konfigurasi SageMaker AI Edge Manager yang sesuai, lihat [Agen Manajer Edge](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-device-fleet-about.html#edge-device-fleet-running-agent) di *Panduan Pengembang Amazon SageMaker AI*. `DeviceFleetName` Nama armada perangkat SageMaker AI Edge Manager yang berisi perangkat inti Greengrass Anda. Anda harus menentukan nilai untuk parameter ini dalam pembaruan konfigurasi ketika Anda men-deploy komponen ini. `BucketName` Nama bucket S3 yang padanya Anda unggah data inferensi yang ditangkap. Nama bucket harus berisi string `sagemaker`. Jika Anda mengatur `CaptureDataDestination` ke `Cloud`, atau jika Anda mengatur `CaptureDataPeriodicUpload` ke `true`, Anda harus menentukan nilai untuk parameter ini di pembaruan konfigurasi saat Anda men-deploy komponen ini. Capture data adalah fitur SageMaker AI yang Anda gunakan untuk mengunggah input inferensi, hasil inferensi, dan data inferensi tambahan ke bucket S3 atau direktori lokal untuk analisis masa depan. Untuk informasi selengkapnya tentang penggunaan data pengambilan dengan SageMaker AI Edge Manager, lihat [Mengelola Model](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-manage-model.html#edge-manage-model-capturedata) di *Panduan Pengembang Amazon SageMaker AI*. `CaptureDataBatchSize` (Opsional) Ukuran batch permintaan data tangkapan yang ditangani agen. Nilai ini harus lebih kecil dari ukuran buffer yang Anda tentukan di `CaptureDataBufferSize`. Kami merekomendasikan agar Anda tidak melebihi setengah ukuran buffer. Agen menangani batch permintaan ketika jumlah permintaan dalam buffer memenuhi jumlah `CaptureDataBatchSize`, atau ketika interval `CaptureDataPushPeriodSeconds` berlalu, mana yang terjadi lebih dahulu. Default: `10` `CaptureDataBufferSize` (Opsional) Jumlah maksimum permintaan data tangkapan yang disimpan dalam buffer. Default: `30` `CaptureDataDestination` (Opsional) Tujuan di mana Anda menyimpan data yang diambil. Parameter ini dapat memiliki nilai berikut: + `Cloud`—Mengunggah data yang ditangkap ke bucket S3 yang Anda tentukan di `BucketName`. + `Disk`—Menuliskan data yang ditangkap pada direktori kerja komponen. Jika Anda menentukan `Disk`, Anda juga dapat memilih untuk mengunggah data yang diambil secara berkala ke bucket S3 dengan menetapkan `CaptureDataPeriodicUpload` ke `true`. Default: `Cloud` `CaptureDataPeriodicUpload` (Opsional) Nilai string yang menentukan apakah akan secara berkala meng-upload data yang ditangkap. Nilai yang didukung adalah `true` dan `false`. Atur parameter ini ke `true` jika Anda mengatur `CaptureDataDestination` ke `Disk`, dan Anda juga ingin agen untuk secara berkala meng-upload data yang diambil bucket S3 Anda. Default: `false` `CaptureDataPeriodicUploadPeriodSeconds` (Opsional) Interval dalam hitungan detik saat agen SageMaker AI Edge Manager mengunggah data yang diambil ke bucket S3. Gunakan parameter ini jika Anda mengatur `CaptureDataPeriodicUpload` ke `true`. Default: `8` `CaptureDataPushPeriodSeconds` (Opsional) Interval dalam hitungan detik di mana agen SageMaker AI Edge Manager menangani sekumpulan permintaan data pengambilan dari buffer. Agen menangani batch permintaan ketika jumlah permintaan dalam buffer memenuhi jumlah `CaptureDataBatchSize`, atau ketika interval `CaptureDataPushPeriodSeconds` berlalu, mana yang terjadi lebih dahulu. Default: `4` `CaptureDataBase64EmbedLimit` (Opsional) Ukuran maksimum dalam byte data yang diambil yang diunggah agen SageMaker AI Edge Manager. Default: `3072` `FolderPrefix` (Opsional) Nama folder tempat agen menulis data yang ditangkap. Jika Anda mengatur `CaptureDataDestination` ke`Disk`, agen membuat folder di direktori yang ditentukan oleh`CaptureDataDiskPath`. Jika Anda mengatur `CaptureDataDestination` ke `Cloud`, atau jika Anda mengatur `CaptureDataPeriodicUpload` ke `true`, agen akan membuat folder di bucket S3 Anda. Default: `sme-capture` `CaptureDataDiskPath` Fitur ini tersedia di v1.1.0 dan versi yang lebih baru dari komponen SageMaker AI Edge Manager. (Opsional) Jalur ke folder tempat agen membuat folder data yang diambil. Jika Anda menyetel `CaptureDataDestination` ke`Disk`, agen akan membuat folder data yang diambil di direktori ini. Jika Anda tidak menentukan nilai ini, agen akan membuat folder data yang diambil di direktori kerja komponen. Gunakan `FolderPrefix` parameter untuk menentukan nama folder data yang diambil. Default: `/greengrass/v2/work/aws.greengrass.SageMakerEdgeManager/capture` `LocalDataRootPath` Fitur ini tersedia di v1.2.0 dan versi yang lebih baru dari komponen SageMaker AI Edge Manager. (Opsional) Jalur tempat komponen ini menyimpan data berikut pada perangkat inti: + Database lokal untuk data runtime saat Anda menyetel `DbEnable` ke`true`. + SageMaker Model yang dikompilasi AI Neo yang diunduh komponen ini secara otomatis saat Anda `DeploymentEnable` menyetelnya. `true` Default: `/greengrass/v2/work/aws.greengrass.SageMakerEdgeManager` `DbEnable` (Opsional) Anda dapat mengaktifkan komponen ini untuk menyimpan data runtime dalam database lokal untuk menyimpan data, jika komponen gagal atau perangkat kehilangan daya. Database ini membutuhkan 5 MB penyimpanan pada sistem file perangkat inti. Default: `false` `DeploymentEnable` Fitur ini tersedia di v1.2.0 dan versi yang lebih baru dari komponen SageMaker AI Edge Manager. (Opsional) Anda dapat mengaktifkan komponen ini untuk secara otomatis mengambil model yang dikompilasi SageMaker AI Neo dari yang Anda unggah ke Amazon S3. Setelah Anda mengunggah model baru ke Amazon S3, gunakan SageMaker AI Studio atau SageMaker AI API untuk menerapkan model baru ke perangkat inti ini. Saat mengaktifkan fitur ini, Anda dapat menerapkan model baru ke perangkat inti tanpa perlu membuat AWS IoT Greengrass penerapan. Untuk menggunakan fitur ini, Anda harus mengatur `DbEnable` ke`true`. Fitur ini menggunakan database lokal untuk melacak model yang diambil dari file. AWS Cloud Default: `false` `DeploymentPollInterval` Fitur ini tersedia di v1.2.0 dan versi yang lebih baru dari komponen SageMaker AI Edge Manager. (Opsional) Jumlah waktu (dalam menit) di mana komponen ini memeriksa model baru untuk diunduh. Opsi ini berlaku saat Anda menyetel `DeploymentEnable` ke`true`. Default: `1440` (1 hari) `DLRBackendOptions` Fitur ini tersedia di v1.2.0 dan versi yang lebih baru dari komponen SageMaker AI Edge Manager. (Opsional) Bendera runtime DLR untuk disetel di runtime DLR yang digunakan komponen ini. Anda dapat mengatur bendera berikut: + `TVM_TENSORRT_CACHE_DIR`- Aktifkan caching model TensorRT. Tentukan jalur absolut ke folder yang ada yang memiliki izin baca/tulis. + `TVM_TENSORRT_CACHE_DISK_SIZE_MB`— Menetapkan batas atas folder cache model TensorRT. Ketika ukuran direktori tumbuh melampaui batas ini, mesin cache yang paling sedikit digunakan dihapus. Nilai default adalah 512 MB. Misalnya, Anda dapat menyetel parameter ini ke nilai berikut untuk mengaktifkan caching model TensorRT dan membatasi ukuran cache hingga 800 MB. ``` TVM_TENSORRT_CACHE_DIR=/data/secured_folder/trt/cache; TVM_TENSORRT_CACHE_DISK_SIZE_MB=800 ``` `SagemakerEdgeLogVerbose` (Opsional) Nilai string yang menentukan apakah akan mengaktifkan pencatatan debug. Nilai yang didukung adalah `true` dan `false`. Default: `false` `UnixSocketName` (Opsional) Lokasi deskriptor file soket SageMaker AI Edge Manager pada perangkat inti. Default: `/tmp/aws.greengrass.SageMakerEdgeManager.sock` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan bahwa perangkat inti adalah bagian dari *MyEdgeDeviceFleet* dan bahwa agen menulis data pengambilan baik ke perangkat dan ke bucket S3. Konfigurasi ini juga memungkinkan pencatatan debug. ``` { "DeviceFleetName": "MyEdgeDeviceFleet", "BucketName": "amzn-s3-demo-bucket", "CaptureDataDestination": "Disk", "CaptureDataPeriodicUpload": "true", "SagemakerEdgeLogVerbose": "true" } ``` ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.SageMakerEdgeManager.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.SageMakerEdgeManager.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.SageMakerEdgeManager.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.SageMakerEdgeManager.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 1.3.6 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 1.3.5 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 1.3.4 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 1.3.3 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 1.3.2 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 1.3.1 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 1.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/sagemaker-edge-manager-component.html) | | 1.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/sagemaker-edge-manager-component.html) | | 1.1.1 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 1.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/sagemaker-edge-manager-component.html) | | 1.0.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 1.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/sagemaker-edge-manager-component.html) | | 1.0.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 1.0.0 | Versi awal. | # Klasifikasi citra DLR Komponen klasifikasi citra DLR (`aws.greengrass.DLRImageClassification`) berisi contoh kode inferensi untuk melakukan inferensi klasifikasi gambar menggunakan [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) dan model resnet-50. Komponen ini menggunakan varian [Penyimpanan model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) dan komponen [Runtime DLR](dlr-component.md) sebagai dependensi untuk mengunduh DLR dan model sampel. Untuk menggunakan komponen inferensi ini dengan model DLR yang terlatih khusus, [buat versi kustom](ml-customization.md#override-public-model-store) dari komponen penyimpanan model dependen. Untuk menggunakan kode inferensi kustom Anda sendiri, Anda dapat menggunakan resep komponen ini sebagai templat untuk [membuat komponen inferensi kustom](ml-customization.md#create-inference-component). **Topics** + [Versi](#dlr-image-classification-component-versions) + [Tipe](#dlr-image-classification-component-type) + [Sistem operasi](#dlr-image-classification-component-os-support) + [Persyaratan](#dlr-image-classification-component-requirements) + [Dependensi](#dlr-image-classification-component-dependencies) + [Konfigurasi](#dlr-image-classification-component-configuration) + [File log lokal](#dlr-image-classification-component-log-file) + [Changelog](#dlr-image-classification-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ## 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](#dlr-image-classification-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.13 and 2.1.14 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.13 dan 2.1.14 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.4 - 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 hingga 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | | [Toko model klasifikasi gambar DLR](dlr-image-classification-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Lunak | | Penyimpanan model klasifikasi gambar DLR | \$12.0.0 | Keras | | DLR | \$11.3.0 | Lunak | ------ ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ 2.1.x ] `accessControl` (Opsional) Objek yang berisi [kebijakan otorisasi](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk mempublikasikan pesan ke topik pemberitahuan default. Default: ``` { "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.DLRImageClassification:mqttproxy:1": { "policyDescription": "Allows access to publish via topic ml/dlr/image-classification.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "ml/dlr/image-classification" ] } } } ``` `PublishResultsOnTopic` (Opsional) Topik di mana Anda ingin mempublikasikan hasil inferensi. Jika Anda mengubah nilai ini, maka Anda juga harus mengubah nilai `resources` di parameter `accessControl` agar cocok dengan nama topik kustom Anda. Default: `ml/dlr/image-classification` `Accelerator` Akselerator yang ingin Anda gunakan. Nilai yang didukung adalah `cpu` dan `gpu`. Model sampel dalam komponen model dependen hanya mendukung akselerasi CPU. Untuk menggunakan akselerasi GPU dengan model kustom yang berbeda, [buat komponen model kustom](ml-customization.md#override-public-model-store) untuk menimpa komponen model publik. Default: `cpu` `ImageDirectory` (Opsional) Jalur folder pada perangkat di mana komponen inferensi membaca gambar. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat Anda read/write akses. Default: `/greengrass/v2/packages/artifacts-unarchived/component-name/image_classification/sample_images/` Jika Anda menetapkan nilai `UseCamera` ke `true`, maka parameter konfigurasi ini diabaikan. `ImageName` (Opsional) Nama gambar yang digunakan oleh komponen inferensi sebagai masukan untuk membuat prediksi. Komponen mencari gambar dalam folder yang ditentukan dalam `ImageDirectory`. Secara default, komponen menggunakan gambar sampel di direktori gambar default. AWS IoT Greengrass mendukung format gambar berikut:`jpeg`,`jpg`,`png`, dan`npy`. Default: `cat.jpeg` Jika Anda menetapkan nilai `UseCamera` ke `true`, maka parameter konfigurasi ini diabaikan. `InferenceInterval` (Opsional) Waktu dalam detik antara setiap prediksi yang dibuat oleh kode inferensi. Kode inferensi sampel berjalan tanpa batas waktu dan mengulangi prediksinya pada interval waktu yang ditentukan. Misalnya, Anda dapat mengubahnya menjadi interval yang lebih pendek jika ingin menggunakan gambar yang diambil oleh kamera untuk prediksi real-time. Default: `3600` `ModelResourceKey` (Opsional) Model yang digunakan dalam komponen model publik dependen. Ubah parameter ini hanya jika Anda menimpa komponen model publik dengan komponen kustom. Default: ``` { "armv7l": "DLR-resnet50-armv7l-cpu-ImageClassification", "aarch64": "DLR-resnet50-aarch64-cpu-ImageClassification", "x86_64": "DLR-resnet50-x86_64-cpu-ImageClassification", "windows": "DLR-resnet50-win-cpu-ImageClassification" } ``` `UseCamera` (Opsional) Nilai string yang menentukan apakah akan menggunakan gambar dari kamera yang terhubung ke perangkat inti Greengrass. Nilai yang didukung adalah `true` dan `false`. Ketika Anda menetapkan nilai ini ke `true`, kode kesimpulan sampel akan mengakses kamera pada perangkat Anda dan menjalankan kesimpulan secara lokal pada gambar yang ditangkap. Nilai `ImageName` dan parameter `ImageDirectory` diabaikan. Pastikan bahwa pengguna yang menjalankan komponen ini memiliki read/write akses ke lokasi di mana kamera menyimpan gambar yang diambil. Default: `false` Ketika Anda melihat resep komponen ini, parameter konfigurasi `UseCamera` tidak muncul dalam konfigurasi default. Namun, Anda dapat mengubah nilai parameter ini dalam [pembaruan gabungan konfigurasi](update-component-configurations.md) saat Anda men-deploy komponen. Ketika Anda mengatur `UseCamera` ke `true`, Anda juga harus membuat symlink untuk mengaktifkan komponen inferensi untuk mengakses kamera Anda dari lingkungan virtual yang dibuat oleh komponen waktu aktif. Untuk informasi lebih lanjut tentang penggunaan kamera dengan komponen inferensi sampel, lihat [Perbarui konfigurasi komponen](ml-tutorial-image-classification-camera.md). ------ #### [ 2.0.x ] `MLRootPath` (Opsional) Jalur folder pada perangkat inti Linux tempat komponen inferensi membaca gambar dan menulis hasil inferensi. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat read/write diakses oleh pengguna yang menjalankan komponen ini. Default: `/greengrass/v2/work/variant.DLR/greengrass_ml` Default: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml` `Accelerator` Akselerator yang ingin Anda gunakan. Nilai yang didukung adalah `cpu` dan `gpu`. Model sampel dalam komponen model dependen hanya mendukung akselerasi CPU. Untuk menggunakan akselerasi GPU dengan model kustom yang berbeda, [buat komponen model kustom](ml-customization.md#override-public-model-store) untuk menimpa komponen model publik. Default: `cpu` `ImageName` (Opsional) Nama gambar yang digunakan oleh komponen inferensi sebagai masukan untuk membuat prediksi. Komponen mencari gambar dalam folder yang ditentukan dalam `ImageDirectory`. Lokasi defaultnya adalah`MLRootPath/images`. AWS IoT Greengrass mendukung format gambar berikut:`jpeg`,`jpg`,`png`, dan`npy`. Default: `cat.jpeg` `InferenceInterval` (Opsional) Waktu dalam detik antara setiap prediksi yang dibuat oleh kode inferensi. Kode inferensi sampel berjalan tanpa batas waktu dan mengulangi prediksinya pada interval waktu yang ditentukan. Misalnya, Anda dapat mengubahnya menjadi interval yang lebih pendek jika ingin menggunakan gambar yang diambil oleh kamera untuk prediksi real-time. Default: `3600` `ModelResourceKey` (Opsional) Model yang digunakan dalam komponen model publik dependen. Ubah parameter ini hanya jika Anda menimpa komponen model publik dengan komponen kustom. Default: ``` armv7l: "DLR-resnet50-armv7l-cpu-ImageClassification" x86_64: "DLR-resnet50-x86_64-cpu-ImageClassification" ``` ------ ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.DLRImageClassification.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.DLRImageClassification.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.DLRImageClassification.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.DLRImageClassification.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.1.14 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.1.13 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.1.5 | Komponen dirilis di semua Wilayah AWS. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. Versi ini tidak tersedia di Eropa (London) (`eu-west-2`). | | 2.1.3 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-image-classification-component.html) | | 2.0.4 | Versi awal. | # Deteksi objek DLR Komponen deteksi objek DLR (`aws.greengrass.DLRObjectDetection`) berisi contoh kode inferensi untuk melakukan inferensi deteksi objek dengan menggunakan [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) dan sampel model yang terlatih sebelumnya. Komponen ini menggunakan varian [Penyimpanan model deteksi DLR](dlr-object-detection-model-store-component.md) dan komponen [Runtime DLR](dlr-component.md) sebagai dependensi untuk mengunduh DLR dan model sampel. Untuk menggunakan komponen inferensi ini dengan model DLR yang terlatih khusus, [buat versi kustom](ml-customization.md#override-public-model-store) dari komponen penyimpanan model dependen. Untuk menggunakan kode inferensi kustom Anda sendiri, Anda dapat menggunakan resep komponen ini sebagai templat untuk [membuat komponen inferensi kustom](ml-customization.md#create-inference-component). **Topics** + [Versi](#dlr-object-detection-component-versions) + [Tipe](#dlr-object-detection-component-type) + [Sistem operasi](#dlr-object-detection-component-os-support) + [Persyaratan](#dlr-object-detection-component-requirements) + [Dependensi](#dlr-object-detection-component-dependencies) + [Konfigurasi](#dlr-object-detection-component-configuration) + [File log lokal](#dlr-object-detection-component-log-file) + [Changelog](#dlr-object-detection-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ## 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](#dlr-object-detection-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.13 and 2.1.14 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.13 dan 2.1.14 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.4 - 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 hingga 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | | [Toko model deteksi objek DLR](dlr-object-detection-model-store-component.md) | \$12.1.0 | Keras | | [DLR](dlr-component.md) | \$11.6.0 | Keras | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Lunak | | Penyimpanan model deteksi DLR | \$12.0.0 | Keras | | DLR | \$11.3.0 | Lunak | ------ ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ 2.1.x ] `accessControl` (Opsional) Objek yang berisi [kebijakan otorisasi](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk mempublikasikan pesan ke topik pemberitahuan default. Default: ``` { "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.DLRObjectDetection:mqttproxy:1": { "policyDescription": "Allows access to publish via topic ml/dlr/object-detection.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "ml/dlr/object-detection" ] } } } ``` `PublishResultsOnTopic` (Opsional) Topik di mana Anda ingin mempublikasikan hasil inferensi. Jika Anda mengubah nilai ini, maka Anda juga harus mengubah nilai `resources` di parameter `accessControl` agar cocok dengan nama topik kustom Anda. Default: `ml/dlr/object-detection` `Accelerator` Akselerator yang ingin Anda gunakan. Nilai yang didukung adalah `cpu` dan `gpu`. Model sampel dalam komponen model dependen hanya mendukung akselerasi CPU. Untuk menggunakan akselerasi GPU dengan model kustom yang berbeda, [buat komponen model kustom](ml-customization.md#override-public-model-store) untuk menimpa komponen model publik. Default: `cpu` `ImageDirectory` (Opsional) Jalur folder pada perangkat di mana komponen inferensi membaca gambar. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat Anda read/write akses. Default: `/greengrass/v2/packages/artifacts-unarchived/component-name/object_detection/sample_images/` Jika Anda menetapkan nilai `UseCamera` ke `true`, maka parameter konfigurasi ini diabaikan. `ImageName` (Opsional) Nama gambar yang digunakan oleh komponen inferensi sebagai masukan untuk membuat prediksi. Komponen mencari gambar dalam folder yang ditentukan dalam `ImageDirectory`. Secara default, komponen menggunakan gambar sampel di direktori gambar default. AWS IoT Greengrass mendukung format gambar berikut:`jpeg`,`jpg`,`png`, dan`npy`. Default: `objects.jpg` Jika Anda menetapkan nilai `UseCamera` ke `true`, maka parameter konfigurasi ini diabaikan. `InferenceInterval` (Opsional) Waktu dalam detik antara setiap prediksi yang dibuat oleh kode inferensi. Kode inferensi sampel berjalan tanpa batas waktu dan mengulangi prediksinya pada interval waktu yang ditentukan. Misalnya, Anda dapat mengubahnya menjadi interval yang lebih pendek jika ingin menggunakan gambar yang diambil oleh kamera untuk prediksi real-time. Default: `3600` `ModelResourceKey` (Opsional) Model yang digunakan dalam komponen model publik dependen. Ubah parameter ini hanya jika Anda menimpa komponen model publik dengan komponen kustom. Default: ``` { "armv7l": "DLR-yolo3-armv7l-cpu-ObjectDetection", "aarch64": "DLR-yolo3-aarch64-gpu-ObjectDetection", "x86_64": "DLR-yolo3-x86_64-cpu-ObjectDetection", "windows": "DLR-resnet50-win-cpu-ObjectDetection" } ``` `UseCamera` (Opsional) Nilai string yang menentukan apakah akan menggunakan gambar dari kamera yang terhubung ke perangkat inti Greengrass. Nilai yang didukung adalah `true` dan `false`. Ketika Anda menetapkan nilai ini ke `true`, kode kesimpulan sampel akan mengakses kamera pada perangkat Anda dan menjalankan kesimpulan secara lokal pada gambar yang ditangkap. Nilai `ImageName` dan parameter `ImageDirectory` diabaikan. Pastikan bahwa pengguna yang menjalankan komponen ini memiliki read/write akses ke lokasi di mana kamera menyimpan gambar yang diambil. Default: `false` Ketika Anda melihat resep komponen ini, parameter konfigurasi `UseCamera` tidak muncul dalam konfigurasi default. Namun, Anda dapat mengubah nilai parameter ini dalam [pembaruan gabungan konfigurasi](update-component-configurations.md) saat Anda men-deploy komponen. Ketika Anda mengatur `UseCamera` ke `true`, Anda juga harus membuat symlink untuk mengaktifkan komponen inferensi untuk mengakses kamera Anda dari lingkungan virtual yang dibuat oleh komponen waktu aktif. Untuk informasi lebih lanjut tentang penggunaan kamera dengan komponen inferensi sampel, lihat [Perbarui konfigurasi komponen](ml-tutorial-image-classification-camera.md). ------ #### [ 2.0.x ] `MLRootPath` (Opsional) Jalur folder pada perangkat inti Linux tempat komponen inferensi membaca gambar dan menulis hasil inferensi. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat read/write diakses oleh pengguna yang menjalankan komponen ini. Default: `/greengrass/v2/work/variant.DLR/greengrass_ml` Default: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml` `Accelerator` Jangan diubah. Saat ini, satu-satunya nilai yang didukung untuk akselerator adalah `cpu`, karena model dalam komponen model dependen dikompilasi hanya untuk akselerator CPU. `ImageName` (Opsional) Nama gambar yang digunakan oleh komponen inferensi sebagai masukan untuk membuat prediksi. Komponen mencari gambar dalam folder yang ditentukan dalam `ImageDirectory`. Lokasi default adalah`MLRootPath/images`. AWS IoT Greengrass mendukung format gambar berikut:`jpeg`,`jpg`,`png`, dan`npy`. Default: `objects.jpg` `InferenceInterval` (Opsional) Waktu dalam detik antara setiap prediksi yang dibuat oleh kode inferensi. Kode inferensi sampel berjalan tanpa batas waktu dan mengulangi prediksinya pada interval waktu yang ditentukan. Misalnya, Anda dapat mengubahnya menjadi interval yang lebih pendek jika ingin menggunakan gambar yang diambil oleh kamera untuk prediksi real-time. Default: `3600` `ModelResourceKey` (Opsional) Model yang digunakan dalam komponen model publik dependen. Ubah parameter ini hanya jika Anda menimpa komponen model publik dengan komponen kustom. Default: ``` { armv7l: "DLR-yolo3-armv7l-cpu-ObjectDetection", x86_64: "DLR-yolo3-x86_64-cpu-ObjectDetection" } ``` ------ ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.DLRObjectDetection.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.DLRObjectDetection.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.DLRObjectDetection.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.DLRObjectDetection.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.1.14 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.1.13 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.1.5 | Komponen dirilis di semua Wilayah AWS. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. Versi ini tidak tersedia di Eropa (London) (`eu-west-2`). | | 2.1.3 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-object-detection-component.html) | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-object-detection-component.html) | | 2.0.4 | Versi awal. | # Penyimpanan model klasifikasi gambar DLR Toko model klasifikasi gambar DLR adalah komponen model pembelajaran mesin yang berisi ResNet model -50 yang telah dilatih sebelumnya sebagai artefak Greengrass. [Model pra-terlatih yang digunakan dalam komponen ini diambil dari [Kebun Binatang Model GluonCV](https://cv.gluon.ai/model_zoo/index.html) dan dikompilasi menggunakan SageMaker AI Neo Deep Learning Runtime.](https://github.com/neo-ai/neo-ai-dlr) Komponen inferensi [klasifikasi citra DLR](dlr-image-classification-component.md) menggunakan komponen ini sebagai dependensi untuk sumber model. Untuk menggunakan model DLR yang terlatih khusus, [buat versi kustomisasi](ml-customization.md#override-public-model-store) komponen model ini, dan sertakan model kustom Anda sebagai artefak komponen. Anda dapat menggunakan resep komponen ini sebagai templat untuk membuat komponen model kustom. **catatan** Nama komponen penyimpanan model klasifikasi gambar DLR bervariasi tergantung pada versinya. Nama komponen untuk versi 2.1.x dan versi yang lebih baru adalah `variant.DLR.ImageClassification.ModelStore`. Nama komponen untuk versi 2.0.x adalah `variant.ImageClassification.ModelStore`. **Topics** + [Versi](#dlr-image-classification-model-store-component-versions) + [Tipe](#dlr-image-classification-model-store-component-type) + [Sistem operasi](#dlr-image-classification-model-store-component-os-support) + [Persyaratan](#dlr-image-classification-model-store-component-requirements) + [Dependensi](#dlr-image-classification-model-store-component-dependencies) + [Konfigurasi](#dlr-image-classification-model-store-component-configuration) + [Berkas log lokal](#dlr-image-classification-model-store-component-log-file) + [Changelog](#dlr-image-classification-model-store-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x (`variant.DLR.ImageClassification.ModelStore`) + 2.0.x (`variant.ImageClassification.ModelStore`) ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ## 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](#dlr-image-classification-model-store-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.12 - 2.1.14 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.12 dan 2.1.13 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | ------ #### [ 2.1.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Lunak | ------ ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. ## Berkas log lokal Komponen ini tidak mengeluarkan log. ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.1.13 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-image-classification-model-store-component.html) | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.3 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-image-classification-model-store-component.html) | | 2.0.4 | Versi awal. | # Penyimpanan model deteksi DLR Toko model deteksi objek DLR adalah komponen model pembelajaran mesin yang berisi model pra-terlatih YOLOv3 sebagai artefak Greengrass. Model sampel yang digunakan dalam komponen ini diambil dari [Kebun Binatang Model GluonCV](https://cv.gluon.ai/model_zoo/index.html) dan dikompilasi menggunakan SageMaker AI Neo [Deep](https://github.com/neo-ai/neo-ai-dlr) Learning Runtime. Komponen inferensi [deteksi citra DLR](dlr-object-detection-component.md) menggunakan komponen ini sebagai dependensi untuk sumber model. Untuk menggunakan model DLR yang terlatih khusus, [buat versi kustomisasi](ml-customization.md#override-public-model-store) komponen model ini, dan sertakan model kustom Anda sebagai artefak komponen. Anda dapat menggunakan resep komponen ini sebagai templat untuk membuat komponen model kustom. **catatan** Nama komponen penyimpanan model deteksi objek DLR bervariasi tergantung pada versinya. Nama komponen untuk versi 2.1.x dan versi yang lebih baru adalah `variant.DLR.ObjectDetection.ModelStore`. Nama komponen untuk versi 2.0.x adalah `variant.ObjectDetection.ModelStore`. **Topics** + [Versi](#dlr-object-detection-model-store-component-versions) + [Tipe](#dlr-object-detection-model-store-component-type) + [Sistem operasi](#dlr-object-detection-model-store-component-os-support) + [Persyaratan](#dlr-object-detection-model-store-component-requirements) + [Dependensi](#dlr-object-detection-model-store-component-dependencies) + [Konfigurasi](#dlr-object-detection-model-store-component-configuration) + [File log lokal](#dlr-object-detection-model-store-component-log-file) + [Changelog](#dlr-object-detection-model-store-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ## 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](#dlr-object-detection-model-store-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.13 and 2.1.14 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.13 dan 2.1.14 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | ------ #### [ 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | ------ #### [ 2.1.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 2.1.5 and 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dan 2.1.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Lunak | ------ ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. ## File log lokal Komponen ini tidak mengeluarkan log. ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.1.14 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.1.13 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.6 | Menambahkan model CPU untuk memperbaiki masalah pada perangkat Armv8 (AArch64). | | 2.1.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-object-detection-model-store-component.html) | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.3 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-object-detection-model-store-component.html) | | 2.0.4 | Versi awal. | # Runtime DLR Komponen runtime DLR (`variant.DLR`) berisi skrip yang menginstal [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) (DLR) dan dependensinya di lingkungan virtual di perangkat Anda. Komponen [Klasifikasi citra DLR](dlr-image-classification-component.md) dan [Deteksi objek DLR](dlr-object-detection-component.md) menggunakan komponen ini sebagai dependensi untuk menginstal DLR. Versi komponen 1.6.x menginstal DLR v1.6.0 dan versi komponen 1.3.x menginstal DLR v1.3.0. Untuk menggunakan runtime yang berbeda, Anda dapat menggunakan resep komponen ini sebagai template untuk [membuat komponen pembelajaran mesin kustom](ml-customization.md). **Topics** + [Versi](#dlr-component-versions) + [Tipe](#dlr-component-type) + [Sistem operasi](#dlr-component-os-support) + [Persyaratan](#dlr-component-requirements) + [Dependensi](#dlr-component-dependencies) + [Konfigurasi](#dlr-component-configuration) + [Penggunaan](#dlr-component-usage) + [Berkas log lokal](#dlr-component-log-file) + [Changelog](#dlr-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 1.6.x + 1.3.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ### Titik akhir dan port Secara default, komponen ini menggunakan skrip installer untuk menginstal paket menggunakan`apt`,, `yum``brew`, dan `pip` perintah, tergantung pada platform apa yang digunakan perangkat inti. Komponen ini harus dapat melakukan permintaan keluar ke berbagai indeks paket dan repositori untuk menjalankan skrip installer. Untuk mengizinkan lalu lintas keluar komponen ini melalui proxy atau firewall, Anda harus mengidentifikasi titik akhir untuk indeks paket dan repositori tempat perangkat inti Anda terhubung untuk menginstal. Pertimbangkan hal berikut ketika Anda mengidentifikasi titik akhir yang diperlukan untuk skrip penginstalan komponen ini: + Titik akhir bergantung pada platform perangkat inti. Misalnya, perangkat inti yang menjalankan Ubuntu menggunakan `apt` bukan `yum` atau`brew`. Selain itu, perangkat yang menggunakan indeks paket yang sama mungkin memiliki daftar sumber yang berbeda, sehingga mereka mungkin mengambil paket dari repositori yang berbeda. + Titik akhir mungkin berbeda antara beberapa perangkat yang menggunakan indeks paket yang sama, karena setiap perangkat memiliki daftar sumbernya sendiri yang menentukan tempat untuk mengambil paket. + Titik akhir mungkin berubah seiring waktu. Setiap indeks paket menyediakan repositori tempat Anda mengunduh paket, dan pemilik paket dapat mengubah apa yang disediakan URLs oleh indeks paket. URLs Untuk informasi selengkapnya tentang dependensi yang dipasang komponen ini, dan cara menonaktifkan skrip penginstal, lihat parameter konfigurasi. [UseInstaller](#dlr-component-config-useinstaller-term) Untuk informasi selengkapnya tentang titik akhir dan port yang diperlukan untuk operasi dasar, lihat[Izinkan lalu lintas perangkat melalui proxy atau firewall](allow-device-traffic.md). ## 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](#dlr-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 1.6.11 - 1.6.16 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.11 hingga 1.6.16 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Lunak | ------ #### [ 1.6.10 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 1.6.9 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 1.6.8 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.8 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 1.6.6 and 1.6.7 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.6 dan 1.6.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 1.6.4 and 1.6.5 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.4 dan 1.6.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 1.6.3 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 1.6.2 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 1.6.1 ] Tabel berikut mencantumkan dependensi untuk versi 1.6.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ #### [ 1.3.x ] Tabel berikut mencantumkan dependensi untuk versi 1.3.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | \$12.0.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `MLRootPath` (Opsional) Jalur folder pada perangkat inti Linux tempat komponen inferensi membaca gambar dan menulis hasil inferensi. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat read/write diakses oleh pengguna yang menjalankan komponen ini. Default: `/greengrass/v2/work/variant.DLR/greengrass_ml` `WindowsMLRootPath` Fitur ini tersedia di v1.6.6 dan yang lebih baru dari komponen ini. (Opsional) Jalur folder pada perangkat inti Windows tempat komponen inferensi membaca gambar dan menulis hasil inferensi. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat read/write diakses oleh pengguna yang menjalankan komponen ini. Default: `C:\greengrass\v2\\work\\variant.DLR\\greengrass_ml` `UseInstaller` (Opsional) Nilai string yang menentukan apakah akan menggunakan skrip installer dalam komponen ini untuk menginstal DLR dan dependensinya. Nilai yang didukung adalah `true` dan `false`. Tetapkan nilai ini `false` jika Anda ingin menggunakan skrip kustom untuk instalasi DLR, atau jika Anda ingin menyertakan dependensi runtime dalam image Linux yang sudah dibuat sebelumnya. Untuk menggunakan komponen ini dengan komponen inferensi DLR yang AWS disediakan, instal pustaka berikut, termasuk dependensi apa pun, dan buat tersedia bagi pengguna sistem, seperti`ggc_user`, yang menjalankan komponen ML. + [Python](https://www.python.org/downloads/) 3.7 atau yang lebih baru, termasuk `pip` untuk versi Python Anda. + [Runtime Pembelajaran Mendalam](https://github.com/neo-ai/neo-ai-dlr) v1.6.0 + [NumPy](https://numpy.org/install/). + [OpenCV-Python](https://pypi.org/project/opencv-python/). + [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2). + [AWS Python Runtime Umum (CRT](https://github.com/awslabs/aws-crt-python)). + [Picamera](https://picamera.readthedocs.io/en/release-1.13/) (hanya untuk perangkat Raspberry Pi). + [`awscam`modul](https://docs.aws.amazon.com/deeplens/latest/dg/deeplens-library-awscam-module.html) (untuk AWS DeepLens perangkat). + LibGL (untuk perangkat Linux) Default: `true` ## Penggunaan Gunakan komponen ini dengan parameter `UseInstaller` konfigurasi yang disetel `true` untuk menginstal DLR dan dependensinya di perangkat Anda. Komponen menyiapkan lingkungan virtual di perangkat Anda yang menyertakan OpenCV dan NumPy pustaka yang diperlukan untuk DLR. **catatan** Skrip penginstal dalam komponen ini juga menginstal versi terbaru dari pustaka sistem tambahan yang diperlukan untuk mengonfigurasi lingkungan virtual pada perangkat Anda dan menggunakan kerangka kerja pembelajaran mesin yang diinstal. Hal ini dapat meningkatkan pustaka sistem yang ada di perangkat Anda. Tinjau tabel berikut untuk daftar pustaka yang menginstal komponen ini untuk setiap sistem operasi yang didukung. Jika Anda ingin menyesuaikan proses instalasi ini, atur parameter `UseInstaller` konfigurasi ke`false`, dan kembangkan skrip penginstal Anda sendiri. | Platform | Pustaka terpasang pada sistem perangkat | Pustaka terpasang di lingkungan virtual | | --- | --- | --- | | Armv7l | build-essential, cmake, ca-certificates, git | setuptools, wheel | | Amazon Linux 2 | mesa-libGL | Tidak ada | | Ubuntu | wget | Tidak ada | Ketika Anda men-deploy komponen inferensi Anda, komponen waktu aktif ini pertama-tama akan memverifikasi apakah perangkat Anda sudah memiliki DLR dan dependensinya sudah diinstal, dan jika tidak, ia akan menginstalnya untuk Anda. ## Berkas log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/variant.DLR.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\variant.DLR.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/variant.DLR.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\variant.DLR.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 1.6.16 | Versi diperbarui untuk Greengrass nucleus versi 2.12.5. | | 1.6.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-component.html) | | 1.6.11 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 1.6.10 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 1.6.9 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 1.6.8 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 1.6.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-component.html) | | 1.6.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-component.html) | | 1.6.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-component.html) | | 1.6.4 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 1.6.3 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 1.6.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 1.6.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/dlr-component.html) | | 1.3.2 | Versi awal. Menginstal DLR v1.3.0. | # TensorFlow Klasifikasi gambar ringan Komponen klasifikasi gambar TensorFlow Lite (`aws.greengrass.TensorFlowLiteImageClassification`) berisi kode inferensi sampel untuk melakukan inferensi klasifikasi gambar menggunakan runtime [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) dan model terkuantisasi 1.0 yang telah dilatih sebelumnya MobileNet . Komponen ini menggunakan varian [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) dan [TensorFlow Runtime ringan](tensorflow-lite-component.md) komponen sebagai dependensi untuk mengunduh runtime TensorFlow Lite dan model sampel. Untuk menggunakan komponen inferensi ini dengan model TensorFlow Lite yang terlatih khusus, [buat versi kustom](ml-customization.md#override-public-model-store) komponen penyimpanan model dependen. Untuk menggunakan kode inferensi kustom Anda sendiri, Anda dapat menggunakan resep komponen ini sebagai templat untuk [membuat komponen inferensi kustom](ml-customization.md#create-inference-component). **Topics** + [Versi](#tensorflow-lite-image-classification-component-versions) + [Tipe](#tensorflow-lite-image-classification-component-type) + [Sistem operasi](#tensorflow-lite-image-classification-component-os-support) + [Persyaratan](#tensorflow-lite-image-classification-component-requirements) + [Dependensi](#tensorflow-lite-image-classification-component-dependencies) + [Konfigurasi](#tensorflow-lite-image-classification-component-configuration) + [Berkas log lokal](#tensorflow-lite-image-classification-component-log-file) + [Changelog](#tensorflow-lite-image-classification-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ## 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](#tensorflow-lite-image-classification-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.11 and 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 dan 2.1.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `accessControl` (Opsional) Objek yang berisi [kebijakan otorisasi](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk mempublikasikan pesan ke topik pemberitahuan default. Default: ``` { "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.TensorFlowLiteImageClassification:mqttproxy:1": { "policyDescription": "Allows access to publish via topic ml/tflite/image-classification.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "ml/tflite/image-classification" ] } } } ``` `PublishResultsOnTopic` (Opsional) Topik di mana Anda ingin mempublikasikan hasil inferensi. Jika Anda mengubah nilai ini, maka Anda juga harus mengubah nilai `resources` di parameter `accessControl` agar cocok dengan nama topik kustom Anda. Default: `ml/tflite/image-classification` `Accelerator` Akselerator yang ingin Anda gunakan. Nilai yang didukung adalah `cpu` dan `gpu`. Model sampel dalam komponen model dependen hanya mendukung akselerasi CPU. Untuk menggunakan akselerasi GPU dengan model kustom yang berbeda, [buat komponen model kustom](ml-customization.md#override-public-model-store) untuk menimpa komponen model publik. Default: `cpu` `ImageDirectory` (Opsional) Jalur folder pada perangkat di mana komponen inferensi membaca gambar. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat Anda read/write akses. Default: `/greengrass/v2/packages/artifacts-unarchived/component-name/image_classification/sample_images/` Jika Anda menetapkan nilai `UseCamera` ke `true`, maka parameter konfigurasi ini diabaikan. `ImageName` (Opsional) Nama gambar yang digunakan oleh komponen inferensi sebagai masukan untuk membuat prediksi. Komponen mencari gambar dalam folder yang ditentukan dalam `ImageDirectory`. Secara default, komponen menggunakan gambar sampel di direktori gambar default. AWS IoT Greengrass mendukung format gambar berikut:`jpeg`,`jpg`,`png`, dan`npy`. Default: `cat.jpeg` Jika Anda menetapkan nilai `UseCamera` ke `true`, maka parameter konfigurasi ini diabaikan. `InferenceInterval` (Opsional) Waktu dalam detik antara setiap prediksi yang dibuat oleh kode inferensi. Kode inferensi sampel berjalan tanpa batas waktu dan mengulangi prediksinya pada interval waktu yang ditentukan. Misalnya, Anda dapat mengubahnya menjadi interval yang lebih pendek jika ingin menggunakan gambar yang diambil oleh kamera untuk prediksi real-time. Default: `3600` `ModelResourceKey` (Opsional) Model yang digunakan dalam komponen model publik dependen. Ubah parameter ini hanya jika Anda menimpa komponen model publik dengan komponen kustom. Default: ``` { "model": "TensorFlowLite-Mobilenet" } ``` `UseCamera` (Opsional) Nilai string yang menentukan apakah akan menggunakan gambar dari kamera yang terhubung ke perangkat inti Greengrass. Nilai yang didukung adalah `true` dan `false`. Ketika Anda menetapkan nilai ini ke `true`, kode kesimpulan sampel akan mengakses kamera pada perangkat Anda dan menjalankan kesimpulan secara lokal pada gambar yang ditangkap. Nilai `ImageName` dan parameter `ImageDirectory` diabaikan. Pastikan bahwa pengguna yang menjalankan komponen ini memiliki read/write akses ke lokasi di mana kamera menyimpan gambar yang diambil. Default: `false` Ketika Anda melihat resep komponen ini, parameter konfigurasi `UseCamera` tidak muncul dalam konfigurasi default. Namun, Anda dapat mengubah nilai parameter ini dalam [pembaruan gabungan konfigurasi](update-component-configurations.md) saat Anda men-deploy komponen. Ketika Anda mengatur `UseCamera` ke `true`, Anda juga harus membuat symlink untuk mengaktifkan komponen inferensi untuk mengakses kamera Anda dari lingkungan virtual yang dibuat oleh komponen waktu aktif. Untuk informasi lebih lanjut tentang penggunaan kamera dengan komponen inferensi sampel, lihat [Perbarui konfigurasi komponen](ml-tutorial-image-classification-camera.md). ## Berkas log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.TensorFlowLiteImageClassification.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteImageClassification.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.TensorFlowLiteImageClassification.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteImageClassification.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | Versi | Perubahan | | --- | --- | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.0 | Versi awal. | # TensorFlow Deteksi objek Lite Komponen deteksi objek TensorFlow Lite (`aws.greengrass.TensorFlowLiteObjectDetection`) berisi kode inferensi sampel untuk melakukan inferensi deteksi objek menggunakan [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) dan model Single Shot Detection (SSD) MobileNet 1.0 yang telah dilatih sebelumnya. Komponen ini menggunakan varian [TensorFlow Toko model deteksi objek Lite](tensorflow-lite-object-detection-model-store-component.md) dan [TensorFlow Runtime ringan](tensorflow-lite-component.md) komponen sebagai dependensi untuk mengunduh TensorFlow Lite dan model sampel. Untuk menggunakan komponen inferensi ini dengan model TensorFlow Lite yang terlatih khusus, Anda dapat [membuat versi kustom](ml-customization.md#override-public-model-store) komponen penyimpanan model dependen. Untuk menggunakan kode inferensi kustom Anda sendiri, gunakan resep komponen ini sebagai templat untuk [membuat komponen inferensi kustom](ml-customization.md#create-inference-component). **Topics** + [Versi](#tensorflow-lite-object-detection-component-versions) + [Tipe](#tensorflow-lite-object-detection-component-type) + [Sistem operasi](#tensorflow-lite-object-detection-component-os-support) + [Persyaratan](#tensorflow-lite-object-detection-component-requirements) + [Dependensi](#tensorflow-lite-object-detection-component-dependencies) + [Konfigurasi](#tensorflow-lite-object-detection-component-configuration) + [File log lokal](#tensorflow-lite-object-detection-component-log-file) + [Changelog](#tensorflow-lite-object-detection-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ## 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](#tensorflow-lite-object-detection-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.11 and 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 dan 2.1.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | | [TensorFlow Toko model klasifikasi gambar Lite](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Keras | | [TensorFlow Lite](tensorflow-lite-component.md) | >=2.5.0 <2.6.0 | Keras | ------ ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `accessControl` (Opsional) Objek yang berisi [kebijakan otorisasi](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk mempublikasikan pesan ke topik pemberitahuan default. Default: ``` { "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.TensorFlowLiteObjectDetection:mqttproxy:1": { "policyDescription": "Allows access to publish via topic ml/tflite/object-detection.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "ml/tflite/object-detection" ] } } } ``` `PublishResultsOnTopic` (Opsional) Topik di mana Anda ingin mempublikasikan hasil inferensi. Jika Anda mengubah nilai ini, maka Anda juga harus mengubah nilai `resources` di parameter `accessControl` agar cocok dengan nama topik kustom Anda. Default: `ml/tflite/object-detection` `Accelerator` Akselerator yang ingin Anda gunakan. Nilai yang didukung adalah `cpu` dan `gpu`. Model sampel dalam komponen model dependen hanya mendukung akselerasi CPU. Untuk menggunakan akselerasi GPU dengan model kustom yang berbeda, [buat komponen model kustom](ml-customization.md#override-public-model-store) untuk menimpa komponen model publik. Default: `cpu` `ImageDirectory` (Opsional) Jalur folder pada perangkat di mana komponen inferensi membaca gambar. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat Anda read/write akses. Default: `/greengrass/v2/packages/artifacts-unarchived/component-name/object_detection/sample_images/` Jika Anda menetapkan nilai `UseCamera` ke `true`, maka parameter konfigurasi ini diabaikan. `ImageName` (Opsional) Nama gambar yang digunakan oleh komponen inferensi sebagai masukan untuk membuat prediksi. Komponen mencari gambar dalam folder yang ditentukan dalam `ImageDirectory`. Secara default, komponen menggunakan gambar sampel di direktori gambar default. AWS IoT Greengrass mendukung format gambar berikut:`jpeg`,`jpg`,`png`, dan`npy`. Default: `objects.jpg` Jika Anda menetapkan nilai `UseCamera` ke `true`, maka parameter konfigurasi ini diabaikan. `InferenceInterval` (Opsional) Waktu dalam detik antara setiap prediksi yang dibuat oleh kode inferensi. Kode inferensi sampel berjalan tanpa batas waktu dan mengulangi prediksinya pada interval waktu yang ditentukan. Misalnya, Anda dapat mengubahnya menjadi interval yang lebih pendek jika ingin menggunakan gambar yang diambil oleh kamera untuk prediksi real-time. Default: `3600` `ModelResourceKey` (Opsional) Model yang digunakan dalam komponen model publik dependen. Ubah parameter ini hanya jika Anda menimpa komponen model publik dengan komponen kustom. Default: ``` { "model": "TensorFlowLite-SSD" } ``` `UseCamera` (Opsional) Nilai string yang menentukan apakah akan menggunakan gambar dari kamera yang terhubung ke perangkat inti Greengrass. Nilai yang didukung adalah `true` dan `false`. Ketika Anda menetapkan nilai ini ke `true`, kode kesimpulan sampel akan mengakses kamera pada perangkat Anda dan menjalankan kesimpulan secara lokal pada gambar yang ditangkap. Nilai `ImageName` dan parameter `ImageDirectory` diabaikan. Pastikan bahwa pengguna yang menjalankan komponen ini memiliki read/write akses ke lokasi di mana kamera menyimpan gambar yang diambil. Default: `false` Ketika Anda melihat resep komponen ini, parameter konfigurasi `UseCamera` tidak muncul dalam konfigurasi default. Namun, Anda dapat mengubah nilai parameter ini dalam [pembaruan gabungan konfigurasi](update-component-configurations.md) saat Anda men-deploy komponen. Ketika Anda mengatur `UseCamera` ke `true`, Anda juga harus membuat symlink untuk mengaktifkan komponen inferensi untuk mengakses kamera Anda dari lingkungan virtual yang dibuat oleh komponen waktu aktif. Untuk informasi lebih lanjut tentang penggunaan kamera dengan komponen inferensi sampel, lihat [Perbarui konfigurasi komponen](ml-tutorial-image-classification-camera.md). **catatan** Ketika Anda melihat resep komponen ini, parameter konfigurasi `UseCamera` tidak muncul dalam konfigurasi default. Namun, Anda dapat mengubah nilai parameter ini dalam [pembaruan gabungan konfigurasi](update-component-configurations.md) saat Anda men-deploy komponen. Ketika Anda mengatur `UseCamera` ke `true`, Anda juga harus membuat symlink untuk mengaktifkan komponen inferensi untuk mengakses kamera Anda dari lingkungan virtual yang dibuat oleh komponen waktu aktif. Untuk informasi lebih lanjut tentang penggunaan kamera dengan komponen inferensi sampel, lihat [Perbarui konfigurasi komponen](ml-tutorial-image-classification-camera.md). ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.TensorFlowLiteObjectDetection.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteObjectDetection.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.TensorFlowLiteObjectDetection.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteObjectDetection.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | Versi | Perubahan | | --- | --- | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/tensorflow-lite-object-detection-component.html) | | 2.1.0 | Versi awal. | # TensorFlow Toko model klasifikasi gambar Lite Toko model klasifikasi gambar TensorFlow Lite (`variant.TensorFlowLite.ImageClassification.ModelStore`) adalah komponen model pembelajaran mesin yang berisi model MobileNet v1 yang telah dilatih sebelumnya sebagai artefak Greengrass. Model sampel yang digunakan dalam komponen ini diambil dari [TensorFlowHub](https://tfhub.dev/) dan diimplementasikan menggunakan [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python). Komponen inferensi [TensorFlow Klasifikasi gambar ringan](tensorflow-lite-image-classification-component.md) menggunakan komponen ini sebagai dependensi untuk sumber model. Untuk menggunakan model TensorFlow Lite yang terlatih khusus, [buat versi kustom](ml-customization.md#override-public-model-store) komponen model ini, dan sertakan model kustom Anda sebagai artefak komponen. Anda dapat menggunakan resep komponen ini sebagai templat untuk membuat komponen model kustom. **Topics** + [Versi](#tensorflow-lite-image-classification-model-store-component-versions) + [Tipe](#tensorflow-lite-image-classification-model-store-component-type) + [Sistem operasi](#tensorflow-lite-image-classification-model-store-component-os-support) + [Persyaratan](#tensorflow-lite-image-classification-model-store-component-requirements) + [Dependensi](#tensorflow-lite-image-classification-model-store-component-dependencies) + [Konfigurasi](#tensorflow-lite-image-classification-model-store-component-configuration) + [File log lokal](#tensorflow-lite-image-classification-model-store-component-log-file) + [Changelog](#tensorflow-lite-image-classification-model-store-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ## 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](#tensorflow-lite-image-classification-model-store-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.11 and 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 dan 2.1.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. ## File log lokal Komponen ini tidak mengeluarkan log. ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | Versi | Perubahan | | --- | --- | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.0 | Versi awal. | # TensorFlow Toko model deteksi objek Lite TensorFlow Lite object detection model store (`variant.TensorFlowLite.ObjectDetection.ModelStore`) adalah komponen model pembelajaran mesin yang berisi model Single Shot Detection (SSD) MobileNet pra-terlatih sebagai artefak Greengrass. Model sampel yang digunakan dalam komponen ini diambil dari [TensorFlow Hub](https://tfhub.dev/) dan diimplementasikan menggunakan [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python). Komponen inferensi [deteksi objek TensorFlow Lite](tensorflow-lite-object-detection-component.md) menggunakan komponen ini sebagai dependensi untuk sumber model. Untuk menggunakan model TensorFlow Lite yang terlatih khusus, [buat versi kustom](ml-customization.md#override-public-model-store) komponen model ini, dan sertakan model kustom Anda sebagai artefak komponen. Anda dapat menggunakan resep komponen ini sebagai templat untuk membuat komponen model kustom. **Topics** + [Versi](#tensorflow-lite-object-detection-model-store-component-versions) + [Tipe](#tensorflow-lite-object-detection-model-store-component-type) + [Sistem operasi](#tensorflow-lite-object-detection-model-store-component-os-support) + [Persyaratan](#tensorflow-lite-object-detection-model-store-component-requirements) + [Dependensi](#tensorflow-lite-object-detection-model-store-component-dependencies) + [Konfigurasi](#tensorflow-lite-object-detection-model-store-component-configuration) + [File log lokal](#tensorflow-lite-object-detection-model-store-component-log-file) + [Changelog](#tensorflow-lite-object-detection-model-store-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ## 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](#tensorflow-lite-object-detection-model-store-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.11 and 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 dan 2.1.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. ## File log lokal Komponen ini tidak mengeluarkan log. ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | Versi | Perubahan | | --- | --- | | 2.1.12 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.1.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.1.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.1.0 | Versi awal. | # TensorFlow Runtime ringan Komponen runtime TensorFlow Lite (`variant.TensorFlowLite`) berisi skrip yang menginstal [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) versi 2.5.0 dan dependensinya di lingkungan virtual di perangkat Anda. [Klasifikasi gambar TensorFlow TensorFlow Lite](tensorflow-lite-image-classification-component.md) [dan komponen deteksi objek Lite](tensorflow-lite-object-detection-component.md) menggunakan komponen runtime ini sebagai dependensi untuk menginstal TensorFlow Lite. **catatan** TensorFlow Komponen runtime Lite v2.5.6 dan yang lebih baru menginstal ulang instalasi yang ada dari runtime Lite dan dependensinya. TensorFlow Instalasi ulang ini membantu memastikan bahwa perangkat inti menjalankan versi TensorFlow Lite yang kompatibel dan dependensinya. Untuk menggunakan runtime yang berbeda, Anda dapat menggunakan resep komponen ini sebagai template untuk [membuat komponen pembelajaran mesin kustom](ml-customization.md). **Topics** + [Versi](#tensorflow-lite-component-versions) + [Tipe](#tensorflow-lite-component-type) + [Sistem operasi](#tensorflow-lite-component-os-support) + [Persyaratan](#tensorflow-lite-component-requirements) + [Dependensi](#tensorflow-lite-component-dependencies) + [Konfigurasi](#tensorflow-lite-component-configuration) + [Penggunaan](#tensorflow-lite-component-usage) + [File log lokal](#tensorflow-lite-component-log-file) + [Changelog](#tensorflow-lite-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.5.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Pada perangkat inti Greengrass yang menjalankan Amazon Linux 2 atau Ubuntu 18.04, [Pustaka GNU C](https://www.gnu.org/software/libc/) (glibc) versi 2.27 atau yang lebih baru diinstal pada perangkat. + Pada perangkat ARMv7L, seperti Raspberry Pi, dependensi untuk OpenCV-Python diinstal pada perangkat. Jalankan perintah berikut untuk menginstal dependensi. ``` sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev ``` + Perangkat Raspberry Pi yang menjalankan Raspberry Pi OS Bullseye harus memenuhi persyaratan berikut: + NumPy 1.22.4 atau yang lebih baru diinstal pada perangkat. Raspberry Pi OS Bullseye menyertakan versi sebelumnya NumPy, sehingga Anda dapat menjalankan perintah berikut untuk meningkatkan NumPy pada perangkat. ``` pip3 install --upgrade numpy ``` + Tumpukan kamera lama diaktifkan di perangkat. Raspberry Pi OS Bullseye menyertakan tumpukan kamera baru yang diaktifkan secara default dan tidak kompatibel, jadi Anda harus mengaktifkan tumpukan kamera lama. **Untuk mengaktifkan tumpukan kamera lama** 1. Jalankan perintah berikut untuk membuka alat konfigurasi Raspberry Pi. ``` sudo raspi-config ``` 1. Pilih **Opsi Antarmuka**. 1. Pilih **Kamera lama** untuk mengaktifkan tumpukan kamera lama. 1. Reboot Raspberry Pi. ### Titik akhir dan port Secara default, komponen ini menggunakan skrip installer untuk menginstal paket menggunakan`apt`,, `yum``brew`, dan `pip` perintah, tergantung pada platform apa yang digunakan perangkat inti. Komponen ini harus dapat melakukan permintaan keluar ke berbagai indeks paket dan repositori untuk menjalankan skrip installer. Untuk mengizinkan lalu lintas keluar komponen ini melalui proxy atau firewall, Anda harus mengidentifikasi titik akhir untuk indeks paket dan repositori tempat perangkat inti Anda terhubung untuk menginstal. Pertimbangkan hal berikut ketika Anda mengidentifikasi titik akhir yang diperlukan untuk skrip penginstalan komponen ini: + Titik akhir bergantung pada platform perangkat inti. Misalnya, perangkat inti yang menjalankan Ubuntu menggunakan `apt` bukan `yum` atau`brew`. Selain itu, perangkat yang menggunakan indeks paket yang sama mungkin memiliki daftar sumber yang berbeda, sehingga mereka mungkin mengambil paket dari repositori yang berbeda. + Titik akhir mungkin berbeda antara beberapa perangkat yang menggunakan indeks paket yang sama, karena setiap perangkat memiliki daftar sumbernya sendiri yang menentukan tempat untuk mengambil paket. + Titik akhir mungkin berubah seiring waktu. Setiap indeks paket menyediakan repositori tempat Anda mengunduh paket, dan pemilik paket dapat mengubah apa yang disediakan URLs oleh indeks paket. URLs Untuk informasi selengkapnya tentang dependensi yang dipasang komponen ini, dan cara menonaktifkan skrip penginstal, lihat parameter konfigurasi. [UseInstaller](#tensorflow-lite-component-config-useinstaller-term) Untuk informasi selengkapnya tentang titik akhir dan port yang diperlukan untuk operasi dasar, lihat[Izinkan lalu lintas perangkat melalui proxy atau firewall](allow-device-traffic.md). ## 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](#tensorflow-lite-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.5.14 and 2.5.15 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.14 dan 2.5.15 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | ------ #### [ 2.5.13 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.13 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | ------ #### [ 2.5.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | ------ #### [ 2.5.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | ------ #### [ 2.5.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 2.5.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 2.5.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.8 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 2.5.5 - 2.5.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.5 hingga 2.5.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 2.5.3 and 2.5.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.3 dan 2.5.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 2.5.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 2.5.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 2.5.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.5.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `MLRootPath` (Opsional) Jalur folder pada perangkat inti Linux tempat komponen inferensi membaca gambar dan menulis hasil inferensi. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat read/write diakses oleh pengguna yang menjalankan komponen ini. Default: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml` `WindowsMLRootPath` Fitur ini tersedia di v1.6.6 dan yang lebih baru dari komponen ini. (Opsional) Jalur folder pada perangkat inti Windows tempat komponen inferensi membaca gambar dan menulis hasil inferensi. Anda dapat mengubah nilai ini ke lokasi mana pun di perangkat yang dapat read/write diakses oleh pengguna yang menjalankan komponen ini. Default: `C:\greengrass\v2\\work\\variant.DLR\\greengrass_ml` `UseInstaller` (Opsional) Nilai string yang menentukan apakah akan menggunakan skrip installer dalam komponen ini untuk menginstal TensorFlow Lite dan dependensinya. Nilai yang didukung adalah `true` dan `false`. Tetapkan nilai ini `false` jika Anda ingin menggunakan skrip kustom untuk instalasi TensorFlow Lite, atau jika Anda ingin menyertakan dependensi runtime dalam image Linux yang sudah dibuat sebelumnya. Untuk menggunakan komponen ini dengan komponen inferensi TensorFlow Lite AWS-provided, instal pustaka berikut, termasuk dependensi apa pun, dan sediakan komponen tersebut bagi pengguna sistem, seperti`ggc_user`, yang menjalankan komponen ML. + [Python](https://www.python.org/downloads/) 3.8 atau yang lebih baru, termasuk `pip` untuk versi Python Anda + [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) v2.5.0 + [NumPy](https://numpy.org/install/) + [OpenCV-Python](https://pypi.org/project/opencv-python/) + [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2) + [AWS Python Runtime Umum (CRT)](https://github.com/awslabs/aws-crt-python) + [Picamera](https://picamera.readthedocs.io/en/release-1.13/) (untuk perangkat Raspberry Pi) + [`awscam`modul](https://docs.aws.amazon.com/deeplens/latest/dg/deeplens-library-awscam-module.html) (untuk AWS DeepLens perangkat) + LibGL (untuk perangkat Linux) Default: `true` ## Penggunaan Gunakan komponen ini dengan parameter `UseInstaller` konfigurasi yang disetel `true` untuk menginstal TensorFlow Lite dan dependensinya di perangkat Anda. Komponen menyiapkan lingkungan virtual di perangkat Anda yang menyertakan OpenCV dan NumPy pustaka yang diperlukan untuk Lite. TensorFlow **catatan** Skrip penginstal dalam komponen ini juga menginstal versi terbaru dari pustaka sistem tambahan yang diperlukan untuk mengonfigurasi lingkungan virtual pada perangkat Anda dan menggunakan kerangka kerja pembelajaran mesin yang diinstal. Hal ini dapat meningkatkan pustaka sistem yang ada di perangkat Anda. Tinjau tabel berikut untuk daftar pustaka yang menginstal komponen ini untuk setiap sistem operasi yang didukung. Jika Anda ingin menyesuaikan proses instalasi ini, atur parameter `UseInstaller` konfigurasi ke`false`, dan kembangkan skrip penginstal Anda sendiri. | Platform | Pustaka terpasang pada sistem perangkat | Pustaka terpasang di lingkungan virtual | | --- | --- | --- | | Armv7l | build-essential, cmake, ca-certificates, git | setuptools, wheel | | Amazon Linux 2 | mesa-libGL | Tidak ada | | Ubuntu | wget | Tidak ada | Saat Anda menerapkan komponen inferensi, komponen runtime ini terlebih dahulu memverifikasi apakah perangkat Anda sudah menginstal TensorFlow Lite dan dependensinya. Jika tidak, maka komponen waktu aktif akan menginstalnya untuk Anda. ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/variant.TensorFlowLite.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\variant.TensorFlowLite.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/variant.TensorFlowLite.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\variant.TensorFlowLite.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | Versi | Perubahan | | --- | --- | | 2.5.15 | Versi diperbarui untuk Greengrass nucleus 2.12.5 rilis. | | 2.5.14 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.5.13 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.5.12 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.5.11 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.5.10 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.5.9 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.5.8 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.5.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/tensorflow-lite-component.html) | | 2.5.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/tensorflow-lite-component.html) | | 2.5.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/tensorflow-lite-component.html) | | 2.5.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/tensorflow-lite-component.html) | | 2.5.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.5.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.5.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.5.0 | Versi awal. | # Adaptor protokol Modbus-RTU Komponen adaptor protokol Modbus-RTU (`aws.greengrass.Modbus`) mengumpulkan informasi dari perangkat Modbus RTU lokal. Untuk meminta informasi dari perangkat Modbus RTU lokal dengan komponen ini, publikasikan pesan ke topik di mana komponen ini berlangganan. Dalam pesan, tentukan permintaan Modbus RTU yang akan dikirim ke perangkat. Kemudian, komponen ini akan menerbitkan respon yang berisi hasil permintaan Modbus RTU. **catatan** Komponen ini menyediakan fungsionalitas yang mirip dengan konektor adaptor protokol Modbus RTU di AWS IoT Greengrass V1. Untuk informasi selengkapnya, lihat [konektor adaptor protokol RTU Modbus](https://docs.aws.amazon.com/greengrass/latest/developerguide/modbus-protocol-adapter-connector.html) di *Panduan Developer V1 AWS IoT Greengrass *. **Topics** + [Versi](#modbus-rtu-protocol-adapter-component-versions) + [Tipe](#modbus-rtu-protocol-adapter-component-type) + [Sistem operasi](#modbus-rtu-protocol-adapter-component-os-support) + [Persyaratan](#modbus-rtu-protocol-adapter-component-requirements) + [Dependensi](#modbus-rtu-protocol-adapter-component-dependencies) + [Konfigurasi](#modbus-rtu-protocol-adapter-component-configuration) + [Data input](#modbus-rtu-protocol-adapter-component-input-data) + [Data output](#modbus-rtu-protocol-adapter-component-output-data) + [Permintaan dan tanggapan Modbus RTU](#modbus-rtu-protocol-adapter-component-requests-responses) + [File log lokal](#modbus-rtu-protocol-adapter-component-log-file) + [Lisensi](#modbus-rtu-protocol-adapter-component-licenses) + [Changelog](#modbus-rtu-protocol-adapter-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen Lambda () `aws.greengrass.lambda`. [Inti [Greengrass](greengrass-nucleus-component.md) menjalankan fungsi Lambda komponen ini menggunakan komponen peluncur Lambda.](lambda-launcher-component.md) Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). + [Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH. + Koneksi fisik antara perangkat AWS IoT Greengrass inti dan perangkat Modbus. Perangkat inti harus terhubung secara fisik ke jaringan Modbus RTU melalui port serial, seperti port USB. + Untuk menerima data keluaran dari komponen ini, Anda harus menggabungkan pemutakhiran konfigurasi berikut untuk [komponen router langganan lama (`aws.greengrass.LegacySubscriptionRouter`) saat menerapkan komponen](legacy-subscription-router-component.md) ini. Konfigurasi ini menentukan topik di mana komponen ini menerbitkan tanggapan. ------ #### [ Legacy subscription router v2.1.x ] ``` { "subscriptions": { "aws-greengrass-modbus": { "id": "aws-greengrass-modbus", "source": "component:aws.greengrass.Modbus", "subject": "modbus/adapter/response", "target": "cloud" } } } ``` ------ #### [ Legacy subscription router v2.0.x ] ``` { "subscriptions": { "aws-greengrass-modbus": { "id": "aws-greengrass-modbus", "source": "arn:aws:lambda:region:aws:function:aws-greengrass-modbus:version", "subject": "modbus/adapter/response", "target": "cloud" } } } ``` + Ganti *region* dengan Wilayah AWS yang Anda gunakan. + Ganti *version* dengan versi fungsi Lambda yang dijalankan komponen ini. Untuk menemukan versi fungsi Lambda, Anda harus melihat resep untuk versi komponen ini yang ingin Anda deploy. Buka halaman detail komponen ini di [konsol AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) tersebut, dan cari pasangan nilai kunci **Fungsi Lambda**. Pasangan kunci-nilai ini berisi nama dan versi fungsi Lambda. **penting** Anda harus memperbarui versi fungsi Lambda pada router langganan warisan setiap kali Anda men-deploy komponen ini. Hal ini memastikan bahwa Anda menggunakan versi fungsi Lambda yang benar untuk versi komponen yang Anda deploy. ------ Untuk informasi selengkapnya, lihat [Buat deployment](create-deployments.md). + Adaptor protokol Modbus-RTU didukung untuk berjalan di VPC. ## 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](#modbus-rtu-protocol-adapter-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.4 and 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 dan 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.8 and 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 dan 2.1.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | >=1.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | >=1.0.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. **catatan** Konfigurasi default komponen ini meliputi parameter fungsi Lambda. Kami sarankan Anda mengedit hanya parameter berikut untuk mengonfigurasi komponen ini pada perangkat Anda. ------ #### [ v2.1.x ] `lambdaParams` Sebuah objek yang berisi parameter untuk fungsi Lambda komponen ini. Objek ini berisi informasi berikut: `EnvironmentVariables` Sebuah objek yang berisi parameter fungsi Lambda ini. Objek ini berisi informasi berikut: `ModbusLocalPort` Jalur absolut ke port serial Modbus fisik pada perangkat inti, seperti`/dev/ttyS2`. Untuk menjalankan komponen ini dalam wadah, Anda harus mendefinisikan jalur ini sebagai perangkat sistem (in`containerParams.devices`) yang dapat diakses komponen. Komponen berjalan dalam kontainer secara default. Komponen ini harus memiliki read/write akses ke perangkat. `ModbusBaudRate` (Opsional) Nilai string yang menentukan baud rate untuk komunikasi serial dengan perangkat Modbus TCP lokal. Default: `9600` `ModbusByteSize` (Opsional) Nilai string yang menentukan ukuran byte dalam komunikasi serial dengan perangkat Modbus TCP lokal. Pilih`5`,`6`,`7`, atau `8` bit. Default: `8` `ModbusParity` (Opsional) Mode paritas yang digunakan untuk memverifikasi integritas data dalam komunikasi serial dengan perangkat Modbus TCP lokal. + `E`— Verifikasi integritas data dengan paritas yang merata. + `O`— Verifikasi integritas data dengan paritas ganjil. + `N`— Jangan memverifikasi integritas data. Default: `N` `ModbusStopBits` (Opsional) Nilai string yang menentukan jumlah bit yang menunjukkan akhir byte dalam komunikasi serial dengan perangkat Modbus TCP lokal. Default: `1` `containerMode` (Opsional) Mode kontainerisasi untuk komponen ini. Pilih dari salah satu pilihan berikut: + `GreengrassContainer`— Komponen berjalan di lingkungan runtime yang terisolasi di dalam AWS IoT Greengrass wadah. Jika Anda menentukan opsi ini, Anda harus menentukan perangkat sistem (in`containerParams.devices`) untuk memberikan akses wadah ke perangkat Modbus. + `NoContainer` – Komponen tersebut tidak berjalan di lingkungan waktu aktif terisolasi. Default: `GreengrassContainer` `containerParams` (Opsional) Sebuah objek yang berisi parameter kontainer untuk komponen ini. Komponen menggunakan parameter ini jika Anda menentukan `GreengrassContainer` untuk `containerMode`. Objek ini berisi informasi berikut: `memorySize` (Opsional) Jumlah memori (dalam kilobyte) yang akan dialokasikan ke komponen. Defaultnya 512 MB (525.312 KB). `devices` (Opsional) Sebuah objek yang menentukan perangkat sistem yang dapat diakses oleh komponen dalam kontainer. Untuk menjalankan komponen ini dalam sebuah kontainer, Anda harus menentukan perangkat sistem yang Anda konfigurasi di variabel lingkungan `ModbusLocalPort`. Objek ini berisi informasi berikut: `0` - Ini adalah indeks himpunan sebagai string. Objek yang berisi informasi berikut: `path` Jalur ke perangkat sistem pada perangkat inti. Ini harus memiliki nilai yang sama dengan nilai yang Anda konfigurasi untuk `ModbusLocalPort`. `permission` (Opsional) Izin untuk mengakses perangkat sistem dari kontainer. Nilai ini harus`rw`, yang menentukan bahwa komponen memiliki read/write akses ke perangkat sistem. Default: `rw` `addGroupOwner` (Opsional) Apakah akan menambahkan grup sistem atau tidak yang akan menjalankan komponen sebagai pemilik perangkat sistem. Default: `true` `pubsubTopics` (Opsional) Sebuah objek yang berisi topik di mana komponen berlangganan untuk menerima pesan. Anda dapat menentukan setiap topik dan apakah komponen berlangganan topik MQTT dari AWS IoT Core atau topik lokal. publish/subscribe Objek ini berisi informasi berikut: `0` - Ini adalah indeks himpunan sebagai string. Objek yang berisi informasi berikut: `type` (Opsional) Jenis publish/subscribe pesan yang digunakan komponen ini untuk berlangganan pesan. Pilih dari salah satu pilihan berikut: + `PUB_SUB` — Berlangganan pesan publish/subscribe lokal. Jika Anda memilih opsi ini, topik tidak dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). + `IOT_CORE`— Berlangganan pesan AWS IoT Core MQTT. Jika Anda memilih opsi ini, topik dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). Default: `PUB_SUB` `topic` (Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan `IotCore` untuk `type`, Anda dapat menggunakan wildcard MQTT (`+` dan `#`) dalam topik ini. **Example Contoh: Pembaruan gabungan konfigurasi (mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "ModbusLocalPort": "/dev/ttyS2" } }, "containerMode": "GreengrassContainer", "containerParams": { "devices": { "0": { "path": "/dev/ttyS2", "permission": "rw", "addGroupOwner": true } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (tidak ada mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "ModbusLocalPort": "/dev/ttyS2" } }, "containerMode": "NoContainer" } ``` ------ #### [ v2.0.x ] `lambdaParams` Sebuah objek yang berisi parameter untuk fungsi Lambda komponen ini. Objek ini berisi informasi berikut: `EnvironmentVariables` Sebuah objek yang berisi parameter fungsi Lambda ini. Objek ini berisi informasi berikut: `ModbusLocalPort` Jalur absolut ke port serial Modbus fisik pada perangkat inti, seperti`/dev/ttyS2`. Untuk menjalankan komponen ini dalam wadah, Anda harus mendefinisikan jalur ini sebagai perangkat sistem (in`containerParams.devices`) yang dapat diakses komponen. Komponen berjalan dalam kontainer secara default. Komponen ini harus memiliki read/write akses ke perangkat. `containerMode` (Opsional) Mode kontainerisasi untuk komponen ini. Pilih dari salah satu pilihan berikut: + `GreengrassContainer`— Komponen berjalan di lingkungan runtime yang terisolasi di dalam AWS IoT Greengrass wadah. Jika Anda menentukan opsi ini, Anda harus menentukan perangkat sistem (in`containerParams.devices`) untuk memberikan akses wadah ke perangkat Modbus. + `NoContainer` – Komponen tersebut tidak berjalan di lingkungan waktu aktif terisolasi. Default: `GreengrassContainer` `containerParams` (Opsional) Sebuah objek yang berisi parameter kontainer untuk komponen ini. Komponen menggunakan parameter ini jika Anda menentukan `GreengrassContainer` untuk `containerMode`. Objek ini berisi informasi berikut: `memorySize` (Opsional) Jumlah memori (dalam kilobyte) yang akan dialokasikan ke komponen. Defaultnya 512 MB (525.312 KB). `devices` (Opsional) Sebuah objek yang menentukan perangkat sistem yang dapat diakses oleh komponen dalam kontainer. Untuk menjalankan komponen ini dalam sebuah kontainer, Anda harus menentukan perangkat sistem yang Anda konfigurasi di variabel lingkungan `ModbusLocalPort`. Objek ini berisi informasi berikut: `0` - Ini adalah indeks himpunan sebagai string. Objek yang berisi informasi berikut: `path` Jalur ke perangkat sistem pada perangkat inti. Ini harus memiliki nilai yang sama dengan nilai yang Anda konfigurasi untuk `ModbusLocalPort`. `permission` (Opsional) Izin untuk mengakses perangkat sistem dari kontainer. Nilai ini harus`rw`, yang menentukan bahwa komponen memiliki read/write akses ke perangkat sistem. Default: `rw` `addGroupOwner` (Opsional) Apakah akan menambahkan grup sistem atau tidak yang akan menjalankan komponen sebagai pemilik perangkat sistem. Default: `true` `pubsubTopics` (Opsional) Sebuah objek yang berisi topik di mana komponen berlangganan untuk menerima pesan. Anda dapat menentukan setiap topik dan apakah komponen berlangganan topik MQTT dari AWS IoT Core atau topik lokal. publish/subscribe Objek ini berisi informasi berikut: `0` - Ini adalah indeks himpunan sebagai string. Objek yang berisi informasi berikut: `type` (Opsional) Jenis publish/subscribe pesan yang digunakan komponen ini untuk berlangganan pesan. Pilih dari salah satu pilihan berikut: + `PUB_SUB` — Berlangganan pesan publish/subscribe lokal. Jika Anda memilih opsi ini, topik tidak dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). + `IOT_CORE`— Berlangganan pesan AWS IoT Core MQTT. Jika Anda memilih opsi ini, topik dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). Default: `PUB_SUB` `topic` (Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan `IotCore` untuk `type`, Anda dapat menggunakan wildcard MQTT (`+` dan `#`) dalam topik ini. **Example Contoh: Pembaruan gabungan konfigurasi (mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "ModbusLocalPort": "/dev/ttyS2" } }, "containerMode": "GreengrassContainer", "containerParams": { "devices": { "0": { "path": "/dev/ttyS2", "permission": "rw", "addGroupOwner": true } } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi (tidak ada mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "ModbusLocalPort": "/dev/ttyS2" } }, "containerMode": "NoContainer" } ``` ------ ## Data input Komponen ini menerima parameter permintaan Modbus RTU pada topik berikut dan mengirimkan permintaan Modbus RTU ke perangkat. Secara default, komponen ini berlangganan publish/subscribe pesan lokal. Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). **Topik default (publish/subscribe lokal):** `modbus/adapter/request` Pesan menerima properti berikut. Pesan input harus dalam format JSON. `request` Parameter untuk permintaan Modbus RTU yang akan dikirim. Bentuk pesan permintaan tergantung pada jenis Modbus RTU permintaan yang diwakilinya. Properti berikut diperlukan untuk semua permintaan. Jenis: `object` yang berisi informasi berikut: `operation` Nama operasi yang akan dijalankan. Sebagai contoh, tentukan `ReadCoilsRequest` untuk membaca kumparan pada perangkat Modbus RTU. Untuk informasi lebih lanjut tentang operasi tulis, lihat [Permintaan dan tanggapan Modbus RTU](#modbus-rtu-protocol-adapter-component-requests-responses). Tipe: `string` `device` Perangkat target permintaan. Nilai ini harus berupa bilangan bulat antara `0` dan `247`. Tipe: `integer` Parameter lain yang akan tercakup dalam permintaan tergantung pada operasi. Komponen ini menangani [pemeriksaan redundansi siklik (CRC)](https://en.wikipedia.org/wiki/Cyclic_redundancy_check) untuk memverifikasi permintaan data untuk Anda. Jika permintaan Anda mencakup properti `address`, Anda harus menentukan nilainya sebagai bilangan bulat. Misalnya, `"address": 1`. `id` ID acak untuk permintaan. Gunakan properti ini untuk memetakan permintaan inpun untuk respons output. Ketika Anda menentukan properti ini, komponen menetapkan properti `id` di objek respons untuk nilai ini. Tipe: `string` **Example Contoh input: Baca permintaan kumparan** ``` { "request": { "operation": "ReadCoilsRequest", "device": 1, "address": 1, "count": 1 }, "id": "MyRequest" } ``` ## Data output Komponen ini menerbitkan tanggapan sebagai data output pada topik MQTT berikut secara default. Anda harus menentukan topik ini sebagai `subject` dalam konfigurasi untuk [komponen router langganan warisan](legacy-subscription-router-component.md). Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). **Topik default (AWS IoT Core MQTT):** `modbus/adapter/response` Bentuk pesan respon tergantung pada operasi permintaan dan status respon. Sebagai contoh, lihat [Contoh permintaan dan respons](#modbus-rtu-protocol-adapter-component-examples). Setiap respons mencakup properti berikut: `response` Respons dari perangkat Modbus RTU. Jenis: `object` yang berisi informasi berikut: `status` Status HTTP dari permintaan. Nilai bisa jadi salah satu dari yang berikut: + `Success` — Permintaannya valid, komponen mengirim permintaan ke jaringan Modbus RTU, dan jaringan RTU Modbus mengembalikan respons. + `Exception` — Permintaannya valid, komponen mengirim permintaan ke jaringan Modbus RTU, dan jaringan RTU Modbus mengembalikan pengecualian. Untuk informasi selengkapnya, lihat [Status respons: Pengecualian](#modbus-rtu-protocol-adapter-component-response-exception). + `No Response` — Permintaan tidak valid, dan komponen menangkap kesalahan sebelum mengirim permintaan ke jaringan Modbus RTU. Untuk informasi selengkapnya, lihat [Status respon: Tidak ada respon](#modbus-rtu-protocol-adapter-component-response-noresponse). `operation` Operasi yang diminta komponen. `device` Perangkat tempat komponen mengirim permintaan. `payload` Respons dari perangkat Modbus RTU. Jika `status` adalah `No Response`, objek ini hanya akan berisi properti `error` dengan deskripsi kesalahan (misalnya, `[Input/Output] No Response received from the remote unit`). `id` ID dari permintaan, yang dapat Anda gunakan untuk mengidentifikasi respons yang sesuai dengan yang diminta. **catatan** Sebuah respons untuk operasi write hanyalah pengulangan dari permintaan. Meskipun tanggapan write tidak mencakup informasi yang berarti, ia merupakan praktik yang baik untuk memeriksa status respons untuk melihat apakah permintaan berhasil atau gagal. **Example Contoh output: Berhasil** ``` { "response" : { "status" : "success", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 1, "bits": [1] } }, "id" : "MyRequest" } ``` **Example Contoh output: Gagal** ``` { "response" : { "status" : "fail", "error_message": "Internal Error", "error": "Exception", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 129, "exception_code": 2 } }, "id" : "MyRequest" } ``` Untuk contoh lainnya, lihat [Contoh permintaan dan respons](#modbus-rtu-protocol-adapter-component-examples). ## Permintaan dan tanggapan Modbus RTU Konektor ini menerima parameter permintaan Modbus RTU sebagai [data input](#modbus-rtu-protocol-adapter-component-input-data) dan menerbitkan tanggapan sebagai [data output](#modbus-rtu-protocol-adapter-component-output-data). Operasi umum berikut ini didukung. | Nama operasi dalam permintaan | Kode fungsi dalam respons | | --- | --- | | ReadCoilsRequest | 01 | | ReadDiscreteInputsRequest | 02 | | ReadHoldingRegistersRequest | 03 | | ReadInputRegistersRequest | 04 | | WriteSingleCoilRequest | 05 | | WriteSingleRegisterRequest | 06 | | WriteMultipleCoilsRequest | 15 | | WriteMultipleRegistersRequest | 16 | | MaskWriteRegisterRequest | 22 | | ReadWriteMultipleRegistersRequest | 23 | ### Contoh permintaan dan respons Berikut ini adalah contoh permintaan dan tanggapan untuk operasi yang didukung. Baca kumparan **Contoh permintaan:** ``` { "request": { "operation": "ReadCoilsRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" } ``` **Contoh respons:** ``` { "response": { "status": "success", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 1, "bits": [1] } }, "id" : "TestRequest" } ``` Baca input diskrit **Contoh permintaan:** ``` { "request": { "operation": "ReadDiscreteInputsRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" } ``` **Contoh respons:** ``` { "response": { "status": "success", "device": 1, "operation": "ReadDiscreteInputsRequest", "payload": { "function_code": 2, "bits": [1] } }, "id" : "TestRequest" } ``` Baca register yang memiliki **Contoh permintaan:** ``` { "request": { "operation": "ReadHoldingRegistersRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" } ``` **Contoh respons:** ``` { "response": { "status": "success", "device": 1, "operation": "ReadHoldingRegistersRequest", "payload": { "function_code": 3, "registers": [20,30] } }, "id" : "TestRequest" } ``` Baca register input **Contoh permintaan:** ``` { "request": { "operation": "ReadInputRegistersRequest", "device": 1, "address": 1, "count": 1 }, "id": "TestRequest" } ``` Tulis kumparan tunggal **Contoh permintaan:** ``` { "request": { "operation": "WriteSingleCoilRequest", "device": 1, "address": 1, "value": 1 }, "id": "TestRequest" } ``` **Contoh respons:** ``` { "response": { "status": "success", "device": 1, "operation": "WriteSingleCoilRequest", "payload": { "function_code": 5, "address": 1, "value": true } }, "id" : "TestRequest" } ``` Tulis register tunggal **Contoh permintaan:** ``` { "request": { "operation": "WriteSingleRegisterRequest", "device": 1, "address": 1, "value": 1 }, "id": "TestRequest" } ``` Tulis beberapa kumparan **Contoh permintaan:** ``` { "request": { "operation": "WriteMultipleCoilsRequest", "device": 1, "address": 1, "values": [1,0,0,1] }, "id": "TestRequest" } ``` **Contoh respons:** ``` { "response": { "status": "success", "device": 1, "operation": "WriteMultipleCoilsRequest", "payload": { "function_code": 15, "address": 1, "count": 4 } }, "id" : "TestRequest" } ``` Tulis beberapa register **Contoh permintaan:** ``` { "request": { "operation": "WriteMultipleRegistersRequest", "device": 1, "address": 1, "values": [20,30,10] }, "id": "TestRequest" } ``` **Contoh respons:** ``` { "response": { "status": "success", "device": 1, "operation": "WriteMultipleRegistersRequest", "payload": { "function_code": 23, "address": 1, "count": 3 } }, "id" : "TestRequest" } ``` Register mask write **Contoh permintaan:** ``` { "request": { "operation": "MaskWriteRegisterRequest", "device": 1, "address": 1, "and_mask": 175, "or_mask": 1 }, "id": "TestRequest" } ``` **Contoh respons:** ``` { "response": { "status": "success", "device": 1, "operation": "MaskWriteRegisterRequest", "payload": { "function_code": 22, "and_mask": 0, "or_mask": 8 } }, "id" : "TestRequest" } ``` Baca tulis beberapa register **Contoh permintaan:** ``` { "request": { "operation": "ReadWriteMultipleRegistersRequest", "device": 1, "read_address": 1, "read_count": 2, "write_address": 3, "write_registers": [20,30,40] }, "id": "TestRequest" } ``` **Contoh respons:** ``` { "response": { "status": "success", "device": 1, "operation": "ReadWriteMultipleRegistersRequest", "payload": { "function_code": 23, "registers": [10,20,10,20] } }, "id" : "TestRequest" } ``` Tanggapan meliputi register yang dibaca komponen. ### Status respons: Pengecualian Pengecualian dapat terjadi bila format permintaan valid, tetapi permintaan tersebut tidak berhasil diselesaikan. Dalam kasus ini, respons berisi informasi berikut: + `status` ditetapkan ke `Exception`. + `function_code` sama dengan kode fungsi permintaan \$1 128. + `exception_code` berisi kode pengecualian. Untuk informasi selengkapnya, lihat kode pengecualian Modbus. **Contoh:** ``` { "response": { "status": "fail", "error_message": "Internal Error", "error": "Exception", "device": 1, "operation": "ReadCoilsRequest", "payload": { "function_code": 129, "exception_code": 2 } }, "id": "TestRequest" } ``` ### Status respon: Tidak ada respon Konektor ini melakukan pemeriksaan validasi pada permintaan Modbus. Sebagai contoh, ia memeriksa format yang tidak sah dan kolom yang hilang. Jika validasi gagal, konektor tidak akan mengirim permintaan. Sebaliknya, ia mengembalikan respon yang berisi informasi berikut: + `status` ditetapkan ke `No Response`. + `error` berisi alasan kesalahan. + `error_message` berisi pesan kesalahan. **Contoh:** ``` { "response": { "status": "fail", "error_message": "Invalid address field. Expected , got ", "error": "No Response", "device": 1, "operation": "ReadCoilsRequest", "payload": { "error": "Invalid address field. Expected Expected , got " } }, "id": "TestRequest" } ``` Jika permintaan menargetkan perangkat yang tidak ada atau jika jaringan Modbus RTU tidak berfungsi, Anda mungkin mendapatkan `ModbusIOException`, yang menggunakan format No Response. ``` { "response": { "status": "fail", "error_message": "[Input/Output] No Response received from the remote unit", "error": "No Response", "device": 1, "operation": "ReadCoilsRequest", "payload": { "error": "[Input/Output] No Response received from the remote unit" } }, "id": "TestRequest" } ``` ## File log lokal Komponen ini menggunakan file log berikut. ``` /greengrass/v2/logs/aws.greengrass.Modbus.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.Modbus.log ``` ## Lisensi Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut: + [pymodbus](https://github.com/riptideio/pymodbus/blob/master/README.rst)Lisensi BSD + [pyserial](https://github.com/pyserial/pyserial)Lisensi BSD Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/modbus-rtu-protocol-adapter-component.html) | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.2 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.1 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/modbus-rtu-protocol-adapter-component.html) | | 2.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.6 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.5 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.4 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.3 | Versi awal. | # Jembatan MQTT Komponen jembatan MQTT (`aws.greengrass.clientdevices.mqtt.Bridge`) menyampaikan pesan MQTT antara perangkat klien, penerbitan/berlangganan Greengrass lokal, dan. AWS IoT Core Anda dapat menggunakan komponen ini untuk bertindak atas pesan MQTT dari perangkat klien komponen kustom dan mensinkronisasi perangkat klien dengan AWS Cloud. **catatan** Perangkat klien adalah perangkat IoT lokal yang terhubung ke perangkat inti Greengrass untuk mengirim pesan MQTT dan data yang akan diproses. Untuk informasi selengkapnya, lihat [Berinteraksilah dengan perangkat IoT lokal](interact-with-local-iot-devices.md). Anda dapat menggunakan komponen ini untuk merelai pesan antara broker-broker pesan berikut: + MQTT lokal - Broker MQTT lokal menangani pesan antara perangkat klien dan perangkat inti. + Lokal publish/subscribe — Broker pesan Greengrass lokal menangani pesan antar komponen pada perangkat inti. Untuk informasi lebih lanjut tentang cara berinteraksi dengan pesan-pesan ini dalam komponen Greengrass, lihat.[Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). + AWS IoT Core — Pialang AWS IoT Core MQTT menangani pesan antara perangkat dan tujuan IoT. AWS Cloud Untuk informasi lebih lanjut tentang cara berinteraksi dengan pesan-pesan ini dalam komponen Greengrass, lihat.[Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). **Topics** + [Versi](#mqtt-bridge-component-versions) + [Tipe](#mqtt-bridge-component-type) + [Sistem operasi](#mqtt-bridge-component-os-support) + [Persyaratan](#mqtt-bridge-component-requirements) + [Dependensi](#mqtt-bridge-component-dependencies) + [Konfigurasi](#mqtt-bridge-component-configuration) + [Berkas log lokal](#mqtt-bridge-component-log-file) + [Changelog](#mqtt-bridge-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Jika Anda mengonfigurasi komponen broker MQTT perangkat inti untuk menggunakan port selain port default 8883, Anda harus menggunakan jembatan MQTT v2.1.0 atau yang lebih baru. Konfigurasikan untuk terhubung di port tempat broker beroperasi. + Komponen jembatan MQTT didukung untuk berjalan di VPC. ## 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](#mqtt-bridge-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.3.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Keras | ------ #### [ 2.3.0 and 2.3.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.0 dan 2.3.1 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Keras | ------ #### [ 2.2.5 and 2.2.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.5 dan 2.2.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Keras | ------ #### [ 2.2.3 and 2.2.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.3 dan 2.2.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Keras | ------ #### [ 2.2.0 – 2.2.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.0 hingga 2.2.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.3.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.0.0 <2.2.0 | Keras | ------ #### [ 2.0.0 to 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.0 hingga 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.0.0 <2.1.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ 2.3.0 – 2.3.2 ] `mqttTopicMapping` Pemetaan topik yang ingin Anda jembatani. Komponen ini berlangganan pesan pada topik sumber dan menerbitkan pesan yang diterimanya ke topik tujuan. Setiap pemetaan topik menentukan topik, jenis sumber, dan jenis tujuan. Objek ini berisi informasi berikut: `topicMappingNameKey` Nama pemetaan topik ini. Ganti *topicMappingNameKey* dengan nama yang membantu Anda mengidentifikasi pemetaan topik ini. Objek ini berisi informasi berikut: `topic` Filter topik atau topik untuk menjembatani antara broker sumber dan target. Anda dapat menggunakan wildcard topik `+` dan `#` MQTT untuk menyampaikan pesan pada semua topik yang cocok dengan filter topik. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. [Untuk menggunakan wildcard topik MQTT dengan broker `Pubsub` sumber, Anda harus menggunakan v2.6.0 atau yang lebih baru dari komponen inti Greengrass.](greengrass-nucleus-component.md) `targetTopicPrefix` Awalan untuk ditambahkan ke topik target saat komponen ini menyampaikan pesan. `source` Broker pesan sumber. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. `target` Target broker pesan. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. mqtt5 RouteOptions (Opsional) Menyediakan opsi untuk mengonfigurasi pemetaan topik untuk menjembatani pesan dari topik sumber ke topik tujuan. Objek ini berisi informasi berikut: *mqtt5RouteOptionsNameKey* Nama opsi rute untuk pemetaan topik. Ganti *mqtt5RouteOptionsNameKey* dengan pencocokan yang *topicMappingNameKey* ditentukan di `mqttTopicMapping` lapangan. Objek ini berisi informasi berikut: NoLokal (Opsional) Saat diaktifkan, bridge tidak meneruskan pesan pada topik yang dipublikasikan oleh bridge itu sendiri. Gunakan ini untuk mencegah loop, sebagai berikut: ``` { "mqtt5RouteOptions": { "toIoTCore": { "noLocal": true } }, "mqttTopicMapping": { "toIoTCore": { "topic": "device", "source": "LocalMqtt", "target": "IotCore" }, "toLocal": { "topic": "device", "source": "IotCore", "target": "LocalMqtt" } } } ``` `noLocal`hanya didukung untuk rute di mana `source` berada`LocalMqtt`. Bawaan: salah retainAsPublished (Opsional) Saat diaktifkan, pesan yang diteruskan oleh jembatan memiliki `retain` tanda yang sama dengan pesan yang dipublikasikan ke broker untuk rute tersebut. `retainAsPublished`hanya didukung untuk rute di mana `source` berada`LocalMqtt`. Bawaan: salah mqtt (Opsional) Pengaturan protokol MQTT untuk berkomunikasi dengan broker lokal. versi (Opsional) Versi protokol MQTT yang digunakan oleh jembatan untuk berkomunikasi dengan broker lokal. Harus sama dengan versi MQTT yang dipilih dalam konfigurasi nukleus. Pilih dari yang berikut ini: + `mqtt3` + `mqtt5` Anda harus menggunakan broker MQTT ketika `target` bidang `source` atau `mqttTopicMapping` objek diatur ke. `LocalMqtt` Jika Anda memilih `mqtt5` opsi, Anda harus menggunakan[Pialang MQTT 5 (EMQX)](mqtt-broker-emqx-component.md). Default: `mqtt3` ackTimeoutSeconds (Opsional) Interval waktu untuk menunggu paket PUBACK, SUBACK, atau UNSUBACK sebelum gagal operasi. Default: 60 connAckTimeoutNona (Opsional) Interval waktu untuk menunggu paket CONNACK sebelum mematikan koneksi. Default: 20000 (20 detik) pingTimeoutMs (Opsional) Jumlah waktu dalam milidetik jembatan menunggu untuk menerima pesan PINGACK dari broker lokal. Jika menunggu melebihi batas waktu, jembatan ditutup kemudian membuka kembali koneksi MQTT. Nilai ini harus kurang dari`keepAliveTimeoutSeconds`. Default: 30000 (30 detik) keepAliveTimeoutDetik (Opsional) Jumlah waktu dalam detik antara setiap pesan PING yang dikirim jembatan untuk menjaga koneksi MQTT tetap hidup. Nilai ini harus lebih besar dari`pingTimeoutMs`. Default: 60 maxReconnectDelayNona (Opsional) Jumlah waktu maksimum dalam hitungan detik agar MQTT terhubung kembali. Default: 30000 (30 detik) minReconnectDelayNona (Opsional) Jumlah waktu minimum dalam hitungan detik agar MQTT terhubung kembali. ReceiveMaximum (Opsional) Jumlah maksimum paket QoS1 yang tidak diakui yang dapat dikirim oleh jembatan. Default: 100 maximumPacketSize Jumlah maksimum byte yang akan diterima klien untuk paket MQTT. Default: null (Tidak ada batas) sessionExpiryInterval (Opsional) Jumlah waktu dalam hitungan detik Anda dapat meminta sesi berlangsung antara jembatan dan broker lokal. Default: 4294967295 (sesi tidak pernah kedaluwarsa) `brokerUri` (Opsional) URI dari broker MQTT lokal. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883. Gunakan format berikut, dan ganti *port* dengan port tempat broker MQTT beroperasi:. `ssl://localhost:port` Default: `ssl://localhost:8883` startupTimeoutSeconds (Opsional) Maksimum waktu dalam hitungan detik untuk memulai komponen. Status komponen berubah menjadi `BROKEN` jika melebihi batas waktu ini. Default: `120` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh pembaruan konfigurasi berikut menentukan hal berikut: + Relay pesan dari perangkat klien ke AWS IoT Core topik yang cocok dengan filter `clients/+/hello/world` topik. + Relay pesan dari perangkat klien ke lokal publish/subscribe pada `clients/+/detections` topik yang cocok dengan filter topik, dan tambahkan `events/input/` awalan ke topik target. Topik target yang dihasilkan cocok dengan filter `events/input/clients/+/detections` topik. + Relay pesan dari perangkat klien ke AWS IoT Core topik yang cocok dengan filter `clients/+/status` topik, dan tambahkan `$aws/rules/StatusUpdateRule/` awalan ke topik target. Contoh ini menyampaikan pesan-pesan ini langsung ke [AWS IoT aturan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) bernama `StatusUpdateRule` untuk mengurangi biaya menggunakan [Basic Ingest](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html). ``` { "mqttTopicMapping": { "ClientDeviceHelloWorld": { "topic": "clients/+/hello/world", "source": "LocalMqtt", "target": "IotCore" }, "ClientDeviceEvents": { "topic": "clients/+/detections", "targetTopicPrefix": "events/input/", "source": "LocalMqtt", "target": "Pubsub" }, "ClientDeviceCloudStatusUpdate": { "topic": "clients/+/status", "targetTopicPrefix": "$aws/rules/StatusUpdateRule/", "source": "LocalMqtt", "target": "IotCore" } } } ``` **Example Contoh: Mengkonfigurasi MQTT 5** Contoh konfigurasi berikut memperbarui yang berikut ini: + Memungkinkan jembatan untuk menggunakan protokol MQTT 5 dengan broker lokal. + Mengonfigurasi penyimpanan MQTT sebagai setelan yang dipublikasikan untuk pemetaan topik. `ClientDeviceHelloWorld` ``` { "mqttTopicMapping": { "ClientDeviceHelloWorld": { "topic": "clients/+/hello/world", "source": "LocalMqtt", "target": "IotCore" } }, "mqtt5RouteOptions": { "ClientDeviceHelloWorld": { "retainAsPublished": true } }, "mqtt": { "version": "mqtt5" } } ``` ------ #### [ 2.2.6 ] `mqttTopicMapping` Pemetaan topik yang ingin Anda jembatani. Komponen ini berlangganan pesan pada topik sumber dan menerbitkan pesan yang diterimanya ke topik tujuan. Setiap pemetaan topik menentukan topik, jenis sumber, dan jenis tujuan. Objek ini berisi informasi berikut: `topicMappingNameKey` Nama pemetaan topik ini. Ganti *topicMappingNameKey* dengan nama yang membantu Anda mengidentifikasi pemetaan topik ini. Objek ini berisi informasi berikut: `topic` Filter topik atau topik untuk menjembatani antara broker sumber dan target. Anda dapat menggunakan wildcard topik `+` dan `#` MQTT untuk menyampaikan pesan pada semua topik yang cocok dengan filter topik. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. [Untuk menggunakan wildcard topik MQTT dengan broker `Pubsub` sumber, Anda harus menggunakan v2.6.0 atau yang lebih baru dari komponen inti Greengrass.](greengrass-nucleus-component.md) `targetTopicPrefix` Awalan untuk ditambahkan ke topik target saat komponen ini menyampaikan pesan. `source` Broker pesan sumber. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. `target` Target broker pesan. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. `brokerUri` (Opsional) URI dari broker MQTT lokal. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883. Gunakan format berikut, dan ganti *port* dengan port tempat broker MQTT beroperasi:. `ssl://localhost:port` Default: `ssl://localhost:8883` startupTimeoutSeconds (Opsional) Maksimum waktu dalam hitungan detik untuk memulai komponen. Status komponen berubah menjadi `BROKEN` jika melebihi batas waktu ini. Default: `120` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh pembaruan konfigurasi berikut menentukan hal berikut: + Relay pesan dari perangkat klien ke AWS IoT Core topik yang cocok dengan filter `clients/+/hello/world` topik. + Relay pesan dari perangkat klien ke lokal publish/subscribe pada `clients/+/detections` topik yang cocok dengan filter topik, dan tambahkan `events/input/` awalan ke topik target. Topik target yang dihasilkan cocok dengan filter `events/input/clients/+/detections` topik. + Relay pesan dari perangkat klien ke AWS IoT Core topik yang cocok dengan filter `clients/+/status` topik, dan tambahkan `$aws/rules/StatusUpdateRule/` awalan ke topik target. Contoh ini menyampaikan pesan-pesan ini langsung ke [AWS IoT aturan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) bernama `StatusUpdateRule` untuk mengurangi biaya menggunakan [Basic Ingest](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html). ``` { "mqttTopicMapping": { "ClientDeviceHelloWorld": { "topic": "clients/+/hello/world", "source": "LocalMqtt", "target": "IotCore" }, "ClientDeviceEvents": { "topic": "clients/+/detections", "targetTopicPrefix": "events/input/", "source": "LocalMqtt", "target": "Pubsub" }, "ClientDeviceCloudStatusUpdate": { "topic": "clients/+/status", "targetTopicPrefix": "$aws/rules/StatusUpdateRule/", "source": "LocalMqtt", "target": "IotCore" } } } ``` ------ #### [ 2.2.0 - 2.2.5 ] `mqttTopicMapping` Pemetaan topik yang ingin Anda jembatani. Komponen ini berlangganan pesan pada topik sumber dan menerbitkan pesan yang diterimanya ke topik tujuan. Setiap pemetaan topik menentukan topik, jenis sumber, dan jenis tujuan. Objek ini berisi informasi berikut: `topicMappingNameKey` Nama pemetaan topik ini. Ganti *topicMappingNameKey* dengan nama yang membantu Anda mengidentifikasi pemetaan topik ini. Objek ini berisi informasi berikut: `topic` Filter topik atau topik untuk menjembatani antara broker sumber dan target. Anda dapat menggunakan wildcard topik `+` dan `#` MQTT untuk menyampaikan pesan pada semua topik yang cocok dengan filter topik. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. [Untuk menggunakan wildcard topik MQTT dengan broker `Pubsub` sumber, Anda harus menggunakan v2.6.0 atau yang lebih baru dari komponen inti Greengrass.](greengrass-nucleus-component.md) `targetTopicPrefix` Awalan untuk ditambahkan ke topik target saat komponen ini menyampaikan pesan. `source` Broker pesan sumber. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. `target` Target broker pesan. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. `brokerUri` (Opsional) URI dari broker MQTT lokal. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883. Gunakan format berikut, dan ganti *port* dengan port tempat broker MQTT beroperasi:. `ssl://localhost:port` Default: `ssl://localhost:8883` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh pembaruan konfigurasi berikut menentukan hal berikut: + Relay pesan dari perangkat klien ke AWS IoT Core topik yang cocok dengan filter `clients/+/hello/world` topik. + Relay pesan dari perangkat klien ke lokal publish/subscribe pada `clients/+/detections` topik yang cocok dengan filter topik, dan tambahkan `events/input/` awalan ke topik target. Topik target yang dihasilkan cocok dengan filter `events/input/clients/+/detections` topik. + Relay pesan dari perangkat klien ke AWS IoT Core topik yang cocok dengan filter `clients/+/status` topik, dan tambahkan `$aws/rules/StatusUpdateRule/` awalan ke topik target. Contoh ini menyampaikan pesan-pesan ini langsung ke [AWS IoT aturan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) bernama `StatusUpdateRule` untuk mengurangi biaya menggunakan [Basic Ingest](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html). ``` { "mqttTopicMapping": { "ClientDeviceHelloWorld": { "topic": "clients/+/hello/world", "source": "LocalMqtt", "target": "IotCore" }, "ClientDeviceEvents": { "topic": "clients/+/detections", "targetTopicPrefix": "events/input/", "source": "LocalMqtt", "target": "Pubsub" }, "ClientDeviceCloudStatusUpdate": { "topic": "clients/+/status", "targetTopicPrefix": "$aws/rules/StatusUpdateRule/", "source": "LocalMqtt", "target": "IotCore" } } } ``` ------ #### [ 2.1.x ] `mqttTopicMapping` Pemetaan topik yang ingin Anda jembatani. Komponen ini berlangganan pesan pada topik sumber dan menerbitkan pesan yang diterimanya ke topik tujuan. Setiap pemetaan topik menentukan topik, jenis sumber, dan jenis tujuan. Objek ini berisi informasi berikut: `topicMappingNameKey` Nama pemetaan topik ini. Ganti *topicMappingNameKey* dengan nama yang membantu Anda mengidentifikasi pemetaan topik ini. Objek ini berisi informasi berikut: `topic` Filter topik atau topik untuk menjembatani antara broker sumber dan target. Jika Anda menentukan broker sumber `LocalMqtt` atau `IotCore`, Anda dapat menggunakan wildcard topik MQTT `+` dan `#` untuk merelai pesan pada semua topik yang cocok dengan filter topik. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. `source` Broker pesan sumber. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. `target` Target broker pesan. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. `brokerUri` (Opsional) URI dari broker MQTT lokal. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883. Gunakan format berikut, dan ganti *port* dengan port tempat broker MQTT beroperasi:. `ssl://localhost:port` Default: `ssl://localhost:8883` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh pembaruan konfigurasi berikut menentukan untuk menyampaikan pesan dari perangkat klien ke AWS IoT Core topik `clients/MyClientDevice1/hello/world` dan `clients/MyClientDevice2/hello/world` topik. ``` { "mqttTopicMapping": { "ClientDevice1HelloWorld": { "topic": "clients/MyClientDevice1/hello/world", "source": "LocalMqtt", "target": "IotCore" }, "ClientDevice2HelloWorld": { "topic": "clients/MyClientDevice2/hello/world", "source": "LocalMqtt", "target": "IotCore" } } } ``` ------ #### [ 2.0.x ] `mqttTopicMapping` Pemetaan topik yang ingin Anda jembatani. Komponen ini berlangganan pesan pada topik sumber dan menerbitkan pesan yang diterimanya ke topik tujuan. Setiap pemetaan topik menentukan topik, jenis sumber, dan jenis tujuan. Objek ini berisi informasi berikut: `topicMappingNameKey` Nama pemetaan topik ini. Ganti *topicMappingNameKey* dengan nama yang membantu Anda mengidentifikasi pemetaan topik ini. Objek ini berisi informasi berikut: `topic` Filter topik atau topik untuk menjembatani antara broker sumber dan target. Jika Anda menentukan broker sumber `LocalMqtt` atau `IotCore`, Anda dapat menggunakan wildcard topik MQTT `+` dan `#` untuk merelai pesan pada semua topik yang cocok dengan filter topik. Untuk informasi selengkapnya, lihat [topik MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) di *Panduan Developer AWS IoT Core *. `source` Broker pesan sumber. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. `target` Target broker pesan. Pilih dari salah satu pilihan berikut: + `LocalMqtt` – Broker MQTT lokal tempat perangkat klien berkomunikasi. + `Pubsub`— Pialang pesan Greengrass publish/subscribe lokal. + `IotCore`— Pialang AWS IoT Core pesan MQTT. **catatan** Jembatan MQTT menggunakan QoS 1 untuk mempublikasikan dan berlangganan AWS IoT Core, bahkan ketika perangkat klien menggunakan QoS 0 untuk mempublikasikan dan berlangganan broker MQTT lokal. Akibatnya, Anda mungkin mengamati latensi tambahan saat menyampaikan pesan MQTT dari perangkat klien di broker MQTT lokal ke. AWS IoT Core Untuk informasi lebih lanjut tentang konfigurasi MQTT pada perangkat inti, lihat [Konfigurasikan pengaturan batas waktu dan cache MQTT](configure-greengrass-core-v2.md#configure-mqtt). `source` dan `target` harus berbeda. **Example Contoh: Pembaruan gabungan konfigurasi** Contoh pembaruan konfigurasi berikut menentukan untuk menyampaikan pesan dari perangkat klien ke AWS IoT Core topik `clients/MyClientDevice1/hello/world` dan `clients/MyClientDevice2/hello/world` topik. ``` { "mqttTopicMapping": { "ClientDevice1HelloWorld": { "topic": "clients/MyClientDevice1/hello/world", "source": "LocalMqtt", "target": "IotCore" }, "ClientDevice2HelloWorld": { "topic": "clients/MyClientDevice2/hello/world", "source": "LocalMqtt", "target": "IotCore" } } } ``` ------ ## Berkas log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.3.2 | Versi diperbarui untuk [perangkat klien autentikasi](client-device-auth-component.md) versi 2.5.0 rilis. | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-bridge-component.html) | | 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-bridge-component.html) | | 2.2.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-bridge-component.html) | | 2.2.5 | Versi diperbarui untuk [perangkat klien autentikasi](client-device-auth-component.md) versi 2.4.0 rilis. | | 2.2.4 | Versi diperbarui untuk [Greengrass perangkat klien](client-device-auth-component.md) auth versi 2.3.0 rilis. | | 2.2.3 | Versi ini berisi perbaikan bug dan perbaikan. | | 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-bridge-component.html) | | 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-bridge-component.html) | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-bridge-component.html) | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-bridge-component.html) | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-bridge-component.html) | | 2.0.1 | Versi ini mencakup perbaikan bug dan peningkatan. | | 2.0.0 | Versi awal. | # MQTT 3.1.1 broker (Moquette) Komponen broker Moquette MQTT (`aws.greengrass.clientdevices.mqtt.Moquette`) menangani pesan MQTT antara perangkat klien dan perangkat inti Greengrass. Komponen ini menyediakan versi modifikasi [broker Moquette MQTT](https://github.com/moquette-io/moquette). Sebarkan broker MQTT ini untuk menjalankan broker MQTT ringan. Untuk informasi lebih lanjut tentang cara memilih broker MQTT, lihat. [Pilih broker MQTT](choose-local-mqtt-broker.md) Broker ini mengimplementasikan protokol MQTT 3.1.1. Ini termasuk dukungan untuk QoS 0, QoS 1, pesan yang dipertahankan QoS 2, pesan kehendak terakhir, dan sesi persisten. **catatan** Perangkat klien adalah perangkat IoT lokal yang terhubung ke perangkat inti Greengrass untuk mengirim pesan MQTT dan data yang akan diproses. Untuk informasi selengkapnya, lihat [Berinteraksilah dengan perangkat IoT lokal](interact-with-local-iot-devices.md). **Topics** + [Versi](#mqtt-broker-moquette-component-versions) + [Tipe](#mqtt-broker-moquette-component-type) + [Sistem operasi](#mqtt-broker-moquette-component-os-support) + [Persyaratan](#mqtt-broker-moquette-component-requirements) + [Dependensi](#mqtt-broker-moquette-component-dependencies) + [Konfigurasi](#mqtt-broker-moquette-component-configuration) + [Berkas log lokal](#mqtt-broker-moquette-component-log-file) + [Changelog](#mqtt-broker-moquette-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## 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 harus dapat menerima koneksi pada port tempat broker MQTT beroperasi. Komponen ini menjalankan broker MQTT pada port 8883 secara default. Anda dapat menentukan port yang berbeda saat Anda mengonfigurasi komponen ini. Jika Anda menentukan port yang berbeda, dan Anda menggunakan [komponen jembatan MQTT untuk menyampaikan pesan MQTT](mqtt-bridge-component.md) ke broker lain, Anda harus menggunakan MQTT bridge v2.1.0 atau yang lebih baru. Konfigurasikan untuk menggunakan port tempat broker MQTT beroperasi. Jika Anda menentukan port yang berbeda, dan Anda menggunakan [komponen detektor IP](ip-detector-component.md) untuk mengelola titik akhir broker MQTT, Anda harus menggunakan detektor IP v2.1.0 atau yang lebih baru. Konfigurasikan untuk melaporkan port tempat broker MQTT beroperasi. + Komponen broker Moquette MQTT didukung untuk berjalan di VPC. ## 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](#mqtt-broker-moquette-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.3.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Keras | ------ #### [ 2.3.2 – 2.3.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.2 hingga 2.3.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Keras | ------ #### [ 2.3.0 and 2.3.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.0 dan 2.3.1 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Keras | ------ #### [ 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.3.0 | Keras | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.0.0 <2.2.0 | Keras | ------ #### [ 2.0.0 - 2.0.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.0 hingga 2.0.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.0.0 <2.1.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `moquette` (Opsional) KOnfigurasi [broker Moquette MQTT](https://github.com/moquette-io/moquette) yang akan digunakan. Anda dapat mengonfigurasi subset dari opsi konfigurasi Moqeutte dalam komponen ini. Untuk informasi selengkapnya, lihat komentar sebaris pada [file konfigurasi Moquette](https://github.com/moquette-io/moquette/blob/main/distribution/src/main/resources/moquette.conf). Objek ini berisi informasi berikut: `ssl_port` (Opsional) Port tempat broker MQTT beroperasi. Jika Anda menentukan port yang berbeda, dan Anda menggunakan [komponen jembatan MQTT untuk menyampaikan pesan MQTT](mqtt-bridge-component.md) ke broker lain, Anda harus menggunakan MQTT bridge v2.1.0 atau yang lebih baru. Konfigurasikan untuk menggunakan port tempat broker MQTT beroperasi. Jika Anda menentukan port yang berbeda, dan Anda menggunakan [komponen detektor IP](ip-detector-component.md) untuk mengelola titik akhir broker MQTT, Anda harus menggunakan detektor IP v2.1.0 atau yang lebih baru. Konfigurasikan untuk melaporkan port tempat broker MQTT beroperasi. Default: `8883` `host` (Opsional) Antarmuka tempat broker MQTT terikat. Misalnya, Anda dapat mengubah parameter ini sehingga broker MQTT terikat hanya pada jaringan lokal tertentu. Default: `0.0.0.0` (terikat pada semua antarmuka jaringan) startupTimeoutSeconds (Opsional) Maksimum waktu dalam hitungan detik untuk memulai komponen. Status komponen berubah menjadi `BROKEN` jika melebihi batas waktu ini. Default: `120` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk mengoperasikan broker MQTT pada port 443. ``` { "moquette": { "ssl_port": "443" } } ``` ## Berkas log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.3.7 | Versi diperbarui untuk [perangkat klien autentikasi](client-device-auth-component.md) versi 2.5.0 rilis. | | 2.3.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.2 | Versi diperbarui untuk [perangkat klien autentikasi](client-device-auth-component.md) versi 2.4.0 rilis. | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.0 | Menambahkan dukungan untuk rantai sertifikat. | | 2.2.0 | Versi diperbarui untuk [perangkat klien autentikasi](client-device-auth-component.md) versi 2.2.0 rilis. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.0.1 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.0 | Versi awal. | # Pialang MQTT 5 (EMQX) Komponen broker EMQX MQTT (`aws.greengrass.clientdevices.mqtt.EMQX`) menangani pesan MQTT antara perangkat klien dan perangkat inti Greengrass. Komponen ini menyediakan versi modifikasi dari broker [EMQX MQTT 5.0](https://www.emqx.com/en/mqtt/mqtt5). Menyebarkan broker MQTT ini untuk menggunakan fitur MQTT 5 dalam komunikasi antara perangkat klien dan perangkat inti. Untuk informasi lebih lanjut tentang cara memilih broker MQTT, lihat. [Pilih broker MQTT](choose-local-mqtt-broker.md) Broker ini mengimplementasikan protokol MQTT 5.0. Ini mencakup dukungan untuk interval kedaluwarsa sesi dan pesan, properti pengguna, langganan bersama, alias topik, dan banyak lagi. MQTT 5 kompatibel dengan MQTT 3.1.1, jadi jika Anda menjalankan broker [Moquette MQTT 3.1.1, Anda dapat menggantinya dengan broker EMQX MQTT](mqtt-broker-moquette-component.md) 5, dan perangkat klien dapat terus terhubung dan beroperasi seperti biasa. **catatan** Perangkat klien adalah perangkat IoT lokal yang terhubung ke perangkat inti Greengrass untuk mengirim pesan MQTT dan data yang akan diproses. Untuk informasi selengkapnya, lihat [Berinteraksilah dengan perangkat IoT lokal](interact-with-local-iot-devices.md). **Topics** + [Versi](#mqtt-broker-emqx-component-versions) + [Tipe](#mqtt-broker-emqx-component-type) + [Sistem operasi](#mqtt-broker-emqx-component-os-support) + [Persyaratan](#mqtt-broker-emqx-component-requirements) + [Dependensi](#mqtt-broker-emqx-component-dependencies) + [Konfigurasi](#mqtt-broker-emqx-component-configuration) + [File log lokal](#mqtt-broker-emqx-component-log-file) + [Lisensi](#mqtt-broker-emqx-component-licenses) + [Changelog](#mqtt-broker-emqx-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.0.x + 1.2.x + 1.1.x + 1.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## 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 harus dapat menerima koneksi pada port tempat broker MQTT beroperasi. Komponen ini menjalankan broker MQTT pada port 8883 secara default. Anda dapat menentukan port yang berbeda saat Anda mengonfigurasi komponen ini. Jika Anda menentukan port yang berbeda, dan Anda menggunakan [komponen jembatan MQTT untuk menyampaikan pesan MQTT](mqtt-bridge-component.md) ke broker lain, Anda harus menggunakan MQTT bridge v2.1.0 atau yang lebih baru. Konfigurasikan untuk menggunakan port tempat broker MQTT beroperasi. Jika Anda menentukan port yang berbeda, dan Anda menggunakan [komponen detektor IP](ip-detector-component.md) untuk mengelola titik akhir broker MQTT, Anda harus menggunakan detektor IP v2.1.0 atau yang lebih baru. Konfigurasikan untuk melaporkan port tempat broker MQTT beroperasi. + Pada perangkat inti Linux, Docker diinstal dan dikonfigurasi pada perangkat inti: + [Docker Engine](https://docs.docker.com/engine/) 1.9.1 atau yang lebih baru diinstal pada perangkat inti Greengrass. Versi 20.10 adalah versi terbaru yang diverifikasi untuk bekerja dengan perangkat lunak AWS IoT Greengrass Core. Anda harus menginstal Docker langsung pada perangkat inti sebelum Anda menyebarkan komponen yang menjalankan kontainer Docker. + Daemon Docker dimulai dan berjalan pada perangkat inti sebelum Anda men-deploy komponen ini. + Pengguna sistem yang menjalankan komponen ini harus memiliki izin root atau administrator. Atau, Anda dapat menjalankan komponen ini sebagai pengguna sistem dalam `docker` grup dan mengonfigurasi `requiresPrivileges` opsi komponen ini `false` untuk menjalankan broker EQMX MQTT tanpa hak istimewa. + Komponen broker EMQX MQTT didukung untuk berjalan di VPC. + Komponen broker EMQX MQTT tidak didukung di platform. `armv7` ## 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](#mqtt-broker-emqx-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.0.2 – 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.2 dan 2.0.3 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Lunak | ------ #### [ 2.0.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Keras | ------ #### [ 2.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Keras | ------ #### [ 1.2.2 – 1.2.3 ] Tabel berikut mencantumkan dependensi untuk versi 1.2.2 hingga 1.2.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Keras | ------ #### [ 1.2.0 and 1.2.1 ] Tabel berikut mencantumkan dependensi untuk versi 1.2.0 dan 1.2.1 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Keras | ------ #### [ 1.0.0 and 1.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.0 dan 1.1.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Autentikasi perangkat klien](client-device-auth-component.md) | >=2.2.0 <2.3.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi ------ #### [ 2.0.0 - 2.0.3 ] Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. **penting** Jika Anda menggunakan versi 2 dari komponen broker MQTT 5 (EMQX), Anda harus memperbarui file konfigurasi Anda. File konfigurasi versi 1 tidak berfungsi dengan versi 2. EMQXconfig (Opsional) Konfigurasi [broker EMQX MQTT](https://www.emqx.io/docs/en/v5.1/configuration/configuration.html) untuk digunakan. Anda dapat mengatur opsi konfigurasi EMQX dalam komponen ini. Saat Anda menggunakan broker EMQX, Greengrass menggunakan konfigurasi default. Konfigurasi ini digunakan kecuali Anda memodifikasinya menggunakan bidang ini. Memodifikasi pengaturan konfigurasi berikut menyebabkan komponen broker EMQX dimulai ulang. Perubahan konfigurasi lainnya berlaku tanpa memulai ulang komponen. + `emqxConfig/cluster` + `emqxConfig/node` + `emqxConfig/rpc` `aws.greengrass.clientdevices.mqtt.EMQX`memungkinkan Anda mengonfigurasi opsi yang sensitif terhadap keamanan. Ini termasuk pengaturan TLS, otentikasi, dan penyedia otorisasi. Kami merekomendasikan konfigurasi default yang menggunakan otentikasi TLS timbal balik dan penyedia autentikasi perangkat klien Greengrass. **Example Contoh: Konfigurasi default** Contoh berikut menunjukkan default yang ditetapkan untuk broker MQTT 5 (EMQX). Anda dapat mengganti pengaturan ini menggunakan pengaturan `emqxConfig` konfigurasi. ``` { "authorization": { "no_match": "deny", "sources": [] }, "node": { "cookie": "" }, "listeners": { "ssl": { "default": { "ssl_options": { "keyfile": "{work:path}\\data\\key.pem", "certfile": "{work:path}\\data\\cert.pem", "cacertfile": null, "verify": "verify_peer", "versions": ["tlsv1.3", "tlsv1.2"], "fail_if_no_peer_cert": true } } }, "tcp": { "default": { "enabled": false } }, "ws": { "default": { "enabled": false } }, "wss": { "default": { "enabled": false } } }, "plugins": { "states": [{"name_vsn": "gg-1.0.0", "enable": true}], "install_dir": "plugins" } } ``` AuthMode (Opsional) Menetapkan penyedia otorisasi untuk broker. Dapat menjadi salah satu dari nilai berikut: + `enabled`— (Default) Gunakan penyedia otentikasi dan otorisasi Greengrass. + `bypass_on_failure`— Gunakan penyedia otentikasi Greengrass, lalu gunakan penyedia otentikasi yang tersisa di rantai penyedia EMQX jika Greengrass menolak otentikasi atau otorisasi. + `bypass`— Penyedia Greengrass dinonaktifkan. Otentikasi dan otorisasi ditangani oleh rantai penyedia EMQX. `requiresPrivilege` (Opsional) Pada perangkat inti Linux, Anda dapat menentukan untuk menjalankan broker EMQX MQTT tanpa hak root atau administrator. Jika Anda mengatur opsi ini`false`, pengguna sistem yang menjalankan komponen ini harus menjadi anggota `docker` grup. Default: `true` `startupTimeoutSeconds` (Opsional) Maksimum waktu dalam hitungan detik untuk memulai broker EMQX MQTT. Status komponen berubah menjadi `BROKEN` jika melebihi batas waktu ini. Default: `90` `ipcTimeoutSeconds` (Opsional) Maksimum waktu dalam hitungan detik bagi komponen untuk menunggu inti Greengrass merespons permintaan komunikasi antarproses (IPC). Tingkatkan angka ini jika komponen ini melaporkan kesalahan batas waktu saat memeriksa apakah perangkat klien diotorisasi. Default: `5` `crtLogLevel` (Opsional) Tingkat log untuk pustaka AWS Common Runtime (CRT). Default ke level log broker EMQX MQTT (in). `log.level` `emqx` `restartIdentifier` (Opsional) Konfigurasikan opsi ini untuk memulai ulang broker EMQX MQTT. Ketika nilai konfigurasi ini berubah, komponen ini memulai ulang broker MQTT. Anda dapat menggunakan opsi ini untuk memaksa perangkat klien memutuskan sambungan. `dockerOptions` (Opsional) Konfigurasikan opsi ini hanya pada sistem operasi Linux untuk menambahkan parameter ke baris perintah Docker. Misalnya, untuk memetakan port tambahan, gunakan parameter `-p` Docker: ``` "-p 1883:1883" ``` **Example Contoh: Memperbarui file konfigurasi v1.x ke v2.x** Contoh berikut menunjukkan perubahan yang diperlukan untuk memperbarui file konfigurasi v1.x ke versi 2.x. File konfigurasi versi 1.x: ``` { "emqx": { "listener.ssl.external": "443", "listener.ssl.external.max_connections": "1024000", "listener.ssl.external.max_conn_rate": "500", "listener.ssl.external.rate_limit": "50KB,5s", "listener.ssl.external.handshake_timeout": "15s", "log.level": "warning" }, "mergeConfigurationFiles": { "etc/plugins/aws_greengrass_emqx_auth.conf": "auth_mode=enabled\n use_greengrass_managed_certificates=true\n" } } ``` File konfigurasi setara untuk v2: ``` { "emqxConfig": { "listeners": { "ssl": { "default": { "bind": "8883", "max_connections": "1024000", "max_conn_rate": "500", "ssl_options": { "handshake_timeout": "15s" } } } }, "log": { "console": { "enable": true, "level": "warning" } } }, "authMode": "enabled" } ``` Tidak ada yang setara dengan entri `listener.ssl.external.rate_limit` konfigurasi. Opsi `use_greengrass_managed_certificates` konfigurasi telah dihapus. **Example Contoh: Tetapkan port baru untuk broker** Contoh berikut mengubah port tempat broker MQTT beroperasi dari default 8883 ke port 1234. Jika Anda menggunakan Linux, sertakan `dockerOptions` bidangnya. ``` { "emqxConfig": { "listeners": { "ssl": { "default": { "bind": 1234 } } } }, "dockerOptions": "-p 1234:1234" } ``` **Example Contoh: Sesuaikan level log broker MQTT** Contoh berikut mengubah level log broker MQTT menjadi. `debug` Anda dapat memilih dari level log berikut: + `debug` + `info` + `notice` + `warning` + `error` + `critical` + `alert` + `emergency` Tingkat log default adalah`warning`. ``` { "emqxConfig": { "log": { "console": { "level": "debug" } } } } ``` **Example Contoh: Aktifkan dasbor EMQX** Contoh berikut memungkinkan dashboard EMQX sehingga Anda dapat memantau dan mengelola broker Anda. Jika Anda menggunakan Linux, sertakan `dockerOptions` bidangnya. ``` { "emqxConfig": { "dashboard": { "listeners": { "http": { "bind": 18083 } } } }, "dockerOptions": "-p 18083:18083" } ``` ------ #### [ 1.0.0 - 1.2.2 ] Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `emqx` (Opsional) Konfigurasi [broker EMQX MQTT](https://www.emqx.io/docs/en/v4.4/configuration/configuration.html) untuk digunakan. Anda dapat mengonfigurasi subset opsi konfigurasi EMQX dalam komponen ini. Objek ini berisi informasi berikut: `listener.ssl.external` (Opsional) Port tempat broker MQTT beroperasi. Jika Anda menentukan port yang berbeda, dan Anda menggunakan [komponen jembatan MQTT untuk menyampaikan pesan MQTT](mqtt-bridge-component.md) ke broker lain, Anda harus menggunakan MQTT bridge v2.1.0 atau yang lebih baru. Konfigurasikan untuk menggunakan port tempat broker MQTT beroperasi. Jika Anda menentukan port yang berbeda, dan Anda menggunakan [komponen detektor IP](ip-detector-component.md) untuk mengelola titik akhir broker MQTT, Anda harus menggunakan detektor IP v2.1.0 atau yang lebih baru. Konfigurasikan untuk melaporkan port tempat broker MQTT beroperasi. Default: `8883` `listener.ssl.external.max_connections` (Opsional) Jumlah maksimum koneksi bersamaan yang didukung oleh broker MQTT. Default: `1024000` `listener.ssl.external.max_conn_rate` (Opsional) Jumlah maksimum koneksi baru per detik yang dapat diterima broker MQTT. Default: `500` `listener.ssl.external.rate_limit` (Opsional) Batas bandwidth untuk semua koneksi ke broker MQTT. Tentukan bandwidth dan durasi untuk bandwidth yang dipisahkan oleh koma (`,`) dalam format berikut:`bandwidth,duration`. Misalnya, Anda dapat menentukan `50KB,5s` untuk membatasi broker MQTT hingga 50 kilobyte (KB) data setiap 5 detik. `listener.ssl.external.handshake_timeout` (Opsional) Jumlah waktu yang menunggu broker MQTT untuk menyelesaikan otentikasi koneksi baru. Default: `15s` `mqtt.max_packet_size` (Opsional) Ukuran maksimum pesan MQTT. Default: `268435455` (256 MB dikurangi 1) `log.level` (Opsional) Tingkat log untuk broker MQTT. Pilih dari salah satu pilihan berikut: + `debug` + `info` + `notice` + `warning` + `error` + `critical` + `alert` + `emergency` Tingkat log default adalah`warning`. `requiresPrivilege` (Opsional) Pada perangkat inti Linux, Anda dapat menentukan untuk menjalankan broker EMQX MQTT tanpa hak root atau administrator. Jika Anda mengatur opsi ini`false`, pengguna sistem yang menjalankan komponen ini harus menjadi anggota `docker` grup. Default: `true` `startupTimeoutSeconds` (Opsional) Maksimum waktu dalam hitungan detik untuk memulai broker EMQX MQTT. Status komponen berubah menjadi `BROKEN` jika melebihi batas waktu ini. Default: `90` `ipcTimeoutSeconds` (Opsional) Maksimum waktu dalam hitungan detik bagi komponen untuk menunggu inti Greengrass merespons permintaan komunikasi antarproses (IPC). Tingkatkan angka ini jika komponen ini melaporkan kesalahan batas waktu saat memeriksa apakah perangkat klien diotorisasi. Default: `5` `crtLogLevel` (Opsional) Tingkat log untuk pustaka AWS Common Runtime (CRT). Default ke level log broker EMQX MQTT (in). `log.level` `emqx` `restartIdentifier` (Opsional) Konfigurasikan opsi ini untuk memulai ulang broker EMQX MQTT. Ketika nilai konfigurasi ini berubah, komponen ini memulai ulang broker MQTT. Anda dapat menggunakan opsi ini untuk memaksa perangkat klien memutuskan sambungan. `dockerOptions` (Opsional) Konfigurasikan opsi ini hanya pada sistem operasi Linux untuk menambahkan parameter ke baris perintah Docker. Misalnya, untuk memetakan port tambahan, gunakan parameter `-p` Docker: ``` "-p 1883:1883" ``` `mergeConfigurationFiles` (Opsional) Konfigurasikan opsi ini untuk menambah atau mengganti default dalam file konfigurasi EMQX yang ditentukan. Untuk informasi tentang file konfigurasi dan formatnya, lihat [Konfigurasi dalam Dokumentasi](https://www.emqx.io/docs/en/v4.4/configuration/configuration.html) *EMQX 4.0*. Nilai yang Anda tentukan ditambahkan ke file konfigurasi. Contoh berikut memperbarui `etc/emqx.conf` file. ``` "mergeConfigurationFiles": { "etc/emqx.conf": "broker.sys_interval=30s\nbroker.sys_heartbeat=10s" }, ``` Selain file konfigurasi yang didukung oleh EMQX, Greengrass mendukung file yang mengkonfigurasi plugin autentikasi Greengrass untuk EMQX yang disebut. `etc/plugins/aws_greengrass_emqx_auth.conf` Ada dua opsi yang didukung, `auth_mode` dan`use_greengrass_managed_certificates`. Untuk menggunakan penyedia autentikasi lain, setel `auth_mode` opsi ke salah satu dari berikut ini: + `enabled`— (Default) Gunakan penyedia otentikasi dan otorisasi Greengrass. + `bypass_on_failure`— Gunakan penyedia otentikasi Greengrass, lalu gunakan penyedia otentikasi yang tersisa di rantai penyedia EMQX jika Greengrass menolak otentikasi atau otorisasi. + `bypass`— Penyedia Greengrass dinonaktifkan. Otentikasi dan otorisasi kemudian ditangani oleh rantai penyedia EMQX. Jika ya`true`, opsi ini menunjukkan bahwa Greengrass mengelola sertifikat TLS broker. `use_greengrass_managed_certificates` Jika`false`, ini menunjukkan bahwa Anda memberikan sertifikat melalui sumber lain. Contoh berikut memperbarui default dalam file konfigurasi. `etc/plugins/aws_greengrass_emqx_auth.conf` ``` "mergeConfigurationFiles": { "etc/plugins/aws_greengrass_emqx_auth.conf": "auth_mode=enabled\n use_greengrass_managed_certificates=true\n" }, ``` `aws.greengrass.clientdevices.mqtt.EMQX`memungkinkan Anda mengonfigurasi opsi yang sensitif terhadap keamanan. Ini termasuk pengaturan TLS, otentikasi, dan penyedia otorisasi. Konfigurasi yang disarankan adalah konfigurasi default yang menggunakan otentikasi TLS timbal balik dan penyedia Auth Perangkat Klien Greengrass. `replaceConfigurationFiles` (Opsional) Konfigurasikan opsi ini untuk mengganti file konfigurasi EMQX yang ditentukan. Nilai yang Anda tentukan menggantikan seluruh file konfigurasi yang ada. Anda tidak dapat menentukan `etc/emqx.conf` file di bagian ini. Anda harus menggunakan `mergeConfigurationFile` untuk memodifikasi`etc/emqx.conf`. **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk mengoperasikan broker MQTT pada port 443. ``` { "emqx": { "listener.ssl.external": "443", "listener.ssl.external.max_connections": "1024000", "listener.ssl.external.max_conn_rate": "500", "listener.ssl.external.rate_limit": "50KB,5s", "listener.ssl.external.handshake_timeout": "15s", "log.level": "warning" }, "requiresPrivilege": "true", "startupTimeoutSeconds": "90", "ipcTimeoutSeconds": "5" } ``` ------ ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.clientdevices.mqtt.EMQX.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.clientdevices.mqtt.EMQX.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.clientdevices.mqtt.EMQX.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.clientdevices.mqtt.EMQX.log -Tail 10 -Wait ``` ------ ## Lisensi Pada sistem operasi Windows, perangkat lunak ini menyertakan kode yang didistribusikan di bawah [Persyaratan Lisensi Perangkat Lunak Microsoft - Komunitas Microsoft Visual Studio 2022](https://visualstudio.microsoft.com/license-terms/vs2022-ga-community). Dengan mengunduh perangkat lunak ini, Anda menyetujui ketentuan lisensi kode tersebut. Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. ------ #### [ v2.x ] | **Versi** | **Perubahan** | | --- | --- | | 2.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) | | 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) | | 2.0.1 | Versi diperbarui untuk [perangkat klien autentikasi](client-device-auth-component.md) versi 2.5.0 rilis. | | 2.0.0 | Versi broker MQTT 5 (EMQX) ini mengharapkan parameter konfigurasi yang berbeda dari versi 1.x. Jika Anda menggunakan konfigurasi non-default untuk versi 1.x, Anda harus memperbarui konfigurasi komponen untuk 2.x. Untuk informasi selengkapnya, lihat [Konfigurasi](#mqtt-broker-emqx-component-configuration). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) | ------ #### [ v1.x ] | **Versi** | **Perubahan** | | --- | --- | | 1.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) | | 1.2.2 | Versi diperbarui untuk [perangkat klien autentikasi](client-device-auth-component.md) versi 2.4.0 rilis. | | 1.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) | | 1.2.0 | Menambahkan dukungan untuk rantai sertifikat. | | 1.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) | | 1.0.1 | Memperbaiki masalah selama jabat tangan TLS yang mengakibatkan beberapa klien MQTT gagal terhubung. | | 1.0.0 | Versi awal. | ------ # Pemancar telemetri nukleus Komponen pemancar telemetri nukleus (`aws.greengrass.telemetry.NucleusEmitter`) mengumpulkan data telemetri kesehatan sistem dan menerbitkannya terus menerus ke topik lokal dan topik MQTT. AWS IoT Core Komponen ini memungkinkan Anda untuk mengumpulkan telemetri sistem real-time pada perangkat inti Greengrass Anda. Untuk informasi tentang agen telemetri Greengrass yang menerbitkan data telemetri sistem ke Amazon, lihat. EventBridge [Kumpulkan data telemetri kesehatan sistem dari perangkat inti AWS IoT Greengrass](telemetry.md) Secara default, komponen pemancar telemetri nukleus menerbitkan data telemetri setiap 60 detik ke topik lokal berikut. publish/subscribe ``` $local/greengrass/telemetry ``` Komponen pemancar telemetri nukleus tidak dipublikasikan ke topik AWS IoT Core MQTT secara default. Anda dapat mengonfigurasi komponen ini untuk dipublikasikan ke topik AWS IoT Core MQTT saat Anda menerapkannya. [Penggunaan topik MQTT untuk mempublikasikan data ke tunduk pada AWS Cloud harga.AWS IoT Core](https://aws.amazon.com/iot-core/pricing/) AWS IoT Greengrass menyediakan beberapa [komponen komunitas](greengrass-software-catalog.md) untuk membantu Anda menganalisis dan memvisualisasikan data telemetri secara lokal di perangkat inti Anda menggunakan InfluxDB dan Grafana. Komponen-komponen ini menggunakan data telemetri dari komponen pemancar nukleus. Untuk informasi selengkapnya, lihat README untuk komponen penerbit [InfluxDB](https://github.com/awslabs/aws-greengrass-labs-telemetry-influxdbpublisher). **Topics** + [Versi](#nucleus-emitter-component-versions) + [Tipe](#nucleus-emitter-component-type) + [Sistem operasi](#nucleus-emitter-component-os-support) + [Dependensi](#nucleus-emitter-component-dependencies) + [Konfigurasi](#nucleus-emitter-component-configuration) + [Data output](#nucleus-emitter-component-output-data) + [Penggunaan](#nucleus-emitter-component-usage) + [File log lokal](#nucleus-emitter-component-log-file) + [Changelog](#nucleus-emitter-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 1.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## 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](#nucleus-emitter-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 1.0.12 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.17.0 | Lunak | ------ #### [ 1.0.11 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.16.0 | Keras | ------ #### [ 1.0.10 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.15.0 | Keras | ------ #### [ 1.0.9 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.14.0 | Keras | ------ #### [ 1.0.8 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.8 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.13.0 | Keras | ------ #### [ 1.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.12.0 | Keras | ------ #### [ 1.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.11.0 | Keras | ------ #### [ 1.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.10.0 | Keras | ------ #### [ 1.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.9.0 | Keras | ------ #### [ 1.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.8.0 | Keras | ------ #### [ 1.0.2 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.7.0 | Keras | ------ #### [ 1.0.1 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.6.0 | Keras | ------ #### [ 1.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.5.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `pubSubPublish` (Opsional) Mendefinisikan apakah akan mempublikasikan data telemetri ke topik. `$local/greengrass/telemetry` Nilai yang didukung adalah `true` dan `false`. Default: `true` `mqttTopic` (Opsional) Topik AWS IoT Core MQTT tempat komponen ini menerbitkan data telemetri. Tetapkan nilai ini ke topik AWS IoT Core MQTT yang ingin Anda publikasikan data telemetri. Ketika nilai ini kosong, pemancar nukleus tidak mempublikasikan data telemetri ke. AWS Cloud [Penggunaan topik MQTT untuk mempublikasikan data ke tunduk pada AWS Cloud harga.AWS IoT Core](https://aws.amazon.com/iot-core/pricing/) Default: `""` `telemetryPublishIntervalMs` (Opsional) Jumlah waktu (dalam milidetik) di mana komponen menerbitkan data telemetri. Jika Anda menetapkan nilai ini lebih rendah dari nilai minimum yang didukung, komponen menggunakan nilai minimum sebagai gantinya. Interval publikasi yang lebih rendah menghasilkan penggunaan CPU yang lebih tinggi pada perangkat inti Anda. Kami menyarankan Anda memulai dengan interval publikasi default dan menyesuaikannya berdasarkan penggunaan CPU perangkat Anda. Minimal: `500` Default: `60000` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh berikut menunjukkan pemutakhiran gabungan konfigurasi sampel yang memungkinkan penerbitan data telemetri setiap 5 detik ke `$local/greengrass/telemetry` topik dan topik MQTT. `greengrass/myTelemetry` AWS IoT Core ``` { "pubSubPublish": "true", "mqttTopic": "greengrass/myTelemetry", "telemetryPublishIntervalMs": 5000 } ``` ## Data output Komponen ini menerbitkan metrik telemetri sebagai array JSON pada topik berikut. **Topik lokal:** `$local/greengrass/telemetry` Anda dapat memilih untuk juga mempublikasikan metrik telemetri ke topik MQTT. AWS IoT Core *Untuk informasi selengkapnya tentang topik, lihat topik [MQTT di Panduan Pengembang](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).AWS IoT Core * **Example Contoh data** ``` [ { "A": "Average", "N": "CpuUsage", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Percent", "V": 26.21981271562346 }, { "A": "Count", "N": "TotalNumberOfFDs", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Count", "V": 7316 }, { "A": "Count", "N": "SystemMemUsage", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Megabytes", "V": 10098 }, { "A": "Count", "N": "NumberOfComponentsStarting", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsInstalled", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsStateless", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsStopping", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsBroken", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsRunning", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 7 }, { "A": "Count", "N": "NumberOfComponentsErrored", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsNew", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsFinished", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 2 } ] ``` Array keluaran berisi daftar metrik yang memiliki properti berikut: `A` Jenis agregasi untuk metrik. Untuk `CpuUsage` metrik, properti ini disetel ke `Average` karena nilai metrik yang dipublikasikan adalah jumlah penggunaan CPU rata-rata sejak peristiwa publikasi terakhir. Untuk semua metrik lainnya, pemancar nukleus tidak menggabungkan nilai metrik, dan properti ini disetel ke. `Count` `N` Nama metrik. `NS` Namespace metrik. `TS` Stempel waktu kapan data dikumpulkan. `U` Unit nilai metrik. `V` Nilai metrik. Pemancar nukleus menerbitkan metrik berikut: | Nama | Deskripsi | | --- | --- | | **Sistem** | | `SystemMemUsage` | Jumlah memori yang saat ini digunakan oleh semua aplikasi pada perangkat inti Greengrass, termasuk sistem operasi. | | `CpuUsage` | Jumlah CPU yang saat ini digunakan oleh semua aplikasi pada perangkat inti Greengrass, termasuk sistem operasi. | | `TotalNumberOfFDs` | Bilangan deskriptor file yang disimpan oleh sistem operasi perangkat inti Greengrass. Satu file deskriptor secara unik mengidentifikasi satu file yang terbuka. | | **Inti Greengrass** | | `NumberOfComponentsRunning` | Jumlah komponen yang berjalan pada perangkat inti Greengrass. | | `NumberOfComponentsErrored` | Jumlah komponen yang berada dalam keadaan kesalahan pada perangkat inti Greengrass. | | `NumberOfComponentsInstalled` | Jumlah komponen yang diinstal pada perangkat inti Greengrass. | | `NumberOfComponentsStarting` | Jumlah komponen yang dimulai pada perangkat inti Greengrass. | | `NumberOfComponentsNew` | Jumlah komponen yang baru pada perangkat inti Greengrass. | | `NumberOfComponentsStopping` | Jumlah komponen yang berhenti pada perangkat inti Greengrass. | | `NumberOfComponentsFinished` | Jumlah komponen yang diselesaikan pada perangkat inti Greengrass. | | `NumberOfComponentsBroken` | Jumlah komponen yang rusak pada perangkat inti Greengrass. | | `NumberOfComponentsStateless` | Jumlah komponen yang stateless pada perangkat inti Greengrass. | ## Penggunaan Untuk menggunakan data telemetri kesehatan sistem, Anda dapat membuat komponen khusus yang berlangganan topik tempat pemancar inti menerbitkan data telemetri, dan bereaksi terhadap data tersebut sesuai kebutuhan. Karena komponen pemancar inti menyediakan opsi untuk mempublikasikan data telemetri ke topik lokal, Anda dapat berlangganan topik tersebut, dan menggunakan data yang dipublikasikan untuk bertindak secara lokal di perangkat inti Anda. Perangkat inti kemudian dapat bereaksi terhadap data telemetri bahkan ketika konektivitas terbatas ke cloud. Misalnya, Anda dapat mengonfigurasi komponen yang mendengarkan `$local/greengrass/telemetry` topik untuk data telemetri dan mengirim data ke komponen pengelola aliran untuk mengalirkan data Anda ke file. AWS Cloud Untuk informasi lebih lanjut tentang membuat komponen seperti itu, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md) dan[Buat komponen kustom yang menggunakan stream manager](use-stream-manager-in-custom-components.md). ## File log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 1.0.13 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 1.0.12 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 1.0.11 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 1.0.10 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 1.0.9 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 1.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 1.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 1.0.6 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 1.0.5 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 1.0.4 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 1.0.3 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 1.0.2 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 1.0.1 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 1.0.0 | Versi awal. | # Penyedia PKCS \$111 Komponen penyedia PKCS \$111 (`aws.greengrass.crypto.Pkcs11Provider`) memungkinkan Anda mengonfigurasi perangkat lunak AWS IoT Greengrass Core untuk menggunakan modul keamanan perangkat keras (HSM) melalui antarmuka [PKCS](https://en.wikipedia.org/wiki/PKCS_11) \$111. Komponen ini memungkinkan Anda menyimpan file sertifikat dan kunci pribadi dengan aman sehingga tidak terekspos atau digandakan dalam perangkat lunak. Untuk informasi selengkapnya, lihat [Integrasi keamanan perangkat keras](hardware-security.md). **catatan** Komponen ini diperlukan untuk inti [Greengrass saja](greengrass-nucleus-component.md). [Greengrass nucleus](greengrass-nucleus-lite-component.md) lite v2.5.0 dan yang lebih baru menyertakan dukungan PKCS \$111 bawaan dan tidak memerlukan komponen ini. Untuk informasi selengkapnya, lihat [dukungan PKCS \$111 di repositori](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/PKCS11_SUPPORT.md) AWS IoT Greengrass nucleus lite GitHub . Untuk menyediakan perangkat inti Greengrass yang menyimpan sertifikat dan kunci privatnya di HSM, Anda harus menentukan komponen ini sebagai plugin penyediaan saat Anda menginstal perangkat lunak Core. AWS IoT Greengrass Untuk informasi selengkapnya, lihat [Instal perangkat lunak AWS IoT Greengrass Core dengan penyediaan sumber daya manual](manual-installation.md). AWS IoT Greengrass menyediakan komponen ini sebagai file JAR yang dapat Anda unduh untuk ditentukan sebagai plugin penyediaan selama instalasi. Anda dapat mengunduh versi terbaru dari file JAR komponen sebagai URL berikut: [https://d2s8p88vqu9w66.cloudfront. net/releases/Pkcs11Provider/aws.greengrass.crypto.pkcs11provider-latest.jar](https://d2s8p88vqu9w66.cloudfront.net/releases/Pkcs11Provider/aws.greengrass.crypto.Pkcs11Provider-latest.jar). **Topics** + [Versi](#pkcs11-provider-component-versions) + [Tipe](#pkcs11-provider-component-type) + [Sistem operasi](#pkcs11-provider-component-os-support) + [Persyaratan](#pkcs11-provider-component-requirements) + [Dependensi](#pkcs11-provider-component-dependencies) + [Konfigurasi](#pkcs11-provider-component-configuration) + [File log lokal](#pkcs11-provider-component-log-file) + [Changelog](#pkcs11-provider-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Modul keamanan perangkat keras yang mendukung skema tanda tangan [PKCS \$11 v1.5](https://tools.ietf.org/html/rfc2313) dan kunci RSA dengan ukuran kunci RSA-2048 (atau lebih besar) atau kunci ECC. **catatan** Untuk menggunakan modul keamanan perangkat keras dengan kunci ECC, Anda harus menggunakan [Greengrass](greengrass-nucleus-component.md) nucleus v2.5.6 atau yang lebih baru. Untuk menggunakan modul keamanan perangkat keras dan [manajer rahasia](secret-manager-component.md), Anda harus menggunakan modul keamanan perangkat keras dengan kunci RSA. + Pustaka penyedia PKCS \$111 yang dapat dimuat oleh perangkat lunak AWS IoT Greengrass Core saat runtime (menggunakan libdl) untuk menjalankan fungsi PKCS \$111. Pustaka penyedia PKCS \$111 harus mengimplementasikan operasi API PKCS \$111 berikut: + `C_Initialize` + `C_Finalize` + `C_GetSlotList` + `C_GetSlotInfo` + `C_GetTokenInfo` + `C_OpenSession` + `C_GetSessionInfo` + `C_CloseSession` + `C_Login` + `C_Logout` + `C_GetAttributeValue` + `C_FindObjectsInit` + `C_FindObjects` + `C_FindObjectsFinal` + `C_DecryptInit` + `C_Decrypt` + `C_DecryptUpdate` + `C_DecryptFinal` + `C_SignInit` + `C_Sign` + `C_SignUpdate` + `C_SignFinal` + `C_GetMechanismList` + `C_GetMechanismInfo` + `C_GetInfo` + `C_GetFunctionList` + Modul perangkat keras harus dapat diatasi dengan label slot, sebagaimana ditentukan di dalam spesifikasi PKCS\$111. + Anda harus menyimpan kunci pribadi dan sertifikat di HSM di slot yang sama, dan mereka harus menggunakan label objek dan ID objek yang sama, jika HSM mendukung objek. IDs + Sertifikat dan kunci pribadi harus dapat diselesaikan dengan label objek. + Kunci pribadi harus memiliki izin berikut: + `sign` + `decrypt` + (Opsional) Untuk menggunakan [komponen manajer rahasia](secret-manager-component.md), Anda harus menggunakan versi 2.1.0 atau yang lebih baru, dan kunci pribadi harus memiliki izin berikut: + `unwrap` + `wrap` + (Opsional) Jika Anda menggunakan TPM2 pustaka dan menjalankan inti Greengrass sebagai layanan, Anda harus menyediakan variabel lingkungan dengan lokasi penyimpanan PKCS \$111. Contoh berikut adalah file layanan systemd dengan variabel lingkungan yang diperlukan: ``` [Unit] Description=Greengrass Core After=network.target [Service] Type=simple PIDFile=/var/run/greengrass.pid Environment=TPM2_PKCS11_STORE=/path/to/store/directory RemainAfterExit=no Restart=on-failure RestartSec=10 ExecStart=/bin/sh /greengrass/v2/alts/current/distro/bin/loader [Install] WantedBy=multi-user.target ``` ## 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](#pkcs11-provider-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.0.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.17.0 | Lunak | ------ #### [ 2.0.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.10 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.16.0 | Lunak | ------ #### [ 2.0.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.15.0 | Lunak | ------ #### [ 2.0.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.14.0 | Lunak | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.13.0 | Lunak | ------ #### [ 2.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.12.0 | Lunak | ------ #### [ 2.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.11.0 | Lunak | ------ #### [ 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.10.0 | Lunak | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.9.0 | Lunak | ------ #### [ 2.0.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.8.0 | Lunak | ------ #### [ 2.0.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.7.0 | Lunak | ------ #### [ 2.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.3 <2.6.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `name` Nama untuk konfigurasi PKCS \$111. `library` Jalur file absolut ke pustaka implementasi PKCS \$111 yang dapat dimuat oleh perangkat lunak AWS IoT Greengrass Core dengan libdl. `slot` ID slot yang berisi kunci pribadi dan sertifikat perangkat. Nilai ini berbeda dari indeks slot atau label slot. `userPin` PIN pengguna yang digunakan untuk mengakses slot. **Example Contoh: Pembaruan gabungan konfigurasi** ``` { "name": "softhsm_pkcs11", "library": "/usr/lib/softhsm/libsofthsm2.so", "slot": 1, "userPin": "1234" } ``` ## File log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.0.12 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.0.11 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.0.10 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.0.9 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.0.6 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.0.5 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.0.4 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.0.3 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.0.2 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.0.1 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.0.0 | Versi awal. | # Secrets manager Komponen secret manager (`aws.greengrass.SecretManager`) men-deploy rahasia dari AWS Secrets Manager ke perangkat inti Greengrass. Gunakan komponen ini untuk secara aman menggunakan kredensial, seperti kata sandi, dalam komponen kustom pada perangkat inti Greengrass Anda. Untuk informasi lebih lanjut tentang Secrets Manager, lihat [Apa Itu AWS Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) di *Panduan Pengguna AWS Secrets Manager *. Untuk mengakses rahasia komponen ini di komponen Greengrass kustom Anda, gunakan operasi di. [GetSecretValue](ipc-secret-manager.md#ipc-operation-getsecretvalue) AWS IoT Device SDK Untuk informasi selengkapnya, lihat [Gunakan AWS IoT Device SDK untuk berkomunikasi dengan inti Greengrass, komponen lain, dan AWS IoT CoreBerkomunikasi dengan inti Greengrass, komponen lain, dan AWS IoT Core](interprocess-communication.md) dan [Ambil nilai-nilai rahasia](ipc-secret-manager.md). Komponen ini mengenkripsi rahasia pada perangkat inti untuk menjaga kredensial dan kata sandi Anda tetap aman sampai Anda perlu menggunakannya. Ini menggunakan kunci pribadi perangkat inti untuk mengenkripsi dan mendekripsi rahasia. **Topics** + [Versi](#secret-manager-component-versions) + [Tipe](#secret-manager-component-type) + [Sistem operasi](#secret-manager-component-os-support) + [Persyaratan](#secret-manager-component-requirements) + [Dependensi](#secret-manager-component-dependencies) + [Konfigurasi](#secret-manager-component-configuration) + [File log lokal](#secret-manager-component-log-file) + [Changelog](#secret-manager-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + [Peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `secretsmanager:GetSecretValue`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:us-east-1:123456789012:secret:MySecret" ] } ] } ``` ------ ``` ``` **catatan** Jika Anda menggunakan AWS Key Management Service kunci yang dikelola pelanggan untuk mengenkripsi rahasia, peran perangkat juga harus mengizinkan tindakan. `kms:Decrypt` Untuk informasi lebih lanjut tentang kebijakan IAM untuk Secrets Manager, lihat hal berikut di *Panduan Pengguna AWS Secrets Manager *: + [Otentikasi dan kontrol akses untuk AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access.html) + [Tindakan, sumber daya, dan kunci konteks yang dapat Anda gunakan dalam kebijakan IAM atau kebijakan rahasia AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/reference_iam-permissions.html) + Komponen kustom harus menentukan kebijakan otorisasi yang memungkinkan `aws.greengrass#GetSecretValue` untuk mendapatkan rahasia yang Anda simpan dengan komponen ini. Dalam kebijakan otorisasi ini, Anda dapat membatasi akses komponen ke rahasia tertentu. Untuk informasi selengkapnya, lihat [otorisasi IPC secret manager](ipc-secret-manager.md#ipc-secret-manager-authorization). + (Opsional) Jika Anda menyimpan kunci pribadi dan sertifikat perangkat inti dalam [modul keamanan perangkat keras](hardware-security.md) (HSM), HSM harus mendukung kunci RSA, kunci pribadi harus memiliki `unwrap` izin, dan kunci publik harus memiliki izin. `wrap` ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `secretsmanager.region.amazonaws.com` | 443 | Ya | Unduh rahasia ke 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](#secret-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.2.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Lunak | ------ #### [ 2.2.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.6 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.16.0 | Lunak | ------ #### [ 2.2.2 – 2.2.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.2 hingga 2.2.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.15.0 | Lunak | ------ #### [ 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.13.0 <2.14.0 | Lunak | ------ #### [ 2.1.7 – 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dan 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.13.0 | Lunak | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.12.0 | Lunak | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Lunak | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Lunak | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.9.0 | Lunak | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.8.0 | Lunak | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.7.0 | Lunak | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Lunak | ------ #### [ 2.0.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 2.0.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 2.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ #### [ 2.0.4 and 2.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 dan 2.0.5 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `periodicRefreshIntervalMin` (opsional) Interval dalam hitungan menit di mana komponen ini menyinkronkan rahasia yang dikonfigurasi pada perangkat inti dengan nilai rahasia terbaru dari AWS Secrets Manager layanan. Jika interval ini tidak dikonfigurasi, manajer rahasia tidak akan menyegarkan rahasia yang dikonfigurasi secara berkala. ``` { "cloudSecrets": [ { "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef" } ], "periodicRefreshIntervalMin" : 60 } ``` `cloudSecrets` Daftar rahasia Secrets Manager yang akan di-deploy ke perangkat inti. Anda dapat menentukan label untuk menentukan versi mana dari setiap rahasia yang akan di-deploy. Jika Anda tidak menentukan versi, komponen ini akan men-deploy versi dengan label penahapan `AWSCURRENT` terlampir. Untuk informasi selengkapnya, lihat [Label penahapan](https://docs.aws.amazon.com/secretsmanager/latest/userguide/terms-concepts.html#term_staging-label) di *Panduan Pengguna AWS Secrets Manager *. Komponen manajer rahasia menyimpan rahasia secara lokal. Jika nilai rahasia berubah di Secrets Manager, komponen ini tidak secara otomatis mengambil nilai baru. Untuk memperbarui salinan lokal, berikan label baru pada rahasia dan konfigurasikan komponen ini untuk mengambil rahasia yang diidentifikasi oleh label baru. Setiap objek berisi informasi berikut: `arn` ARN rahasia yang akan di-deploy. ARN rahasia dapat berupa ARN penuh atau ARN parsi. Kami menyarankan Anda menentukan ARN lengkap daripada ARN sebagian. Untuk informasi lebih lanjut, lihat [Menemukan rahasia dari ARN sebagian](https://docs.aws.amazon.com/secretsmanager/latest/userguide/troubleshoot.html#ARN_secretnamehyphen). Berikut ini adalah contoh ARN lengkap dan ARN sebagian: + ARN penuh: `arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName-abcdef` + ARN sebagian: `arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName` `labels` (Opsional) Daftar label untuk mengidentifikasi versi rahasia yang akan di-deploy ke perangkat inti. Setiap label harus berupa string. **Example Contoh: Pembaruan gabungan konfigurasi** ``` { "cloudSecrets": [ { "arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef" } ] } ``` ## File log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.2.8 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.2.7 | Versi diperbarui untuk Greengrass nucleus versi 2.16.0 rilis. | | 2.2.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.2.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.1.8 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.2 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.1 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.0.9 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.8 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.7 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.6 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secret-manager-component.html) | | 2.0.4 | Versi awal. | # Tunneling yang aman Dengan `aws.greengrass.SecureTunneling` komponen ini, Anda dapat membangun komunikasi dua arah yang aman dengan perangkat inti Greengrass yang terletak di belakang firewall terbatas. Misalnya, bayangkan Anda memiliki perangkat inti Greengrass di belakang firewall yang melarang semua koneksi masuk. Tunneling aman menggunakan MQTT untuk mentransfer token akses ke perangkat dan kemudian menggunakan untuk membuat koneksi SSH WebSockets ke perangkat melalui firewall. Dengan terowongan AWS IoT terkelola ini, Anda dapat membuka koneksi SSH yang diperlukan untuk perangkat Anda. *Untuk informasi selengkapnya tentang penggunaan tunneling AWS IoT aman untuk terhubung ke perangkat jarak jauh, lihat [tunneling AWS IoT aman](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) di Panduan Pengembang.AWS IoT * Komponen ini berlangganan broker pesan AWS IoT Core MQTT tentang `$aws/things/greengrass-core-device/tunnels/notify` topik tersebut untuk menerima pemberitahuan tunneling yang aman. **Topics** + [Versi](#secure-tunneling-component-versions) + [Tipe](#secure-tunneling-component-type) + [Sistem operasi](#secure-tunneling-component-os-support) + [Persyaratan](#secure-tunneling-component-requirements) + [Dependensi](#secure-tunneling-component-dependencies) + [Konfigurasi](#secure-tunneling-component-configuration) + [File log lokal](#secure-tunneling-component-log-file) + [Lisensi](#secure-tunneling-component-licenses) + [Penggunaan](#secure-tunneling-component-usage) + [Lihat juga](#secure-tunneling-component-see-also) + [Changelog](#secure-tunneling-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.0.x + 1.1.x + 1.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. Arsitektur: + Armv71 + Armv8 () AArch64 + x86\$164 ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: ------ #### [ 2.0.x ] + Minimal ruang disk 4 MB tersedia untuk komponen tunneling aman. Persyaratan ini tidak termasuk perangkat lunak inti Greengrass atau komponen lain yang berjalan pada perangkat yang sama. + Minimal 3 MB RAM tersedia untuk komponen tunneling aman. Persyaratan ini tidak termasuk perangkat lunak inti Greengrass atau komponen lain yang berjalan pada perangkat yang sama. + GNU C Library (glibc) versi 2.35 atau lebih tinggi. Versi sistem operasi dan pustaka yang melewati tanggal akhir masa pakai dukungan jangka panjangnya tidak didukung. Anda harus menggunakan sistem operasi dan perpustakaan dengan dukungan jangka panjang. + Pustaka runtime berikut yang diinstal pada perangkat inti Greengrass: + `libstdc++`versi 3.4.29 atau lebih + `libgcc_s`versi 3.0 atau lebih + OpenSSL versi 3.0.0 atau lebih tinggi + Buka lalu lintas keluar pada port 443 pada perangkat inti Greengrass. + Nyalakan dukungan untuk layanan komunikasi yang ingin Anda gunakan untuk berkomunikasi dengan perangkat inti Greengrass. Misalnya, untuk membuka koneksi SSH ke perangkat, Anda harus mengaktifkan SSH pada perangkat itu. ------ #### [ 1.0.x - 1.1.x ] + Minimal 32 MB ruang disk tersedia untuk komponen tunneling aman. Persyaratan ini tidak termasuk perangkat lunak inti Greengrass atau komponen lain yang berjalan pada perangkat yang sama. + Minimal 16 MB RAM tersedia untuk komponen tunneling aman. Persyaratan ini tidak termasuk perangkat lunak inti Greengrass atau komponen lain yang berjalan pada perangkat yang sama. Untuk informasi selengkapnya, lihat [Kontrol alokasi memori dengan opsi JVM](configure-greengrass-core-v2.md#jvm-tuning). + GNU C Library (glibc) versi 2.25 atau lebih tinggi dengan kernel Linux 3.2 atau lebih tinggi diperlukan untuk komponen tunneling aman versi 1.0.12 dan lebih besar. Versi sistem operasi dan pustaka yang melewati tanggal akhir masa pakai dukungan jangka panjangnya tidak didukung. Anda harus menggunakan sistem operasi dan perpustakaan dengan dukungan jangka panjang. + Baik sistem operasi dan runtime Java harus diinstal sebagai 64 bit. + [Python](https://www.python.org/) 3.5 atau yang lebih baru diinstal pada perangkat inti Greengrass dan ditambahkan ke variabel lingkungan PATH. + `libcrypto.so.1.1` diinstal pada perangkat inti Greengrass dan ditambahkan ke variabel lingkungan PATH. + Buka lalu lintas keluar pada port 443 pada perangkat inti Greengrass. + Nyalakan dukungan untuk layanan komunikasi yang ingin Anda gunakan untuk berkomunikasi dengan perangkat inti Greengrass. Misalnya, untuk membuka koneksi SSH ke perangkat, Anda harus mengaktifkan SSH pada perangkat itu. ------ ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `data.tunneling.iot.region.amazonaws.com` | 443 | Ya | Membangun terowongan aman. | ## 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](#secure-tunneling-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.0.0 ] Versi 2.0.0 dari komponen ini mendukung nukleus Greengrass dan Greengrass nucleus lite. Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [[Inti Greengrass ATAU Greengrass nucleus lite](greengrass-nucleus-lite-component.md)](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Lunak | ------ #### [ 1.0.19 – 1.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.19 hingga 1.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Lunak | ------ #### [ 1.0.18 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.18 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | ------ #### [ 1.0.16 – 1.0.17 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.16 hingga 1.0.17 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | ------ #### [ 1.0.14 – 1.0.15 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.14 hingga 1.0.15 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | ------ #### [ 1.0.11 – 1.0.13 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.11 — 1.0.13 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | ------ #### [ 1.0.10 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | ------ #### [ 1.0.9 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | ------ #### [ 1.0.8 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.8 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | ------ #### [ 1.0.5 - 1.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.5 hingga 1.0.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | ------ #### [ 1.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | ------ #### [ 1.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | ------ #### [ 1.0.2 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | ------ #### [ 1.0.1 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | ------ #### [ 1.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 1.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ 2.0.x ] `maxConcurrentTunnels` (Opsional) Jumlah maksimum terowongan bersamaan diperbolehkan. Nilainya tidak boleh lebih dari 20. Default: `20` `tunnelTimeoutSeconds` (Opsional) Durasi batas waktu terowongan dalam hitungan detik. Default: `43200` (12 jam) `accessControl` (Opsional) Objek yang berisi [kebijakan otorisasi](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk berlangganan topik pemberitahuan tunneling aman. Jangan mengubah parameter konfigurasi ini jika deployment Anda menargetkan grup objek. Jika penerapan Anda menargetkan perangkat inti individual, dan Anda ingin membatasi langganannya ke topik perangkat, tentukan nama perangkat inti. Dalam `resources` nilai dalam kebijakan otorisasi perangkat, ganti wildcard topik MQTT dengan nama benda perangkat. ``` { "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.SecureTunneling:mqttproxy:1": { "policyDescription": "Access to tunnel notification pubsub topic", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "$aws/things/+/tunnels/notify" ] } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan terowongan bersamaan maksimum dan pengaturan batas waktu. ``` { "maxConcurrentTunnels": 20, "tunnelTimeoutSeconds": 43200, "accessControl": { "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.SecureTunneling:mqttproxy:1": { "policyDescription": "Access to tunnel notification pubsub topic", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "$aws/things/MyGreengrassCore/tunnels/notify" ] } } } } ``` ------ #### [ 1.0.x - 1.1.x ] `OS_DIST_INFO` (Opsional) Sistem operasi perangkat inti Anda. Secara default, komponen mencoba mengidentifikasi secara otomatis sistem operasi yang berjalan pada perangkat inti Anda. Jika komponen gagal memulai dengan nilai default, gunakan nilai ini untuk menentukan sistem operasi. Untuk daftar sistem operasi yang didukung untuk komponen ini, lihat [Persyaratan perangkat](greengrass-nucleus-component.md#greengrass-v2-requirements). Nilai ini dapat berupa salah satu dari yang berikut: `auto`, `ubuntu`, `amzn2`, `raspberrypi`. Default: `auto` `accessControl` (Opsional) Objek yang berisi [kebijakan otorisasi](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk berlangganan topik pemberitahuan tunneling aman. Jangan mengubah parameter konfigurasi ini jika deployment Anda menargetkan grup objek. Jika penerapan Anda menargetkan perangkat inti individual, dan Anda ingin membatasi langganannya ke topik perangkat, tentukan nama perangkat inti. Dalam `resources` nilai dalam kebijakan otorisasi perangkat, ganti wildcard topik MQTT dengan nama benda perangkat. ``` { "aws.greengrass.ipc.mqttproxy": { "aws.iot.SecureTunneling:mqttproxy:1": { "policyDescription": "Access to tunnel notification pubsub topic", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "$aws/things/+/tunnels/notify" ] } } } ``` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk memungkinkan komponen ini untuk membuka terowongan aman pada perangkat inti bernama **MyGreengrassCore** yang menjalankan Ubuntu. ``` { "OS_DIST_INFO": "ubuntu", "accessControl": { "aws.greengrass.ipc.mqttproxy": { "aws.iot.SecureTunneling:mqttproxy:1": { "policyDescription": "Access to tunnel notification pubsub topic", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "$aws/things/MyGreengrassCore/tunnels/notify" ] } } } } ``` ------ ## File log lokal ------ #### [ Greengrass nucleus ] Komponen ini menggunakan file log berikut. ``` /greengrass/v2/logs/aws.greengrass.SecureTunneling.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.SecureTunneling.log ``` ------ #### [ Greengrass nucleus lite ] Jalankan perintah berikut pada perangkat inti untuk melihat log komponen ini. ``` journalctl -xeau ggl.aws.greengrass.SecureTunneling.service ``` Jalankan perintah berikut pada perangkat inti untuk melihat log komponen ini secara real time. ``` journalctl -fau ggl.aws.greengrass.SecureTunneling.service ``` ------ ## Lisensi Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut: ------ #### [ 2.0.x ] + [AWS IoT Proxy Lokal Tunneling Aman/Lisensi](https://github.com/aws-samples/aws-iot-securetunneling-localproxy) Apache 2.0 + [AWS SDK Komponen Greengrass /Lisensi Apache 2.0](https://github.com/aws-greengrass/aws-greengrass-component-sdk) + [Boost C \$1\$1 Libraries](https://www.boost.org/) /Boost Software Lisensi 1.0 + [Protokol Buffer](https://github.com/protocolbuffers/protobuf) /BSD 3-Klausul Lisensi ------ #### [ 1.0.x - 1.1.x ] + [AWS IoT Klien Perangkat/Lisensi](https://github.com/awslabs/aws-iot-device-client) Apache 2.0 + [AWS IoT Device SDK for Java](https://github.com/aws/aws-greengrass-core-sdk-java/)/Apache License 2.0 + [gson](https://github.com/google/gson)/Apache License 2.0 + [log4j](https://logging.apache.org/log4j/2.x/)/Apache License 2.0 + [slf4j](http://www.slf4j.org/)/Apache License 2.0 ------ ## Penggunaan Untuk menggunakan komponen tunneling aman di perangkat Anda, lakukan hal berikut: 1. Terapkan komponen tunneling aman ke perangkat Anda. 1. Buka [konsol AWS IoT](https://console.aws.amazon.com/iot). Dari menu sebelah kiri, pilih **Tindakan jarak jauh**, lalu pilih **Terowongan aman**. 1. Buat terowongan ke perangkat Greengrass Anda. 1. Unduh token akses sumber. 1. Gunakan proxy lokal dengan token akses sumber untuk terhubung ke tujuan Anda. Untuk informasi selengkapnya, lihat [Cara menggunakan proxy lokal](https://docs.aws.amazon.com/iot/latest/developerguide/how-use-local-proxy.html) di *Panduan AWS IoT Pengembang*. ## Lihat juga + [AWS IoT tunneling aman di Panduan](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) *Pengembang AWS IoT * + [Cara menggunakan proxy lokal](https://docs.aws.amazon.com/iot/latest/developerguide/how-use-local-proxy.html) di *Panduan AWS IoT Pengembang* ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.1.2 | Versi ini tidak lagi tersedia. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.0.19 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) Jika Anda menggunakan proxy lokal tunneling aman sebagai klien sumber terowongan, jangan perbarui komponen Anda ke versi ini sampai Anda juga memutakhirkan proxy lokal ke versi 3.1.1 atau yang lebih baru. | | 1.0.18 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 1.0.17 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.0.16 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 1.0.15 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.0.14 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 1.0.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.0.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.0.11 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 1.0.10 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 1.0.9 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 1.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 1.0.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/secure-tunneling-component.html) | | 1.0.6 | Versi ini berisi perbaikan bug. | | 1.0.5 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 1.0.4 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 1.0.3 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 1.0.2 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 1.0.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 1.0.0 | Versi awal. | # Pengelola bayangan Komponen shadow manager (`aws.greengrass.ShadowManager`) memungkinkan layanan bayangan lokal pada perangkat inti Anda. Layanan bayangan lokal memungkinkan komponen untuk menggunakan komunikasi antar proses untuk [berinteraksi dengan bayangan lokal](ipc-local-shadows.md). Komponen shadow manager mengelola penyimpanan dokumen bayangan lokal, dan juga menangani sinkronisasi status bayangan lokal dengan layanan AWS IoT Device Shadow. Untuk informasi selengkapnya tentang bagaimana perangkat inti Greengrass dapat berinteraksi dengan bayangan, lihat. [Berinteraksilah dengan bayangan perangkat](interact-with-shadows.md) **Topics** + [Versi](#shadow-manager-component-versions) + [Tipe](#shadow-manager-component-type) + [Sistem operasi](#shadow-manager-component-os-support) + [Persyaratan](#shadow-manager-component-requirements) + [Dependensi](#shadow-manager-component-dependencies) + [Konfigurasi](#shadow-manager-component-configuration) + [Berkas log lokal](#shadow-manager-component-log-file) + [Changelog](#shadow-manager-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen plugin (`aws.greengrass.plugin`). [Inti Greengrass](greengrass-nucleus-component.md) menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nukleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti. Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + (Opsional) Untuk menyinkronkan bayangan ke layanan AWS IoT Device Shadow, kebijakan perangkat inti Greengrass harus mengizinkan AWS IoT tindakan kebijakan bayangan berikut: AWS IoT Core + `iot:GetThingShadow` + `iot:UpdateThingShadow` + `iot:DeleteThingShadow` Untuk informasi selengkapnya tentang AWS IoT Core kebijakan ini, lihat [tindakan AWS IoT Core kebijakan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) di *Panduan AWS IoT Pengembang*. Untuk informasi selengkapnya tentang AWS IoT kebijakan minimal, lihat [AWS IoT Kebijakan minimal untuk perangkat AWS IoT Greengrass V2 inti](device-auth.md#greengrass-core-minimal-iot-policy) + Komponen shadow manager didukung untuk berjalan di VPC. ## 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](#shadow-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.3.13 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.13 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Lunak | ------ #### [ 2.3.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Lunak | ------ #### [ 2.3.11 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.11 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.16.0 | Lunak | ------ #### [ 2.3.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.15.0 | Lunak | ------ #### [ 2.3.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.14.0 | Lunak | ------ #### [ 2.3.5 – 2.3.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.5 hingga 2.3.8 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.13.0 | Lunak | ------ #### [ 2.3.3 and 2.3.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.3 dan 2.3.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.12.0 | Lunak | ------ #### [ 2.3.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Lunak | ------ #### [ 2.3.0 and 2.3.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.3.0 dan 2.3.1 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Lunak | ------ #### [ 2.2.3 and 2.2.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.3 dan 2.2.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <3.0.0 | Lunak | ------ #### [ 2.2.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | Lunak | ------ #### [ 2.2.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.2.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | Lunak | ------ #### [ 2.1.1 and 2.2.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 dan 2.2.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Lunak | ------ #### [ 2.0.5 - 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.5 hingga 2.1.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Lunak | ------ #### [ 2.0.3 and 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 dan 2.0.4 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Lunak | ------ #### [ 2.0.1 and 2.0.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.1 dan 2.0.2 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Lunak | ------ #### [ 2.0.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Lunak | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ 2.3.x ] `strategy` (Opsional) Strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Objek ini berisi informasi berikut. `type` (Opsional) Jenis strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Pilih dari salah satu pilihan berikut: + `realTime`— Sinkronkan bayangan dengan AWS IoT Core setiap kali pembaruan bayangan terjadi. + `periodic`— Sinkronkan bayangan dengan AWS IoT Core interval reguler yang Anda tentukan dengan parameter `delay` konfigurasi. Default: `realTime` `delay` (Opsional) Interval dalam detik di mana komponen ini menyinkronkan bayangan dengan AWS IoT Core, saat Anda menentukan strategi `periodic` sinkronisasi. Parameter ini diperlukan jika Anda menentukan strategi `periodic` sinkronisasi. `synchronize` (Opsional) Pengaturan sinkronisasi yang menentukan bagaimana bayangan disinkronkan dengan AWS Cloud. Anda harus membuat pembaruan konfigurasi dengan properti ini untuk menyinkronkan bayangan dengan AWS Cloud. Objek ini berisi informasi berikut. `coreThing` (Opsional) Bayangan perangkat inti untuk disinkronkan. Objek ini berisi informasi berikut. `classic` (Opsional) Secara default, pengelola bayangan menyinkronkan status lokal bayangan klasik untuk perangkat inti Anda dengan. AWS Cloud Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik, atur ini ke `false`. Default: `true` `namedShadows` (Opsional) Daftar bayangan perangkat inti bernama untuk disinkronkan. Anda harus menentukan nama yang tepat dari bayangan. AWS IoT Greengrass Layanan ini menggunakan bayangan `AWSManagedGreengrassV2Deployment` bernama untuk mengelola penerapan yang menargetkan perangkat inti individual. Bayangan bernama ini dicadangkan untuk digunakan oleh AWS IoT Greengrass layanan. Jangan perbarui atau hapus bayangan bernama ini. `shadowDocumentsMap` (Opsional) Bayangan perangkat tambahan untuk disinkronkan. Menggunakan parameter konfigurasi ini memudahkan untuk menentukan dokumen bayangan. Kami menyarankan Anda menggunakan parameter ini alih-alih `shadowDocuments` objek. Jika Anda menentukan `shadowDocumentsMap` objek, Anda tidak harus menentukan `shadowDocuments` objek. Setiap objek berisi informasi berikut: *`thingName`* Konfigurasi bayangan *thingName* untuk konfigurasi bayangan ini. `classic` (Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`. `namedShadows` Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan. `shadowDocuments` (Opsional) Daftar bayangan perangkat tambahan untuk disinkronkan. Kami menyarankan Anda menggunakan `shadowDocumentsMap` parameter sebagai gantinya. Jika Anda menentukan `shadowDocuments` objek, Anda tidak harus menentukan `shadowDocumentsMap` objek. Setiap objek dalam daftar ini berisi informasi berikut. `thingName` Nama objek perangkat untuk menyinkronkan bayangan. `classic` (Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`. Default: `true` `namedShadows` (Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan. `direction` (Opsional) Arah untuk menyinkronkan bayangan antara layanan bayangan lokal dan AWS Cloud. Anda dapat mengonfigurasi opsi ini untuk mengurangi bandwidth dan koneksi ke file AWS Cloud. Pilih dari salah satu pilihan berikut: + `betweenDeviceAndCloud`— Sinkronisasi bayangan antara layanan bayangan lokal dan. AWS Cloud + `deviceToCloud`— Kirim pembaruan bayangan dari layanan bayangan lokal ke AWS Cloud, dan abaikan pembaruan bayangan dari AWS Cloud. + `cloudToDevice`— Terima pembaruan bayangan dari AWS Cloud, dan jangan mengirim pembaruan bayangan dari layanan bayangan lokal ke AWS Cloud. Default: `BETWEEN_DEVICE_AND_CLOUD` `rateLimits` (Opsional) Pengaturan yang menentukan batas tarif untuk permintaan layanan bayangan. Objek ini berisi informasi berikut. `maxOutboundSyncUpdatesPerSecond` (Opsional) Jumlah maksimum permintaan sinkronisasi per detik yang ditransmisikan perangkat. Default: 100 permintaan/detik `maxTotalLocalRequestsRate` (Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim ke perangkat inti. Default: 200 permintaan/detik `maxLocalRequestsPerSecondPerThing` (Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim untuk setiap hal IoT yang terhubung. Default: 20 requests/second untuk setiap hal Parameter batas tingkat ini menentukan jumlah maksimum permintaan per detik untuk layanan bayangan lokal. Jumlah maksimum permintaan per detik untuk layanan AWS IoT Device Shadow tergantung pada Anda Wilayah AWS. Untuk informasi selengkapnya, lihat batasan untuk [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*. `shadowDocumentSizeLimitBytes` (Opsional) Ukuran maksimum yang diizinkan dari setiap dokumen status JSON untuk bayangan lokal. Jika Anda meningkatkan nilai ini, Anda juga harus meningkatkan batas sumber daya untuk dokumen keadaan JSON untuk bayangan cloud. Untuk informasi selengkapnya, lihat batasan untuk [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*. Default: 8192 byte Maksimum: 30720 byte **Example Contoh: Pembaruan gabungan konfigurasi** Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel dengan semua parameter konfigurasi yang tersedia untuk komponen manajer bayangan. ``` { "strategy":{ "type":"periodic", "delay":300 }, "synchronize":{ "shadowDocumentsMap":{ "MyDevice1":{ "classic":false, "namedShadows":[ "MyShadowA", "MyShadowB" ] }, "MyDevice2":{ "classic":true, "namedShadows":[] } }, "direction":"betweenDeviceAndCloud" }, "rateLimits":{ "maxOutboundSyncUpdatesPerSecond":100, "maxTotalLocalRequestsRate":200, "maxLocalRequestsPerSecondPerThing":20 }, "shadowDocumentSizeLimitBytes":8192 } ``` ------ #### [ 2.2.x ] `strategy` (Opsional) Strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Objek ini berisi informasi berikut. `type` (Opsional) Jenis strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Pilih dari salah satu pilihan berikut: + `realTime`— Sinkronkan bayangan dengan AWS IoT Core setiap kali pembaruan bayangan terjadi. + `periodic`— Sinkronkan bayangan dengan AWS IoT Core interval reguler yang Anda tentukan dengan parameter `delay` konfigurasi. Default: `realTime` `delay` (Opsional) Interval dalam detik di mana komponen ini menyinkronkan bayangan dengan AWS IoT Core, saat Anda menentukan strategi `periodic` sinkronisasi. Parameter ini diperlukan jika Anda menentukan strategi `periodic` sinkronisasi. `synchronize` (Opsional) Pengaturan sinkronisasi yang menentukan bagaimana bayangan disinkronkan dengan AWS Cloud. Anda harus membuat pembaruan konfigurasi dengan properti ini untuk menyinkronkan bayangan dengan AWS Cloud. Objek ini berisi informasi berikut. `coreThing` (Opsional) Bayangan perangkat inti untuk disinkronkan. Objek ini berisi informasi berikut. `classic` (Opsional) Secara default, pengelola bayangan menyinkronkan status lokal bayangan klasik untuk perangkat inti Anda dengan. AWS Cloud Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik, atur ini ke `false`. Default: `true` `namedShadows` (Opsional) Daftar bayangan perangkat inti bernama untuk disinkronkan. Anda harus menentukan nama yang tepat dari bayangan. AWS IoT Greengrass Layanan ini menggunakan bayangan `AWSManagedGreengrassV2Deployment` bernama untuk mengelola penerapan yang menargetkan perangkat inti individual. Bayangan bernama ini dicadangkan untuk digunakan oleh AWS IoT Greengrass layanan. Jangan perbarui atau hapus bayangan bernama ini. `shadowDocumentsMap` (Opsional) Bayangan perangkat tambahan untuk disinkronkan. Menggunakan parameter konfigurasi ini memudahkan untuk menentukan dokumen bayangan. Kami menyarankan Anda menggunakan parameter ini alih-alih `shadowDocuments` objek. Jika Anda menentukan `shadowDocumentsMap` objek, Anda tidak harus menentukan `shadowDocuments` objek. Setiap objek berisi informasi berikut: *`thingName`* Konfigurasi bayangan *thingName* untuk konfigurasi bayangan ini. `classic` (Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`. `namedShadows` Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan. `shadowDocuments` (Opsional) Daftar bayangan perangkat tambahan untuk disinkronkan. Kami menyarankan Anda menggunakan `shadowDocumentsMap` parameter sebagai gantinya. Jika Anda menentukan `shadowDocuments` objek, Anda tidak harus menentukan `shadowDocumentsMap` objek. Setiap objek dalam daftar ini berisi informasi berikut. `thingName` Nama objek perangkat untuk menyinkronkan bayangan. `classic` (Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`. Default: `true` `namedShadows` (Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan. `direction` (Opsional) Arah untuk menyinkronkan bayangan antara layanan bayangan lokal dan AWS Cloud. Anda dapat mengonfigurasi opsi ini untuk mengurangi bandwidth dan koneksi ke file AWS Cloud. Pilih dari salah satu pilihan berikut: + `betweenDeviceAndCloud`— Sinkronisasi bayangan antara layanan bayangan lokal dan. AWS Cloud + `deviceToCloud`— Kirim pembaruan bayangan dari layanan bayangan lokal ke AWS Cloud, dan abaikan pembaruan bayangan dari AWS Cloud. + `cloudToDevice`— Terima pembaruan bayangan dari AWS Cloud, dan jangan mengirim pembaruan bayangan dari layanan bayangan lokal ke AWS Cloud. Default: `BETWEEN_DEVICE_AND_CLOUD` `rateLimits` (Opsional) Pengaturan yang menentukan batas tarif untuk permintaan layanan bayangan. Objek ini berisi informasi berikut. `maxOutboundSyncUpdatesPerSecond` (Opsional) Jumlah maksimum permintaan sinkronisasi per detik yang ditransmisikan perangkat. Default: 100 permintaan/detik `maxTotalLocalRequestsRate` (Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim ke perangkat inti. Default: 200 permintaan/detik `maxLocalRequestsPerSecondPerThing` (Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim untuk setiap hal IoT yang terhubung. Default: 20 requests/second untuk setiap hal Parameter batas tingkat ini menentukan jumlah maksimum permintaan per detik untuk layanan bayangan lokal. Jumlah maksimum permintaan per detik untuk layanan AWS IoT Device Shadow tergantung pada Anda Wilayah AWS. Untuk informasi selengkapnya, lihat batasan untuk [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*. `shadowDocumentSizeLimitBytes` (Opsional) Ukuran maksimum yang diizinkan dari setiap dokumen status JSON untuk bayangan lokal. Jika Anda meningkatkan nilai ini, Anda juga harus meningkatkan batas sumber daya untuk dokumen keadaan JSON untuk bayangan cloud. Untuk informasi selengkapnya, lihat batasan untuk [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*. Default: 8192 byte Maksimum: 30720 byte **Example Contoh: Pembaruan gabungan konfigurasi** Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel dengan semua parameter konfigurasi yang tersedia untuk komponen manajer bayangan. ``` { "strategy":{ "type":"periodic", "delay":300 }, "synchronize":{ "shadowDocumentsMap":{ "MyDevice1":{ "classic":false, "namedShadows":[ "MyShadowA", "MyShadowB" ] }, "MyDevice2":{ "classic":true, "namedShadows":[] } }, "direction":"betweenDeviceAndCloud" }, "rateLimits":{ "maxOutboundSyncUpdatesPerSecond":100, "maxTotalLocalRequestsRate":200, "maxLocalRequestsPerSecondPerThing":20 }, "shadowDocumentSizeLimitBytes":8192 } ``` ------ #### [ 2.1.x ] `strategy` (Opsional) Strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Objek ini berisi informasi berikut. `type` (Opsional) Jenis strategi yang digunakan komponen ini untuk menyinkronkan bayangan antara AWS IoT Core dan perangkat inti. Pilih dari salah satu pilihan berikut: + `realTime`— Sinkronkan bayangan dengan AWS IoT Core setiap kali pembaruan bayangan terjadi. + `periodic`— Sinkronkan bayangan dengan AWS IoT Core interval reguler yang Anda tentukan dengan parameter `delay` konfigurasi. Default: `realTime` `delay` (Opsional) Interval dalam detik di mana komponen ini menyinkronkan bayangan dengan AWS IoT Core, saat Anda menentukan strategi `periodic` sinkronisasi. Parameter ini diperlukan jika Anda menentukan strategi `periodic` sinkronisasi. `synchronize` (Opsional) Pengaturan sinkronisasi yang menentukan bagaimana bayangan disinkronkan dengan AWS Cloud. Anda harus membuat pembaruan konfigurasi dengan properti ini untuk menyinkronkan bayangan dengan AWS Cloud. Objek ini berisi informasi berikut. `coreThing` (Opsional) Bayangan perangkat inti untuk disinkronkan. Objek ini berisi informasi berikut. `classic` (Opsional) Secara default, pengelola bayangan menyinkronkan status lokal bayangan klasik untuk perangkat inti Anda dengan. AWS Cloud Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik, atur ini ke `false`. Default: `true` `namedShadows` (Opsional) Daftar bayangan perangkat inti bernama untuk disinkronkan. Anda harus menentukan nama yang tepat dari bayangan. AWS IoT Greengrass Layanan ini menggunakan bayangan `AWSManagedGreengrassV2Deployment` bernama untuk mengelola penerapan yang menargetkan perangkat inti individual. Bayangan bernama ini dicadangkan untuk digunakan oleh AWS IoT Greengrass layanan. Jangan perbarui atau hapus bayangan bernama ini. `shadowDocumentsMap` (Opsional) Bayangan perangkat tambahan untuk disinkronkan. Menggunakan parameter konfigurasi ini memudahkan untuk menentukan dokumen bayangan. Kami menyarankan Anda menggunakan parameter ini alih-alih `shadowDocuments` objek. Jika Anda menentukan `shadowDocumentsMap` objek, Anda tidak harus menentukan `shadowDocuments` objek. Setiap objek berisi informasi berikut: *`thingName`* Konfigurasi bayangan *thingName* untuk konfigurasi bayangan ini. `classic` (Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`. `namedShadows` Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan. `shadowDocuments` (Opsional) Daftar bayangan perangkat tambahan untuk disinkronkan. Kami menyarankan Anda menggunakan `shadowDocumentsMap` parameter sebagai gantinya. Jika Anda menentukan `shadowDocuments` objek, Anda tidak harus menentukan `shadowDocumentsMap` objek. Setiap objek dalam daftar ini berisi informasi berikut. `thingName` Nama objek perangkat untuk menyinkronkan bayangan. `classic` (Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`. Default: `true` `namedShadows` (Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan. `rateLimits` (Opsional) Pengaturan yang menentukan batas tarif untuk permintaan layanan bayangan. Objek ini berisi informasi berikut. `maxOutboundSyncUpdatesPerSecond` (Opsional) Jumlah maksimum permintaan sinkronisasi per detik yang ditransmisikan perangkat. Default: 100 permintaan/detik `maxTotalLocalRequestsRate` (Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim ke perangkat inti. Default: 200 permintaan/detik `maxLocalRequestsPerSecondPerThing` (Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim untuk setiap hal IoT yang terhubung. Default: 20 requests/second untuk setiap hal Parameter batas tingkat ini menentukan jumlah maksimum permintaan per detik untuk layanan bayangan lokal. Jumlah maksimum permintaan per detik untuk layanan AWS IoT Device Shadow tergantung pada Anda Wilayah AWS. Untuk informasi selengkapnya, lihat batasan untuk [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*. `shadowDocumentSizeLimitBytes` (Opsional) Ukuran maksimum yang diizinkan dari setiap dokumen status JSON untuk bayangan lokal. Jika Anda meningkatkan nilai ini, Anda juga harus meningkatkan batas sumber daya untuk dokumen keadaan JSON untuk bayangan cloud. Untuk informasi selengkapnya, lihat batasan untuk [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*. Default: 8192 byte Maksimum: 30720 byte **Example Contoh: Pembaruan gabungan konfigurasi** Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel dengan semua parameter konfigurasi yang tersedia untuk komponen manajer bayangan. ``` { "strategy":{ "type":"periodic", "delay":300 }, "synchronize":{ "shadowDocumentsMap":{ "MyDevice1":{ "classic":false, "namedShadows":[ "MyShadowA", "MyShadowB" ] }, "MyDevice2":{ "classic":true, "namedShadows":[] } }, "direction":"betweenDeviceAndCloud" }, "rateLimits":{ "maxOutboundSyncUpdatesPerSecond":100, "maxTotalLocalRequestsRate":200, "maxLocalRequestsPerSecondPerThing":20 }, "shadowDocumentSizeLimitBytes":8192 } ``` ------ #### [ 2.0.x ] `synchronize` (Opsional) Pengaturan sinkronisasi yang menentukan bagaimana bayangan disinkronkan dengan AWS Cloud. Anda harus membuat pembaruan konfigurasi dengan properti ini untuk menyinkronkan bayangan dengan AWS Cloud. Objek ini berisi informasi berikut. `coreThing` (Opsional) Bayangan perangkat inti untuk disinkronkan. Objek ini berisi informasi berikut. `classic` (Opsional) Secara default, pengelola bayangan menyinkronkan status lokal bayangan klasik untuk perangkat inti Anda dengan. AWS Cloud Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik, atur ini ke `false`. Default: `true` `namedShadows` (Opsional) Daftar bayangan perangkat inti bernama untuk disinkronkan. Anda harus menentukan nama yang tepat dari bayangan. AWS IoT Greengrass Layanan ini menggunakan bayangan `AWSManagedGreengrassV2Deployment` bernama untuk mengelola penerapan yang menargetkan perangkat inti individual. Bayangan bernama ini dicadangkan untuk digunakan oleh AWS IoT Greengrass layanan. Jangan perbarui atau hapus bayangan bernama ini. `shadowDocumentsMap` (Opsional) Bayangan perangkat tambahan untuk disinkronkan. Menggunakan parameter konfigurasi ini memudahkan untuk menentukan dokumen bayangan. Kami menyarankan Anda menggunakan parameter ini alih-alih `shadowDocuments` objek. Jika Anda menentukan `shadowDocumentsMap` objek, Anda tidak harus menentukan `shadowDocuments` objek. Setiap objek berisi informasi berikut: *`thingName`* Konfigurasi bayangan *thingName* untuk konfigurasi bayangan ini. `classic` (Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`. `namedShadows` Daftar bayangan bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan. `shadowDocuments` (Opsional) Daftar bayangan perangkat tambahan untuk disinkronkan. Kami menyarankan Anda menggunakan `shadowDocumentsMap` parameter sebagai gantinya. Jika Anda menentukan `shadowDocuments` objek, Anda tidak harus menentukan `shadowDocumentsMap` objek. Setiap objek dalam daftar ini berisi informasi berikut. `thingName` Nama objek perangkat untuk menyinkronkan bayangan. `classic` (Opsional) Jika Anda tidak ingin menyinkronkan bayangan perangkat klasik untuk `thingName` perangkat, setel ini ke`false`. Default: `true` `namedShadows` (Opsional) Daftar bayangan perangkat bernama yang ingin Anda sinkronkan. Anda harus menentukan nama yang tepat dari bayangan. `rateLimits` (Opsional) Pengaturan yang menentukan batas tarif untuk permintaan layanan bayangan. Objek ini berisi informasi berikut. `maxOutboundSyncUpdatesPerSecond` (Opsional) Jumlah maksimum permintaan sinkronisasi per detik yang ditransmisikan perangkat. Default: 100 permintaan/detik `maxTotalLocalRequestsRate` (Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim ke perangkat inti. Default: 200 permintaan/detik `maxLocalRequestsPerSecondPerThing` (Opsional) Jumlah maksimum permintaan IPC lokal per detik yang dikirim untuk setiap hal IoT yang terhubung. Default: 20 requests/second untuk setiap hal Parameter batas tingkat ini menentukan jumlah maksimum permintaan per detik untuk layanan bayangan lokal. Jumlah maksimum permintaan per detik untuk layanan AWS IoT Device Shadow tergantung pada Anda Wilayah AWS. Untuk informasi selengkapnya, lihat batasan untuk [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*. `shadowDocumentSizeLimitBytes` (Opsional) Ukuran maksimum yang diizinkan dari setiap dokumen status JSON untuk bayangan lokal. Jika Anda meningkatkan nilai ini, Anda juga harus meningkatkan batas sumber daya untuk dokumen keadaan JSON untuk bayangan cloud. Untuk informasi selengkapnya, lihat batasan untuk [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) di *Referensi Umum Amazon Web*. Default: 8192 byte Maksimum: 30720 byte **Example Contoh: Pembaruan gabungan konfigurasi** Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel dengan semua parameter konfigurasi yang tersedia untuk komponen manajer bayangan. ``` { "synchronize": { "coreThing": { "classic": true, "namedShadows": [ "MyCoreShadowA", "MyCoreShadowB" ] }, "shadowDocuments": [ { "thingName": "MyDevice1", "classic": false, "namedShadows": [ "MyShadowA", "MyShadowB" ] }, { "thingName": "MyDevice2", "classic": true, "namedShadows": [] } ] }, "rateLimits": { "maxOutboundSyncUpdatesPerSecond": 100, "maxTotalLocalRequestsRate": 200, "maxLocalRequestsPerSecondPerThing": 20 }, "shadowDocumentSizeLimitBytes": 8192 } ``` ------ ## Berkas log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | Versi | Perubahan | | --- | --- | | 2.3.13 | Memperbarui versi komponen untuk rilis Greengrass nucleus versi 2.17.0. | | 2.3.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.3.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.3.11 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.3.10 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.3.9 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.3.8 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.3.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.3.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.3.5 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.3.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.3.3 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.2.3 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.2.2 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.2.1 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.0.6 | Versi ini berisi perbaikan bug dan perbaikan. | | 2.0.5 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.0.3 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/shadow-manager-component.html) | | 2.0.1 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.0 | Versi awal. | # Amazon SNS Komponen Amazon SNS (`aws.greengrass.SNS`) menerbitkan pesan ke topik Amazon Simple Notification Service (Amazon SNS). Anda dapat menggunakan komponen ini untuk mengirim peristiwa dari perangkat inti Greengrass ke server web, alamat email, dan pelanggan pesan lainnya. Untuk informasi lebih lanjut, lihat [Apa itu Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) di *Panduan Developer Amazon Simple Notification Service*. Untuk mempublikasikan topik Amazon SNS dengan komponen ini, mempublikasikan pesan ke topik di mana komponen ini berlangganan. Secara default, komponen ini berlangganan topik [publikasi/berlangganan lokal](ipc-publish-subscribe.md) `sns/message`. Anda dapat menentukan topik lain, termasuk topik AWS IoT Core MQTT, saat Anda menerapkan komponen ini. Dalam komponen kustom Anda, Anda mungkin ingin menerapkan pemfilteran atau pemformatan logika untuk memproses pesan dari sumber lain sebelum Anda mempublikasikannya ke komponen ini. Hal ini memungkinkan Anda untuk memusatkan logika pemrosesan pesan Anda pada satu komponen. **catatan** Komponen ini menyediakan fungsionalitas yang mirip dengan konektor Amazon SNS di AWS IoT Greengrass V1. Untuk informasi selengkapnya, lihat [konektor Amazon SNS](https://docs.aws.amazon.com/greengrass/latest/developerguide/sns-connector.html) dalam *AWS IoT Greengrass Panduan Developer V1*. **Topics** + [Versi](#sns-component-versions) + [Jenis](#sns-component-type) + [Sistem operasi](#sns-component-os-support) + [Persyaratan](#sns-component-requirements) + [Dependensi](#sns-component-dependencies) + [Konfigurasi](#sns-component-configuration) + [Data input](#sns-component-input-data) + [Data output](#sns-component-output-data) + [File log lokal](#sns-component-log-file) + [Lisensi](#sns-component-licenses) + [Changelog](#sns-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x + 2.0.x ## Jenis Komponen ini adalah komponen Lambda () `aws.greengrass.lambda`. [Inti [Greengrass](greengrass-nucleus-component.md) menjalankan fungsi Lambda komponen ini menggunakan komponen peluncur Lambda.](lambda-launcher-component.md) Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat [Persyaratan fungsi Lambda](setting-up.md#greengrass-v2-lambda-requirements). + [Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH. + Topik Amazon SNS. Untuk informasi lebih lanjut, lihat [Membuat topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) dalam *Panduan Developer Amazon Simple Notification Service*. + [Peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `sns:Publish`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "sns:Publish" ], "Effect": "Allow", "Resource": [ "arn:aws:sns:us-east-1:123456789012:topic-name" ] } ] } ``` ------ Anda dapat secara dinamis mengganti topik default dalam muatan pesan masukan untuk komponen ini. Jika aplikasi Anda menggunakan fitur ini, kebijakan IAM harus mencakup semua topik target sebagai sumber daya. Anda dapat memberikan akses terperinci atau bersyarat ke sumber daya (misalnya, dengan menggunakan skema penamaan wildcard `*`). + Untuk menerima data keluaran dari komponen ini, Anda harus menggabungkan pemutakhiran konfigurasi berikut untuk [komponen router langganan lama (`aws.greengrass.LegacySubscriptionRouter`) saat menerapkan komponen](legacy-subscription-router-component.md) ini. Konfigurasi ini menentukan topik di mana komponen ini menerbitkan tanggapan. ------ #### [ Legacy subscription router v2.1.x ] ``` { "subscriptions": { "aws-greengrass-sns": { "id": "aws-greengrass-sns", "source": "component:aws.greengrass.SNS", "subject": "sns/message/status", "target": "cloud" } } } ``` ------ #### [ Legacy subscription router v2.0.x ] ``` { "subscriptions": { "aws-greengrass-sns": { "id": "aws-greengrass-sns", "source": "arn:aws:lambda:region:aws:function:aws-greengrass-sns:version", "subject": "sns/message/status", "target": "cloud" } } } ``` + Ganti *region* dengan Wilayah AWS yang Anda gunakan. + Ganti *version* dengan versi fungsi Lambda yang dijalankan komponen ini. Untuk menemukan versi fungsi Lambda, Anda harus melihat resep untuk versi komponen ini yang ingin Anda deploy. Buka halaman detail komponen ini di [konsol AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) tersebut, dan cari pasangan nilai kunci **Fungsi Lambda**. Pasangan kunci-nilai ini berisi nama dan versi fungsi Lambda. **penting** Anda harus memperbarui versi fungsi Lambda pada router langganan warisan setiap kali Anda men-deploy komponen ini. Hal ini memastikan bahwa Anda menggunakan versi fungsi Lambda yang benar untuk versi komponen yang Anda deploy. ------ Untuk informasi selengkapnya, lihat [Buat deployment](create-deployments.md). + Komponen Amazon SNS didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan. + Komponen Amazon SNS harus memiliki konektivitas `sns.region.amazonaws.com` yang memiliki titik akhir VPC. `com.amazonaws.us-east-1.sns` ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `sns.region.amazonaws.com` | 443 | Ya | Memublikasikan pesan ke Amazon SNS. | ## 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](#sns-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.2 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.8 - 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 dan 2.1.0 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.6 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.5 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | ^2.0.0 | Keras | ------ #### [ 2.0.3 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Keras | | [Peluncur Lambda](lambda-launcher-component.md) | >=1.0.0 | Keras | | [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0 | Lunak | | [Layanan penukaran Token](token-exchange-service-component.md) | >=1.0.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. **catatan** Konfigurasi default komponen ini meliputi parameter fungsi Lambda. Kami sarankan Anda mengedit hanya parameter berikut untuk mengonfigurasi komponen ini pada perangkat Anda. `lambdaParams` Sebuah objek yang berisi parameter untuk fungsi Lambda komponen ini. Objek ini berisi informasi berikut: `EnvironmentVariables` Sebuah objek yang berisi parameter fungsi Lambda ini. Objek ini berisi informasi berikut: `DEFAULT_SNS_ARN` ARN topik Amazon SNS default di mana komponen ini menerbitkan pesan. Anda dapat menimpa topik tujuan dengan properti `sns_topic_arn` dalam muatan pesan masukan. `containerMode` (Opsional) Mode kontainerisasi untuk komponen ini. Pilih dari salah satu pilihan berikut: + `NoContainer` – Komponen tersebut tidak berjalan di lingkungan waktu aktif terisolasi. + `GreengrassContainer`— Komponen berjalan di lingkungan runtime yang terisolasi di dalam AWS IoT Greengrass wadah. Default: `GreengrassContainer` `containerParams` (Opsional) Sebuah objek yang berisi parameter kontainer untuk komponen ini. Komponen menggunakan parameter ini jika Anda menentukan `GreengrassContainer` untuk `containerMode`. Objek ini berisi informasi berikut: `memorySize` (Opsional) Jumlah memori (dalam kilobyte) yang akan dialokasikan ke komponen. Defaultnya 512 MB (525.312 KB). `pubsubTopics` (Opsional) Sebuah objek yang berisi topik di mana komponen berlangganan untuk menerima pesan. Anda dapat menentukan setiap topik dan apakah komponen berlangganan topik MQTT dari AWS IoT Core atau topik lokal. publish/subscribe Objek ini berisi informasi berikut: `0` - Ini adalah indeks himpunan sebagai string. Objek yang berisi informasi berikut: `type` (Opsional) Jenis publish/subscribe pesan yang digunakan komponen ini untuk berlangganan pesan. Pilih dari salah satu pilihan berikut: + `PUB_SUB` — Berlangganan pesan publish/subscribe lokal. Jika Anda memilih opsi ini, topik tidak dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). + `IOT_CORE`— Berlangganan pesan AWS IoT Core MQTT. Jika Anda memilih opsi ini, topik dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). Default: `PUB_SUB` `topic` (Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan `IotCore` untuk `type`, Anda dapat menggunakan wildcard MQTT (`+` dan `#`) dalam topik ini. **Example Contoh: Pembaruan gabungan konfigurasi (mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic" } }, "containerMode": "GreengrassContainer" } ``` **Example Contoh: Pembaruan gabungan konfigurasi (tidak ada mode kontainer)** ``` { "lambdaExecutionParameters": { "EnvironmentVariables": { "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic" } }, "containerMode": "NoContainer" } ``` ## Data input Komponen ini menerima pesan pada topik berikut dan menerbitkan pesan sebagaimana adanya ke target topik Amazon SNS. Secara default, komponen ini berlangganan publish/subscribe pesan lokal. Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat [Pesan lokal publikasi/berlangganan](ipc-publish-subscribe.md). **Topik default (publish/subscribe lokal):** `sns/message` Pesan menerima properti berikut. Pesan input harus dalam format JSON. `request` Informasi tentang pesan yang akan dikirim ke topik Amazon SNS. Jenis: `object` yang berisi informasi berikut: `message` Isi dari pesan sebagai string. Untuk mengirim objek JSON, buat serialnya sebagai string, dan tentukan `json` untuk properti `message_structure`. Tipe: `string` `subject` (Opsional) Subjek pesan. Tipe: `string` Subjek dapat berupa teks ASCII dan hingga 100 karakter. Ia harus dimulai dengan huruf, angka, atau tanda baca. Ia tidak dapat berupa jeda baris atau karakter kontrol. `sns_topic_arn` ARN topik Amazon SNS tempat komponen ini menerbitkan pesan. Tentukan properti ini untuk menimpa topik Amazon SNS default. Tipe: `string` `message_structure` (Opsional) Struktur pesan. Tentukan `json` untuk mengirim pesan JSON yang Anda buat serialnya sebagai string dalam properti `content`. Tipe: `string` Nilai yang valid: `json` `id` ID acak untuk permintaan. Gunakan properti ini untuk memetakan permintaan inpun untuk respons output. Ketika Anda menentukan properti ini, komponen menetapkan properti `id` di objek respons untuk nilai ini. Tipe: `string` **catatan** Ukuran pesan dapat maksimal 256 KB. **Example Contoh input: Pesan string** ``` { "request": { "subject": "Message subject", "message": "Message data", "sns_topic_arn": "arn:aws:sns:region:account-id:topic2-name" }, "id": "request123" } ``` **Example Contoh input: pesan JSON** ``` { "request": { "subject": "Message subject", "message": "{ \"default\": \"Message data\" }", "message_structure": "json" }, "id": "request123" } ``` ## Data output Komponen ini menerbitkan tanggapan sebagai data output pada topik MQTT berikut secara default. Anda harus menentukan topik ini sebagai `subject` dalam konfigurasi untuk [komponen router langganan warisan](legacy-subscription-router-component.md). Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md). **Topik default (AWS IoT Core MQTT):** `sns/message/status` **Example Contoh output: Berhasil** ``` { "response": { "sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a", "status": "success" }, "id": "request123" } ``` **Example Contoh output: Gagal** ``` { "response" : { "error": "InvalidInputException", "error_message": "SNS Topic Arn is invalid", "status": "fail" }, "id": "request123" } ``` ## File log lokal Komponen ini menggunakan file log berikut. ``` /greengrass/v2/logs/aws.greengrass.SNS.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.SNS.log ``` ## Lisensi Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut: + [AWS SDK untuk Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0 + [botocore](https://pypi.org/project/botocore/)/Apache License 2.0 + [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License + [docutils](https://pypi.org/project/docutils/)/BSD License, Lisensi Publik Umum (GPL) GNU, Lisensi Dasar Perangkat Lunak Python, Domain Publik + [jmespath](https://pypi.org/project/jmespath/)/MIT License + [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0 + [urllib3](https://pypi.org/project/urllib3/)/MIT License Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.1.10 | Versi diperbarui untuk Greengrass nucleus versi 2.15.0 rilis. | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.14.0 rilis. | | 2.1.8 | Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis. | | 2.1.7 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.6 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.4 | Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis. | | 2.1.3 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.2 | Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis. | | 2.1.1 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/sns-component.html) | | 2.0.8 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.7 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.6 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.5 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.4 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.3 | Versi awal. | # Manajer pengaliran Komponen pengelola aliran (`aws.greengrass.StreamManager`) memungkinkan Anda memproses aliran data untuk ditransfer ke perangkat inti AWS Cloud Greengrass. Untuk informasi lebih lanjut tentang cara mengonfigurasi dan menggunakan stream manager di komponen kustom, lihat [Kelola aliran data di perangkat inti Greengrass](manage-data-streams.md). **Topics** + [Versi](#stream-manager-component-versions) + [Tipe](#stream-manager-component-type) + [Sistem operasi](#stream-manager-component-os-support) + [Persyaratan](#stream-manager-component-requirements) + [Dependensi](#stream-manager-component-dependencies) + [Konfigurasi](#stream-manager-component-configuration) + [File log lokal](#stream-manager-component-log-file) + [Changelog](#stream-manager-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.3.x + 2.2.x + 2.1.x + 2.0.x **catatan** Jika Anda menggunakan pengelola aliran untuk mengekspor data ke cloud, Anda tidak dapat memutakhirkan versi 2.0.7 komponen pengelola aliran ke versi antara v2.0.8 dan v2.0.11. Jika Anda menerapkan pengelola aliran untuk pertama kalinya, kami sangat menyarankan agar Anda menerapkan versi terbaru komponen pengelola aliran. ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + [Peran pertukaran token](device-service-role.md) harus mengizinkan akses ke AWS Cloud tujuan yang Anda gunakan dengan pengelola aliran. Untuk informasi lebih lanjut, lihat: + [AWS IoT Analytics saluran](stream-export-configurations.md#export-to-iot-analytics) + [Amazon Kinesis data streams](stream-export-configurations.md#export-to-kinesis) + [AWS IoT SiteWise properti aset](stream-export-configurations.md#export-to-iot-sitewise) + [Objek Amazon S3](stream-export-configurations.md#export-to-s3) + Komponen pengelola aliran didukung untuk berjalan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan. + Komponen pengelola aliran harus memiliki konektivitas ke AWS layanan tempat Anda mempublikasikan data. + Amazon S3: `com.amazonaws.region.s3` + Aliran Data Amazon Kinesis: `com.amazonaws.region.kinesis-streams` + AWS IoT SiteWise: `com.amazonaws.region.iotsitewise.data` + Jika Anda mempublikasikan data ke Amazon S3 di `us-east-1` wilayah tersebut, komponen ini akan mencoba menggunakan titik akhir global S3 secara default; namun, titik akhir ini tidak tersedia melalui titik akhir antarmuka VPC Amazon S3. Untuk informasi selengkapnya, lihat [Pembatasan dan batasan AWS PrivateLink untuk Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/privatelink-interface-endpoints.html#privatelink-limitations). Untuk mengatasi ini, Anda dapat memilih dari opsi berikut. + Konfigurasikan komponen pengelola aliran untuk menggunakan titik akhir S3 regional di `us-east-1` wilayah tersebut, dengan menyiapkannya`-Daws.s3UseUsEast1RegionalEndpoint=regional`. `JVM_ARGS` + Buat titik akhir VPC gateway Amazon S3 alih-alih titik akhir VPC antarmuka Amazon S3. Titik akhir gateway S3 mendukung akses ke titik akhir global S3. Untuk informasi selengkapnya, lihat [Membuat titik akhir gateway](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html#create-gateway-endpoint-s3). ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `iotanalytics.region.amazonaws.com` | 443 | Tidak | Diperlukan jika Anda mempublikasikan data ke AWS IoT Analytics. | | `kinesis.region.amazonaws.com` | 443 | Tidak | Diperlukan jika Anda mempublikasikan data ke Firehose. | | `data.iotsitewise.region.amazonaws.com` | 443 | Tidak | Diperlukan jika Anda mempublikasikan data ke AWS IoT SiteWise. | | `*.s3.amazonaws.com` | 443 | Tidak | Diperlukan jika Anda mempublikasikan data ke bucket S3. Anda dapat mengganti `*` dengan nama setiap bucket tempat Anda mempublikasikan data. | ## 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](#stream-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.3 – 2.3.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.3 hingga 2.3.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.1.11 – 2.1.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.11 hingga 2.1.10 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.1.9 – 2.1.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.9 hingga 2.1.10 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.1.5 – 2.1.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.5 hingga 2.1.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.1.2 – 2.1.4 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.2 hingga 2.1.4 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.1.1 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.1.0 ] Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.0.15 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.15 dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.0.13 and 2.0.14 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.13 dan 2.0.14 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.0.11 and 2.0.12 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.11 dan 2.0.12 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.0.10 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.10 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.0.9 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.9 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.0.8 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.8 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ #### [ 2.0.7 ] Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Lunak | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | ------ Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `STREAM_MANAGER_STORE_ROOT_DIR` (Opsional) Path absolut dari direktori lokal yang digunakan untuk menyimpan pengaliran. Nilai ini harus dimulai dengan garis miring ke depan (misalnya, `/data`). Anda harus menentukan folder yang ada, dan [pengguna sistem yang menjalankan komponen manajer aliran](configure-greengrass-core-v2.md#configure-component-user) harus memiliki izin untuk membaca dan menulis ke folder ini. Misalnya, Anda dapat menjalankan perintah berikut untuk membuat dan mengkonfigurasi folder`/var/greengrass/streams`, yang Anda tentukan sebagai folder root stream manager. Perintah ini memungkinkan pengguna sistem default,`ggc_user`, untuk membaca dan menulis ke folder ini. ``` sudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streams ``` Default: `/greengrass/v2/work/aws.greengrass.StreamManager` `STREAM_MANAGER_SERVER_PORT` (Opsional) Nomor port lokal yang akan digunakan untuk berkomunikasi dengan stream manager. Anda dapat menentukan `0` untuk menggunakan port yang tersedia secara acak. Default: `8088` `STREAM_MANAGER_AUTHENTICATE_CLIENT` (Opsional) Anda dapat membuatnya wajib bagi klien untuk melakukan autentikasi sebelum mereka dapat berinteraksi dengan stream manager. Stream Manager SDK mengontrol interaksi antara klien dan manajer aliran. Parameter ini menentukan klien mana yang dapat memanggil Manajer Pengaliran untuk bekerja dengan pengaliran. Untuk informasi selengkapnya, lihat [autentikasi klien stream manager](manage-data-streams.md#stream-manager-security-client-authentication). Jika Anda menentukan`true`, Stream Manager SDK hanya mengizinkan komponen Greengrass sebagai klien. Jika Anda menentukan`false`, Stream Manager SDK memungkinkan semua proses pada perangkat inti menjadi klien. Default: `true` `STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH` (Opsional) Bandwidth maksimum rata-rata (dalam kilobit per detik) yang dapat digunakan oleh pengelola pengaliran untuk mengekspor data. Default: Tanpa batas `STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE` (Opsional) Jumlah maksimum utas aktif yang dapat digunakan stream manager untuk mengekspor data. Ukuran optimal tergantung pada perangkat keras Anda, volume aliran, dan jumlah yang direncanakan dari aliran ekspor. Jika kecepatan ekspor lambat, Anda dapat menyesuaikan pengaturan ini untuk menemukan ukuran optimal untuk perangkat keras dan kasus bisnis Anda. CPU dan memori perangkat keras inti Anda merupakan faktor pembatas. Untuk memulai, Anda dapat mencoba menetapkan nilai ini sama dengan jumlah inti prosesor pada perangkat. Hati-hati untuk tidak menetapkan ukuran yang lebih tinggi dari yang dapat didukung perangkat keras Anda. Setiap aliran mengonsumsi sumber daya perangkat keras, jadi cobalah untuk membatasi jumlah aliran ekspor pada perangkat yang dibatasi. Default: 5 utas `STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES` (Opsional) Ukuran minimum (dalam byte) dari bagian dalam unggahan multipart ke Amazon S3. Stream manager menggunakan pengaturan ini dan ukuran file inputnya untuk menentukan bagaimana melakukan batch data dalam permintaan PUT multipart. Stream manager menggunakan properti aliran `sizeThresholdForMultipartUploadBytes` untuk menentukan apakah akan mengekspor ke Amazon S3 sebagai unggahan tunggal atau multipart. Komponen AWS IoT Greengrass dapat mengatur ambang batas ini ketika membuat aliran yang diekspor ke Amazon S3. Default: `5242880` (5 MB). Ini juga merupakan nilai minimum. `LOG_LEVEL` (Opsional) Tingkat logging untuk komponen. Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat: + `TRACE` + `DEBUG` + `INFO` + `WARN` + `ERROR` Default: `INFO` `JVM_ARGS` (Opsional) Argumen Mesin Virtual Java kustom yang akan disampaikan ke stream manager saat startup. Pisahkan beberapa argumen dengan spasi. Gunakan parameter ini hanya ketika Anda harus menimpa pengaturan default yang digunakan oleh JVM. Misalnya, Anda mungkin perlu meningkatkan ukuran timbunan default jika berencana mengekspor sejumlah besar pengaliran. `startupTimeoutSeconds` (Opsional) Maksimum waktu dalam hitungan detik untuk memulai komponen. Status komponen berubah menjadi `ERRORED` jika melebihi batas waktu ini. Default: `120` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk menggunakan port non-default. ``` { "STREAM_MANAGER_SERVER_PORT": "18088" } ``` ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.greengrass.StreamManager.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.greengrass.StreamManager.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.StreamManager.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.greengrass.StreamManager.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.11 | Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. | | 2.1.10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.9 | Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. | | 2.1.8 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.5 | Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. | | 2.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.1.1 | Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.0.15 | Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. | | 2.0.14 | Versi ini berisi perbaikan bug dan perbaikan. | | 2.0.13 | Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. | | 2.0.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/stream-manager-component.html) | | 2.0.11 | Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. | | 2.0.10 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0. | | 2.0.9 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0. | | 2.0.8 | Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0. | | 2.0.7 | Versi awal. | # Forwarder log sistem System log forwarder (`aws.greengrass.SystemLogForwarder`) mengunggah log sistem aktif langsung ke Amazon CloudWatch menggunakan HTTPS API. CloudWatch **penting** Komponen ini hanya akan meneruskan log systemd-journald yang dihasilkan selama runtime. [Untuk informasi selengkapnya tentang log systemd-journald, lihat [systemd-journald](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html) dan journalctl.](https://www.freedesktop.org/software/systemd/man/latest/journalctl.html#) **catatan** Komponen ini memerlukan izin khusus untuk membuat dan mengelola grup dan aliran CloudWatch log. **Topics** + [Versi](#system-log-forwarder-component-versions) + [Jenis](#system-log-forwarder-component-type) + [Sistem operasi](#system-log-forwarder-component-os-support) + [Persyaratan](#system-log-forwarder-component-requirements) + [Titik akhir dan port](#system-log-forwarder-component-endpoints) + [Dependensi](#system-log-forwarder-component-dependencies) + [Konfigurasi](#system-log-forwarder-component-configuration) + [Changelog](#system-log-forwarder-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.1.x + 2.0.x ## Jenis Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini harus diinstal pada sistem Linux berbasis sistem. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: Komponen ini memerlukan akses untuk membuat log dan grup streaming CloudWatch serta izin untuk melakukan panggilan PutLogEvents HTTP. Anda harus, setidaknya, menambahkan izin kebijakan berikut ke alias peran perangkat Greengrass Anda: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": ["logs:CreateLogGroup"], "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:*" }, { "Effect": "Allow", "Action": ["logs:CreateLogStream", "logs:PutLogEvents"], "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:log-stream:${credentials-iot:ThingName}" } ] } ``` ------ **catatan** Untuk informasi selengkapnya, lihat halaman [Github](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) System Log Forwarder. ## 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `logs.region.amazonaws.com` | 443 | Tidak | Diperlukan jika Anda menulis log ke CloudWatch Log. | ## 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](#system-log-forwarder-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. ------ #### [ 2.1.x ] Tabel berikut mencantumkan dependensi untuk versi 2.1.x dari komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Layanan penukaran Token](token-exchange-service-component.md) | >=2.0.0 | Keras | | [Greengrass nucleus lite](greengrass-nucleus-lite-component.md) | >=2.3.0 | Lunak | ------ #### [ 2.0.x ] Tabel berikut mencantumkan dependensi untuk versi 2.0.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Layanan penukaran Token](token-exchange-service-component.md) | >=2.0.0 | Keras | ------ ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. ------ #### [ 2.0.x-2.1.x ] `maxUploadIntervalSec` Periode maksimum di mana pengirim log sistem akan mencoba mengunggah log. Karena log forwarder akan mengunggah log ketika memori terisi, mungkin masih mengunggah lebih sering daripada irama maksimum yang dikonfigurasi. `maxRetriesCount` Berapa kali sistem log forwarder akan mencoba untuk mencoba lagi kesalahan HTTP sementara. `bufferCapacity` Ukuran buffer cincin untuk penyimpanan log dalam memori. `logGroup` Jalur log masuk CloudWatch. `logStream` CloudWatch LogStream. `filters` Peta konfigurasi filter untuk perangkat inti. `services` Daftar filter nama layanan yang akan digunakan oleh System Log Forwarder untuk menentukan log mana yang akan diunggah. Log hanya akan diunggah jika layanan asalnya cocok dengan setidaknya salah satu filter dalam daftar ini. Filter dalam daftar ini dapat berupa string yang nama layanan harus sepenuhnya cocok, atau string yang diakhiri dengan \$1, yang berarti awalan harus cocok. Default: `[ggl.*]` Log hanya akan diunggah jika layanan asalnya cocok dengan setidaknya salah satu filter dalam daftar ini. Menggunakan nilai\$1 akan mencakup semua layanan yang tersedia. **Example Contoh konfigurasi:** Contoh di bawah ini akan memfilter log berdasarkan semua layanan yang disertakan dalam Greengrass Nucleus Lite. ``` { "maxUploadIntervalSec": 300, "maxRetriesCount": 3, "bufferCapacity": 1048576, "logGroup": "greengrass/systemLogs", "logStream": "deviceName", "filters": { "services": ["ggl.*"] } } ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/system-log-forwarder-component.html) | | 2.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/system-log-forwarder-component.html) | | 2.0.0 | Versi awal. | # Agen Systems Manager Komponen AWS Systems Manager Agen (`aws.greengrass.SystemsManagerAgent`) menginstal Agen Systems Manager, sehingga Anda dapat mengelola perangkat inti dengan Systems Manager. Systems Manager adalah AWS layanan yang dapat Anda gunakan untuk melihat dan mengontrol infrastruktur AWS, termasuk EC2 instans Amazon, server lokal, dan mesin virtual (VMs), dan perangkat edge. Systems Manager memungkinkan Anda untuk melihat data operasional, mengotomatiskan tugas operasi, dan menjaga keamanan dan kepatuhan. Untuk informasi lebih lanjut, lihat [Apa itu AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) dan [Tentang Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) di *Panduan AWS Systems Manager Pengguna*. Alat dan fitur Systems Manager disebut *kemampuan*. Perangkat inti Greengrass mendukung semua kemampuan Systems Manager. Untuk informasi selengkapnya tentang kemampuan ini dan cara menggunakan Systems Manager untuk mengelola perangkat inti, lihat [kemampuan Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) di *Panduan AWS Systems Manager Pengguna*. **Topics** + [Versi](#systems-manager-agent-component-versions) + [Tipe](#systems-manager-agent-component-type) + [Sistem operasi](#systems-manager-agent-component-os-support) + [Persyaratan](#systems-manager-agent-component-requirements) + [Dependensi](#systems-manager-agent-component-dependencies) + [Konfigurasi](#systems-manager-agent-component-configuration) + [Berkas log lokal](#systems-manager-agent-component-log-file) + [Lihat juga](#systems-manager-agent-component-see-also) + [Changelog](#systems-manager-agent-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 1.3.x + 1.2.x + 1.1.x + 1.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini hanya dapat diinstal pada perangkat inti Linux. ## Persyaratan Komponen ini memiliki persyaratan sebagai berikut: + Perangkat inti Greengrass yang berjalan pada platform Linux 64-bit: Armv8 () atau x86\$164. AArch64 + Anda harus memiliki peran layanan AWS Identity and Access Management (IAM) yang dapat diasumsikan oleh Systems Manager. Peran ini harus menyertakan kebijakan SSMManaged InstanceCore terkelola [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) atau kebijakan khusus yang menentukan izin yang setara. Untuk informasi selengkapnya, lihat [Membuat peran layanan IAM untuk perangkat edge](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices.html#systems-manager-setting-up-edge-devices-service-role) di *Panduan AWS Systems Manager Pengguna*. Saat menerapkan komponen ini, Anda harus menentukan nama peran ini untuk parameter `SSMRegistrationRole` konfigurasi. + [Peran perangkat Greengrass harus memungkinkan](device-service-role.md) dan tindakan. `ssm:AddTagsToResource` `ssm:RegisterManagedInstance` Peran perangkat juga harus memungkinkan `iam:PassRole` tindakan untuk peran layanan IAM yang memenuhi persyaratan sebelumnya. Contoh berikut kebijakan IAM memberikan izin ini. ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "iam:PassRole" ], "Effect": "Allow", "Resource": [ "arn:aws:iam::account-id:role/SSMServiceRole" ] }, { "Action": [ "ssm:AddTagsToResource", "ssm:RegisterManagedInstance" ], "Effect": "Allow", "Resource": "*" } ] } ``` ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `ec2messages.region.amazonaws.com` | 443 | Ya | Berkomunikasi dengan layanan Systems Manager di AWS Cloud. | | `ssm.region.amazonaws.com` | 443 | Ya | Daftarkan perangkat inti sebagai node terkelola Systems Manager. | | `ssmmessages.region.amazonaws.com` | 443 | Ya | Berkomunikasi dengan Session Manager, kemampuan Systems Manager, di AWS Cloud. | *Untuk informasi selengkapnya, lihat [Referensi: ec2messages, ssmmessages, dan panggilan API lainnya di Panduan Pengguna](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-messageAPIs.html).AWS Systems Manager * ## 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](#systems-manager-agent-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. Tabel berikut mencantumkan dependensi untuk versi 1.0.0 hingga 1.3.0 komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Layanan pertukaran Token](token-exchange-service-component.md) | >=2.0.0 <3.0.0 | Keras | Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `SSMRegistrationRole` Peran layanan IAM yang dapat diasumsikan oleh Systems Manager dan yang mencakup kebijakan SSMManaged InstanceCore terkelola [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) atau kebijakan kustom yang menentukan izin yang setara. Untuk informasi selengkapnya, lihat [Membuat peran layanan IAM untuk perangkat edge](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices-service-role.html) di *Panduan AWS Systems Manager Pengguna*. `SSMOverrideExistingRegistration` (Opsional) Jika perangkat inti sudah menjalankan Agen Systems Manager yang terdaftar dengan aktivasi hibrida, Anda dapat mengganti pendaftaran Agen Systems Manager perangkat yang ada. Setel opsi ini `true` untuk mendaftarkan perangkat inti sebagai node terkelola menggunakan Agen Systems Manager yang disediakan komponen ini. Opsi ini hanya berlaku untuk perangkat yang terdaftar dengan aktivasi hibrida. Jika perangkat inti berjalan pada EC2 instans Amazon dengan Agen Systems Manager diinstal dan peran profil instans dikonfigurasi, ID node terkelola EC2 instans Amazon yang sudah ada akan dimulai dengan`i-`. Saat Anda menginstal komponen Systems Manager Agent, agen Systems Manager mendaftarkan node terkelola baru yang ID-nya dimulai dengan `mi-` alih-alih. `i-` Kemudian, Anda dapat menggunakan node terkelola yang IDnya dimulai `mi-` untuk mengelola perangkat inti dengan Systems Manager. Default: `false` `SSMResourceTags` (Opsional) Tag untuk ditambahkan ke node terkelola Systems Manager yang dibuat komponen ini untuk perangkat inti. Anda dapat menggunakan tag ini untuk mengelola grup perangkat inti dengan Systems Manager. Misalnya, Anda dapat menjalankan perintah di semua perangkat yang memiliki tag yang Anda tentukan. Tentukan daftar di mana setiap tag adalah objek dengan a `Key` dan a`Value`. Misalnya, nilai berikut untuk `SSMResourceTags` menginstruksikan komponen ini untuk menyetel **Owner** tag **richard-roe** pada node terkelola perangkat inti. ``` [ { "Key": "Owner", "Value": "richard-roe" } ] ``` Komponen ini mengabaikan tag ini jika node terkelola sudah ada dan `SSMOverrideExistingRegistration` sudah ada. `false` **Example Contoh: Pembaruan gabungan konfigurasi** Contoh konfigurasi berikut menentukan untuk menggunakan peran layanan bernama `SSMServiceRole` untuk memungkinkan perangkat inti untuk mendaftar dan berkomunikasi dengan Systems Manager. ``` { "SSMRegistrationRole": "SSMServiceRole", "SSMOverrideExistingRegistration": false, "SSMResourceTags": [ { "Key": "Owner", "Value": "richard-roe" }, { "Key": "Team", "Value": "solar" } ] } ``` ## Berkas log lokal Perangkat lunak Systems Manager Agent menulis log ke folder di luar folder root Greengrass. Untuk informasi selengkapnya, lihat [Melihat log Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html) di *Panduan AWS Systems Manager Pengguna*. Komponen Systems Manager Agent menggunakan skrip shell untuk menginstal, memulai, dan menghentikan Agen Systems Manager. Anda dapat menemukan output dari skrip ini di file log berikut. ``` /greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log ``` **Untuk melihat log komponen ini** + Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ``` sudo tail -f /greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log ``` ## Lihat juga + [Kelola perangkat inti Greengrass dengan AWS Systems Manager](manage-with-systems-manager.md) + [Apa itu AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) dalam *AWS Systems Manager Panduan Penggguna* + [Tentang Agen Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) di *Panduan AWS Systems Manager Pengguna* ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 1.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/systems-manager-agent-component.html) | | 1.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/systems-manager-agent-component.html) | | 1.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/systems-manager-agent-component.html) | | 1.1.0 | Versi ini berisi perbaikan bug dan perbaikan. | | 1.0.0 | Versi awal. | # Layanan pertukaran token Komponen layanan pertukaran token (`aws.greengrass.TokenExchangeService`) menyediakan AWS kredensil yang dapat Anda gunakan untuk berinteraksi dengan AWS layanan di komponen kustom Anda. Layanan pertukaran token berjalan sebagai server lokal. [Server lokal ini terhubung ke penyedia AWS IoT kredensial menggunakan alias AWS IoT peran yang Anda konfigurasikan dalam komponen inti inti Greengrass.](greengrass-nucleus-component.md) Komponen ini menyediakan dua variabel lingkungan, `AWS_CONTAINER_CREDENTIALS_FULL_URI` dan`AWS_CONTAINER_AUTHORIZATION_TOKEN`. `AWS_CONTAINER_CREDENTIALS_FULL_URI`mendefinisikan URI ke server lokal ini. Saat komponen membuat klien AWS SDK, klien mengenali variabel lingkungan URI ini dan menggunakan token di dalamnya `AWS_CONTAINER_AUTHORIZATION_TOKEN` untuk terhubung ke layanan pertukaran token dan mengambil AWS kredensil. Hal ini memungkinkan perangkat inti Greengrass untuk memanggil operasi layanan AWS . Untuk informasi lebih lanjut tentang cara menggunakan komponen dalam komponen kustom Anda, lihat [Berinteraksi dengan AWS layanan](interact-with-aws-services.md). **penting** Support untuk memperoleh AWS kredensil dengan cara ini ditambahkan AWS SDKs pada tanggal 13 Juli 2016. Komponen Anda harus menggunakan versi AWS SDK yang dibuat pada atau setelah tanggal tersebut. Untuk informasi selengkapnya, lihat [Menggunakan AWS SDK yang didukung](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html#task-iam-roles-minimum-sdk) di *Panduan Pengembang Layanan Amazon Elastic Container*. **catatan** Komponen yang menggunakan Rantai Kredenal AWS Default dapat menemukan dan menggunakan sumber kredensil lain, jika ada. Di dalam Amazon Amazon Elastic Container Service (Amazon ECS), `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI` kredenal kontainer Elastic Container Service (Amazon ECS) akan `AWS_CONTAINER_CREDENTIALS_FULL_URI` lebih diutamakan, yang berarti bahwa kredensil layanan pertukaran token mungkin tidak berfungsi dalam Amazon Elastic Container Service (Amazon ECS). Untuk selengkapnya, lihat penyedia [kredensi standar](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) **Topics** + [Versi](#token-exchange-service-component-versions) + [Tipe](#token-exchange-service-component-type) + [Sistem operasi](#token-exchange-service-component-os-support) + [Dependensi](#token-exchange-service-component-dependencies) + [Konfigurasi](#token-exchange-service-component-configuration) + [File log lokal](#token-exchange-service-component-log-file) + [Changelog](#token-exchange-service-component-changelog) ## Versi Komponen ini memiliki versi berikut: + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## Sistem operasi Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut: + Linux + Windows ## Dependensi Komponen ini tidak memiliki dependensi apa pun. ## Konfigurasi Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen. `port` Port yang digunakan untuk koneksi layanan pertukaran token. Layanan pertukaran token akan dimulai ulang setelah konfigurasi port berubah. `credentialRetryInSec` Menentukan interval coba lagi dalam hitungan detik saat Token Exchange Service mengalami kesalahan permintaan kredenal. `clientError` Interval coba lagi dalam hitungan detik untuk kesalahan klien (kode status HTTP 4xx). Default: `120` Nilai valid: `10` hingga `42900` `serverError` Interval coba lagi dalam hitungan detik untuk kesalahan server (kode status HTTP 5xx). Default: `60` Nilai valid: `10` hingga `42900` `unknownError` Interval coba lagi dalam hitungan detik untuk kesalahan yang tidak diketahui (kesalahan koneksi dan kode status HTTP di luar rentang 4xx dan 5xx). Default: `300` Nilai valid: `10` hingga `42900` **Example Contoh: Pembaruan gabungan konfigurasi** ``` { "port": 2020, "credentialRetryInSec": { "clientError": 30, "serverError": 45, "unknownError": 60 } } ``` ## File log lokal Komponen ini menggunakan file log yang sama dengan komponen inti [Greengrass](greengrass-nucleus-component.md). ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 2.0.3 | Versi awal. | # Kolektor IoT SiteWise OPC UA Komponen kolektor IoT SiteWise OPC UA (`aws.iot.SiteWiseEdgeCollectorOpcua`) memungkinkan AWS IoT SiteWise gateway untuk mengumpulkan data dari server OPC UA lokal. Dengan komponen ini, AWS IoT SiteWise gateway dapat terhubung ke beberapa server OPC UA. Untuk informasi selengkapnya tentang AWS IoT SiteWise gateway, lihat [Menggunakan AWS IoT SiteWise di tepi](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) di *AWS IoT SiteWise Panduan Pengguna*. **Topics** + [Versi](#iotsitewise-opcua-collector-component-versions) + [Tipe](#iotsitewise-opcua-collector-component-type) + [Sistem operasi](#iotsitewise-opcua-collector-component-os-support) + [Persyaratan](#iotsitewise-opcua-collector-component-requirements) + [Dependensi](#iotsitewise-opcua-collector-component-dependencies) + [Konfigurasi](#iotsitewise-opcua-collector-component-configuration) + [Masukan data](#iotsitewise-opcua-collector-component-input-data) + [Data output](#iotsitewise-opcua-collector-component-output-data) + [File log lokal](#iotsitewise-opcua-collector-component-log-file) + [Lisensi](#iotsitewise-opcua-collector-component-licenses) + [Changelog](#iotsitewise-opcua-collector-component-changelog) + [Lihat juga](#iotsitewise-opcua-collector-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 3.1.x + 3.0.x + 2.6.x + 2.5.x + 2.4.x + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## 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 yang lebih baru arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64) + OS: Red Hat Enterprise Linux (RHEL) 8 arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64) + sistem operasi: Amazon Linux 2 arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64) + os: Debian 11 arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64) + os: Windows Server 2019 atau yang lebih baru arsitektur: x86\$164 () AMD64 + Perangkat inti Greengrass harus memungkinkan konektivitas jaringan keluar ke server OPC UA. ## 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](#iotsitewise-opcua-collector-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. Tabel berikut mencantumkan dependensi untuk semua versi komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.3.0 <3.0.0 | Keras | | [Manajer pengaliran](stream-manager-component.md) | > 2.0.10 <3.0.0 | Keras | | [Secrets manager](secret-manager-component.md) | >=2.0.8 <3.0.0 | Keras | Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. Anda dapat menggunakan AWS IoT SiteWise konsol atau API untuk mengonfigurasi komponen kolektor IoT SiteWise OPC UA. Untuk informasi selengkapnya, lihat [Langkah 4: Menambahkan sumber data - opsional](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#add-data-sources-console) di *Panduan AWS IoT SiteWise Pengguna*. ## Masukan data Komponen ini hanya menerima data dalam format berikut, semua yang lain akan diabaikan dan dibuang. Tabel di bawah ini memetakan tipe data OPC UA ke SiteWise padanannya. | **SiteWise tipe data** | **Jenis data OPC UA** | **Deskripsi** | | --- | --- | --- | | `STRING` | `String` `Guid` `XmlElement` | Sebuah string panjang maksimum 1024 byte. | | `INTEGER` | `SByte` `Byte` `Int16` `UInt16` `Int32` `UInt32`\$1 `Int64`\$1 | Integer 32-bit yang ditandatangani dengan rentang dari. `-2,147,483,648 to 2,147,483,647` | | `DOUBLE` | `UInt32`\$1 `Int64`\$1 `Float` `Double` | Nomor floating point dengan rentang dari `–10^100 to 10^100` dan presisi `IEEE 754` ganda. | | `BOOLEAN` | `Boolean` | `true` atau `false`. | \$1 Untuk tipe data OPC UA `UInt32` dan`Int64`, tipe SiteWise datanya akan `INTEGER` jika SiteWise mampu mewakili nilainya, jika tidak maka akan menjadi`DOUBLE`. ## Data output Komponen ini menulis `BatchPutAssetPropertyValue` pesan ke manajer AWS IoT Greengrass streaming. Untuk informasi selengkapnya, lihat [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) di dalam *Referensi API AWS IoT SiteWise *. ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait ``` ------ ## Lisensi Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 3.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 3.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 3.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.4.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.4.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) | | 2.0.3 | Perbaikan bug dan perbaikan. | | 2.0.2 | Perbaikan bug dan peningkatan sinkronisasi prioritas aset dengan edge. | | 2.0.1 | Versi awal. | ## Lihat juga + [Apa itu AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) dalam *AWS IoT SiteWise User Guide*. # Simulator sumber data IoT SiteWise OPC UA Komponen simulator sumber data IoT SiteWise OPC UA (`aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator`) memulai server OPC UA lokal yang menghasilkan data sampel. Gunakan server OPC UA ini untuk mensimulasikan sumber data yang dibaca oleh komponen [kolektor IoT SiteWise OPC UA](iotsitewise-opcua-collector-component.md) pada gateway. AWS IoT SiteWise Kemudian, Anda dapat menjelajahi AWS IoT SiteWise fitur menggunakan data sampel ini. Untuk informasi selengkapnya tentang AWS IoT SiteWise gateway, lihat [Menggunakan AWS IoT SiteWise di tepi](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) di *AWS IoT SiteWise Panduan Pengguna*. **Topics** + [Versi](#iotsitewise-opcua-data-source-simulator-component-versions) + [Tipe](#iotsitewise-opcua-data-source-simulator-component-type) + [Sistem operasi](#iotsitewise-opcua-data-source-simulator-component-os-support) + [Persyaratan](#iotsitewise-opcua-data-source-simulator-component-requirements) + [Dependensi](#iotsitewise-opcua-data-source-simulator-component-dependencies) + [Konfigurasi](#iotsitewise-opcua-data-source-simulator-component-configuration) + [Berkas log lokal](#iotsitewise-opcua-data-source-simulator-component-log-file) + [Changelog](#iotsitewise-opcua-data-source-simulator-component-changelog) + [Lihat juga](#iotsitewise-opcua-data-source-simulator-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 1.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## 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 dapat menggunakan port 4840 pada host lokal. Server OPC UA lokal komponen ini berjalan di port ini. ## 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](#iotsitewise-opcua-data-source-simulator-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. Tabel berikut mencantumkan dependensi untuk semua versi komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.3.0 <3.0.0 | Keras | Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. ## Berkas log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log -Tail 10 -Wait ``` ------ ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 1.0.0 | Versi awal. Menambahkan dukungan untuk Windows Server 2016 atau lebih tinggi. | ## Lihat juga + [Apa itu AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) dalam *AWS IoT SiteWise User Guide*. # Penerbit IoT SiteWise Komponen SiteWise penerbit IoT (`aws.iot.SiteWiseEdgePublisher`) memungkinkan AWS IoT SiteWise gateway untuk mengekspor data dari tepi ke. AWS Cloud Untuk informasi selengkapnya tentang AWS IoT SiteWise gateway, lihat [Menggunakan AWS IoT SiteWise di tepi](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) di *AWS IoT SiteWise Panduan Pengguna*. **Topics** + [Versi](#iotsitewise-publisher-component-versions) + [Tipe](#iotsitewise-publisher-component-type) + [Sistem operasi](#iotsitewise-publisher-component-os-support) + [Persyaratan](#iotsitewise-publisher-component-requirements) + [Dependensi](#iotsitewise-publisher-component-dependencies) + [Konfigurasi](#iotsitewise-publisher-component-configuration) + [Data input](#iotsitewise-publisher-component-input-data) + [File log lokal](#iotsitewise-publisher-component-log-file) + [Pemecahan masalah dan debugging](#iotsitewise-publisher-component-debug) + [Lisensi](#iotsitewise-publisher-component-licenses) + [Changelog](#iotsitewise-publisher-component-changelog) + [Lihat juga](#iotsitewise-publisher-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 4.1.x + 4.0.x + 3.2.x + 3.1.x + 3.0.x + 2.4.x + 2.3.x + 2.2.x + 2.1.x + 2.0.x ## Tipe Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## 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 18.04 atau yang lebih baru arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64) + OS: Red Hat Enterprise Linux (RHEL) 8 arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64) + sistem operasi: Amazon Linux 2 arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64) + os: Debian 11 arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64) + os: Windows Server 2019 atau yang lebih baru arsitektur: x86\$164 () AMD64 + Perangkat inti Greengrass harus terhubung ke Internet. + Perangkat inti Greengrass harus diberi wewenang untuk melakukan tindakan. `iotsitewise:BatchPutAssetPropertyValue` Untuk informasi selengkapnya, lihat [Mengotorisasi perangkat inti untuk berinteraksi dengan AWS layanan](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html). **Example kebijakan izin** ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*" } ] } ``` ------ ### 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | Deskripsi | | --- | --- | --- | --- | | `data.iotsitewise.region.amazonaws.com` | 443 | Ya | Publikasikan data ke AWS IoT SiteWise. | ## 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](#iotsitewise-publisher-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**. Tabel berikut mencantumkan dependensi untuk versi 2.0.x hingga 2.2.x komponen ini. | Dependensi | Versi yang kompatibel | Jenis dependensi | | --- | --- | --- | | [Inti Greengrass](greengrass-nucleus-component.md) | >=2.3.0<3.0.0 | Keras | | [Manajer pengaliran](stream-manager-component.md) | >=2.0.10 <3.0.0 | Keras | Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## Konfigurasi Komponen ini tidak memiliki parameter konfigurasi apapun. Anda dapat menggunakan AWS IoT SiteWise konsol atau API untuk mengonfigurasi komponen SiteWise penerbit IoT. Untuk informasi selengkapnya, lihat [Langkah 3: Mengkonfigurasi penerbit - opsional](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#configure-publisher) di *Panduan AWS IoT SiteWise Pengguna*. ## Data input Komponen ini membaca `PutAssetPropertyValueEntry` pesan dari manajer AWS IoT Greengrass aliran. Untuk informasi selengkapnya, lihat [PutAssetPropertyValueEntry](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html) di dalam *Referensi API AWS IoT SiteWise *. ## File log lokal Komponen ini menggunakan file log berikut. ------ #### [ Linux ] ``` /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.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:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait ``` ------ ## Pemecahan masalah dan debugging Komponen ini mencakup log peristiwa baru untuk membantu pelanggan mengidentifikasi dan memperbaiki masalah. File log terpisah dari file log lokal, dan ditemukan di lokasi berikut. Ganti `/greengrass/v2` atau *C:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux ] ``` /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log ``` ------ Log ini mencakup informasi terperinci dan instruksi pemecahan masalah. Informasi pemecahan masalah disediakan bersama diagnostik, dengan deskripsi tentang cara memperbaiki masalah, dan terkadang dengan tautan ke informasi lebih lanjut. Informasi diagnostik meliputi: + Tingkat kepelikan + Stempel waktu + Informasi khusus acara tambahan **Example Contoh log** ``` accountBeingThrottled: Summary: Data upload speed slowed due to quota limits Level: WARN Timestamp: '2023-06-09T21:30:24.654Z' Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested" quota for a customers account. See the associated documentation and associated metric for the number of requests that were limited for more information. Note that this may be temporary and not require any change, although if the issue continues you may need to request an increase for the mentioned quota. FurtherInformation: - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams AssociatedMetrics: - Name: TotalErrorCount Description: The total number of errors of this type that occurred. Value: 327724.0 AssociatedData: - Name: AggregatePropertyAliases Description: The aggregated property aliases of the throttled data. FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log ``` ## Lisensi Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 4.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 4.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 4.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 4.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 4.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 4.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 4.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 4.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 4.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 3.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 3.1.4 | Versi 3.1.4 dihentikan pada 20 Februari 2025. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 3.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 3.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 3.1.1 | Versi 3.1.1 dihentikan pada 12 Maret 2024. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.4.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.3.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.2.1 | Versi ini tidak mendukung konfigurasi proxy HTTP. Versi 2.2.2 dan yang lebih tinggi memperkenalkan kembali dukungan untuk fitur ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.2.0 | Versi ini tidak mendukung konfigurasi proxy HTTP. Versi 2.2.2 dan yang lebih tinggi memperkenalkan kembali dukungan untuk fitur ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.1.3 | Versi ini tidak lagi tersedia, kecuali di Wilayah AS Timur (Ohio), Kanada (Tengah), dan AWS GovCloud (AS-Timur). Versi komponen ini membutuhkan Java versi 11 atau lebih untuk dijalankan. Perbaikan dalam versi ini tersedia di versi yang lebih baru dari komponen ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.1.1 | Perbaikan bug dan perbaikan. | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-publisher-component.html) | | 2.0.2 | Perbaikan bug dan perbaikan. | | 2.0.1 | Versi awal. | ## Lihat juga + [Apa itu AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) dalam *AWS IoT SiteWise User Guide*. # Prosesor IoT SiteWise Komponen SiteWise prosesor IoT (`aws.iot.SiteWiseEdgeProcessor`) memungkinkan aliran AWS IoT SiteWise Klasik, gateway V2 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](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) di *AWS IoT SiteWise Panduan Pengguna*. **catatan** Fitur paket pemrosesan data (DPP) tidak akan lagi terbuka untuk pelanggan baru mulai 7 November 2025. Jika Anda ingin menggunakan DPP, daftarlah sebelum tanggal tersebut. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [Perubahan ketersediaan paket pemrosesan data](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html) di *Panduan AWS IoT SiteWise Pengguna*. **Topics** + [Versi](#iotsitewise-processor-component-versions) + [Jenis](#iotsitewise-processor-component-type) + [Sistem operasi](#iotsitewise-processor-component-os-support) + [Persyaratan](#iotsitewise-processor-component-requirements) + [Dependensi](#iotsitewise-processor-component-dependencies) + [Konfigurasi](#iotsitewise-processor-component-configuration) + [File log lokal](#iotsitewise-processor-component-log-file) + [Lisensi](#iotsitewise-processor-component-licenses) + [Changelog](#iotsitewise-processor-component-changelog) + [Lihat juga](#iotsitewise-processor-component-see-also) ## Versi Komponen ini memiliki versi berikut: + 3.5.x + 3.4.x + 3.3.x + 3.2.x + 3.1.x + 3.0.x + 2.2.x + 2.1.x + 2.0.x ## Jenis Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen. Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types). ## 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 yang lebih baru arsitektur: x86\$164 () AMD64 + OS: Red Hat Enterprise Linux (RHEL) 8 arsitektur: x86\$164 () AMD64 + sistem operasi: Amazon Linux 2 arsitektur: x86\$164 () AMD64 + os: Windows Server 2019 atau yang lebih baru arsitektur: x86\$164 () AMD64 + os: Debian 11 (Bullseye) atau yang lebih baru arsitektur: x86\$164 () 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html) Anda. AWS IoT SiteWise AWS IoT Greengrass V2 Untuk informasi selengkapnya, lihat [Persyaratan](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway-ggv2.html#gateway-requirements) 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](allow-device-traffic.md). | Titik akhir | Port | Diperlukan | 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](#iotsitewise-processor-component-changelog) 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](https://console.aws.amazon.com//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 penukaran Token](token-exchange-service-component.md) | >=2.0.3 <3.0.0 | Keras | | [Manajer pengaliran](stream-manager-component.md) | >=2.0.10 <3.0.0 | Keras | | [CLI Greengrass](greengrass-cli-component.md) | >=2.3.0 <3.0.0 | Keras | Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies). ## 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:\$1greengrass\$1v2* 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: ### Lisensi Pihak Ketiga + Apache-2.0 + MIT + BSD-2-klausul + BSD-3-klausul + CDDL-1.0 + CDDL-1.1 + ISC + Zlib + GPL-3.0-dengan-GCC-pengecualian + Domain Publik + Python-2.0 + Unicode-DFS-2015 + BSD-1-klausul + OpenSSL + 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](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi komponen. | **Versi** | **Perubahan** | | --- | --- | | 3.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.37 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.35 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.34 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.33 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.32 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.31 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.29 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.28 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.24 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.23 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.1.21 | Upgrade dari 2.0.x ke 2.1.x akan mengakibatkan hilangnya data lokal. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.16 | Versi ini berisi perbaikan bug dan perbaikan. | | 2.0.15 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.14 | Versi ini berisi perbaikan bug dan perbaikan. | | 2.0.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/iotsitewise-processor-component.html) | | 2.0.2 | Versi awal. | ## Lihat juga + [Apa itu AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) dalam *AWS IoT SiteWise User Guide*.