Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Penebangan dan pemantauan di AWS IoT Greengrass Pemantauan adalah bagian penting dari menjaga keandalan, ketersediaan, dan kinerja AWS IoT Greengrass dan AWS solusi Anda. Anda harus mengumpulkan data pemantauan dari semua bagian AWS solusi Anda sehingga Anda dapat lebih mudah men-debug kegagalan multi-titik, jika terjadi. Sebelum Anda mulai memantau AWS IoT Greengrass, Anda harus membuat rencana pemantauan yang mencakup jawaban atas pertanyaan-pertanyaan berikut: + Apa tujuan pemantauan Anda? + Sumber daya manakah yang akan Anda pantau? + Seberapa seringkah Anda akan memantau sumber daya ini? + Apa sajakah alat pemantauan yang akan Anda gunakan? + Siapa yang akan melakukan tugas pemantauan? + Siapa yang harus diberi tahu saat terjadi kesalahan? **Topics** + [Alat pemantauan](#monitoring-tools) + [Memantau AWS IoT Greengrass log](monitor-logs.md) + [Log panggilan AWS IoT Greengrass V2 API dengan AWS CloudTrail](logging-using-cloudtrail.md) + [Kumpulkan data telemetri kesehatan sistem dari perangkat inti AWS IoT Greengrass](telemetry.md) + [Dapatkan pemberitahuan status kesehatan penerapan dan komponen](deployment-health-notifications.md) + [Periksa status perangkat inti Greengrass](device-status.md) ## Alat pemantauan AWS menyediakan alat yang dapat Anda gunakan untuk memantau AWS IoT Greengrass. Anda dapat mengonfigurasi beberapa alat ini agar melakukan pemantauan untuk Anda. Beberapa alat memerlukan intervensi manual. Kami menyarankan agar Anda mengautomasi tugas pemantauan sebanyak mungkin. Anda dapat menggunakan alat pemantauan otomatis berikut untuk memantau AWS IoT Greengrass dan melaporkan masalah: + **Amazon CloudWatch Logs** — Pantau, simpan, dan akses file log Anda dari AWS CloudTrail atau sumber lain. Untuk informasi selengkapnya, lihat [Memantau file log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) di *Panduan CloudWatch Pengguna Amazon*. + **AWS CloudTrail Pemantauan Log** - Bagikan file log antar akun, pantau file CloudTrail log secara real time dengan mengirimkannya ke CloudWatch Log, menulis aplikasi pemrosesan log di Java, dan validasi bahwa file log Anda tidak berubah setelah pengiriman oleh CloudTrail. Untuk informasi selengkapnya, lihat [Bekerja dengan file CloudTrail log](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-working-with-log-files.html) di *Panduan AWS CloudTrail Pengguna*. + **Telemetri kesehatan sistem Greengrass** — Berlanggananlah untuk menerima data telemetri yang dikirim dari inti Greengrass. Untuk informasi selengkapnya, lihat [Kumpulkan data telemetri kesehatan sistem dari perangkat inti AWS IoT Greengrass](telemetry.md). + **Pemberitahuan kesehatan perangkat** Buat acara menggunakan Amazon EventBridge untuk menerima pembaruan status terkait penerapan dan komponen. Untuk informasi selengkapnya, lihat [Dapatkan pemberitahuan status kesehatan penerapan dan komponen](deployment-health-notifications.md). + **Layanan status armada** — Gunakan operasi API status armada untuk memeriksa status perangkat inti dan komponen Greengrass mereka. Anda juga dapat melihat informasi status armada di AWS IoT Greengrass konsol. Untuk informasi selengkapnya, lihat [Periksa status perangkat inti Greengrass](device-status.md). # Memantau AWS IoT Greengrass log AWS IoT Greengrass terdiri dari layanan cloud dan perangkat lunak AWS IoT Greengrass Core. Perangkat lunak AWS IoT Greengrass Core dapat menulis log ke Amazon CloudWatch Logs dan ke sistem file lokal perangkat inti. Komponen Greengrass yang berjalan pada perangkat inti juga dapat menulis log CloudWatch ke Log dan sistem file lokal. Anda dapat menggunakan log untuk memantau acara dan meyelesaikan masalah. Semua entri AWS IoT Greengrass log menyertakan stempel waktu, tingkat log, dan informasi tentang acara tersebut. Secara default, perangkat lunak AWS IoT Greengrass Core menulis log hanya ke sistem file lokal. Anda dapat melihat log sistem file secara real time, sehingga Anda dapat men-debug komponen Greengrass yang Anda kembangkan dan terapkan. Anda juga dapat mengonfigurasi perangkat inti untuk menulis CloudWatch log ke Log, sehingga Anda dapat memecahkan masalah perangkat inti tanpa akses ke sistem file lokal. Untuk informasi selengkapnya, lihat [Aktifkan pencatatan ke CloudWatch Log](#enable-cloudwatch-logs). **Topics** + [Akses log sistem file](#access-local-logs) + [Akses CloudWatch Log](#access-cloudwatch-logs) + [Akses log layanan sistem](#access-system-service-logs) + [Aktifkan pencatatan ke CloudWatch Log](#enable-cloudwatch-logs) + [Konfigurasikan logging untuk AWS IoT Greengrass](#configure-logging) + [AWS CloudTrail log](#cloudtrail-integration) ## Akses log sistem file Perangkat lunak AWS IoT Greengrass Core menyimpan log di `/greengrass/v2/logs` folder pada perangkat inti, di `/greengrass/v2` mana jalur ke folder AWS IoT Greengrass root. Folder log memiliki struktur berikut. ``` /greengrass/v2 └── logs ├── greengrass.log ├── greengrass_2021_09_14_15_0.log ├── ComponentName.log ├── ComponentName_2021_09_14_15_0.log └── main.log ``` + `greengrass.log`— File log perangkat lunak AWS IoT Greengrass Core. Gunakan file log ini untuk melihat informasi real-time tentang komponen dan penerapan. [File log ini mencakup log untuk inti Greengrass, yang merupakan inti dari AWS IoT Greengrass perangkat lunak Core, dan komponen plugin, [seperti](log-manager-component.md) pengelola log dan manajer rahasia.](secret-manager-component.md) + `ComponentName.log`— File log komponen Greengrass. Gunakan file log komponen untuk melihat informasi real-time tentang komponen Greengrass yang berjalan pada perangkat inti. Komponen generik dan komponen Lambda menulis output standar (stdout) dan kesalahan standar (stderr) ke file log ini. + `main.log`— File log untuk `main` layanan yang menangani siklus hidup komponen. File log ini akan selalu kosong. Untuk informasi selengkapnya tentang perbedaan antara komponen plugin, generik, dan Lambda, lihat. [Jenis komponen](develop-greengrass-components.md#component-types) Pertimbangan berikut berlaku saat Anda menggunakan log sistem file: + **Izin pengguna root** Anda harus memiliki izin root untuk membaca AWS IoT Greengrass log pada sistem file. + **Rotasi file log** Perangkat lunak AWS IoT Greengrass Core memutar file log setiap jam atau ketika mereka melebihi batas ukuran file. File log yang diputar berisi stempel waktu dalam nama file mereka. Misalnya, file log perangkat lunak AWS IoT Greengrass Core yang diputar mungkin diberi nama`greengrass_2021_09_14_15_0.log`. Batas ukuran file default adalah 1.024 KB (1 MB). Anda dapat mengonfigurasi batas ukuran file pada komponen inti [Greengrass](greengrass-nucleus-component.md). + **Penghapusan file log** Perangkat lunak AWS IoT Greengrass Core membersihkan file log sebelumnya ketika ukuran file log perangkat lunak AWS IoT Greengrass Core atau file log komponen Greengrass, termasuk file log yang diputar, melebihi batas ruang disk. Batas ruang disk default untuk log perangkat lunak AWS IoT Greengrass Core dan setiap log komponen adalah 10.240 KB (10 MB). [Anda dapat mengonfigurasi batas ruang disk log perangkat lunak AWS IoT Greengrass Core pada komponen [inti Greengrass](greengrass-nucleus-component.md) atau komponen pengelola log.](log-manager-component.md) Anda dapat mengonfigurasi batas ruang disk log setiap komponen pada [komponen pengelola log](log-manager-component.md). **Untuk melihat file log perangkat lunak AWS IoT Greengrass inti** + Jalankan perintah berikut untuk melihat file log secara real time. Ganti `/greengrass/v2` dengan jalur ke folder AWS IoT Greengrass root. ------ #### [ Linux or Unix ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows Command Prompt (CMD) ] ``` type C:\greengrass\v2\logs\com.example.HelloWorld.log ``` `type`Perintah menulis konten file ke terminal. Jalankan perintah ini beberapa kali untuk mengamati perubahan dalam file. ------ #### [ PowerShell ] ``` gc C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ **Untuk melihat berkas log untuk komponen** + Jalankan perintah berikut untuk melihat file log secara real time. Ganti `/greengrass/v2` atau *C:\$1greengrass\$1v2* dengan jalur ke folder AWS IoT Greengrass root, dan ganti *com.example.HelloWorld* dengan nama komponen. ------ #### [ Linux or Unix ] ``` sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log ``` ------ #### [ PowerShell ] ``` gc C:\greengrass\v2\logs\com.example.HelloWorld.log -Tail 10 -Wait ``` ------ Anda juga dapat menggunakan `logs` perintah [CLI Greengrass untuk menganalisis log Greengrass pada perangkat inti](greengrass-cli-component.md). Untuk menggunakan `logs` perintah, Anda harus mengkonfigurasi inti [Greengrass](greengrass-nucleus-component.md) untuk mengeluarkan file log format JSON. Untuk informasi selengkapnya, lihat [Antarmuka Baris Perintah Greengrass](gg-cli.md) dan [log](gg-cli-logs.md). ## Akses CloudWatch Log Anda dapat menerapkan [komponen pengelola log](log-manager-component.md) untuk mengonfigurasi perangkat inti untuk menulis ke CloudWatch Log. Untuk informasi selengkapnya, lihat [Aktifkan pencatatan ke CloudWatch Log](#enable-cloudwatch-logs). Kemudian, Anda dapat melihat **log di halaman Log** di CloudWatch konsol Amazon atau menggunakan API CloudWatch Log. **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 (`+`). Pertimbangan berikut berlaku saat Anda menggunakan komponen pengelola log untuk menulis ke CloudWatch Log: + **Penundaan log** **catatan** Kami menyarankan Anda meningkatkan ke pengelola log versi 2.3.0 yang mengurangi penundaan log untuk file log yang diputar dan aktif. Saat Anda meningkatkan ke pengelola log 2.3.0, kami sarankan Anda juga meningkatkan ke Greengrass nucleus 2.9.1. 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](#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). + **Kemiringan jam** 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 bagian *Referensi Umum AWS*. ## Akses log layanan sistem Jika Anda [mengonfigurasi perangkat lunak AWS IoT Greengrass Core sebagai layanan sistem](configure-greengrass-core-v2.md#configure-system-service), Anda dapat melihat log layanan sistem untuk memecahkan masalah, seperti perangkat lunak yang gagal memulai. **Untuk melihat log layanan sistem (CLI)** 1. Jalankan perintah berikut untuk melihat log layanan sistem perangkat lunak AWS IoT Greengrass inti. ------ #### [ Linux or Unix (systemd) ] ``` sudo journalctl -u greengrass.service ``` ------ #### [ Windows Command Prompt (CMD) ] ``` type C:\greengrass\v2\logs\greengrass.wrapper.log ``` ------ #### [ PowerShell ] ``` gc C:\greengrass\v2\logs\greengrass.wrapper.log ``` ------ 1. Pada perangkat Windows, perangkat lunak AWS IoT Greengrass Core membuat file log terpisah untuk kesalahan layanan sistem. Jalankan perintah berikut untuk melihat log kesalahan layanan sistem. ------ #### [ Windows Command Prompt (CMD) ] ``` type C:\greengrass\v2\logs\greengrass.err.log ``` ------ #### [ PowerShell ] ``` gc C:\greengrass\v2\logs\greengrass.err.log ``` ------ Pada perangkat Windows, Anda juga dapat menggunakan aplikasi **Event Viewer** untuk melihat log layanan sistem. **Untuk melihat log layanan Windows (Event Viewer)** 1. Buka aplikasi **Event Viewer**. 1. Pilih **Windows Log** untuk memperluasnya. 1. Pilih **Aplikasi** untuk melihat log layanan aplikasi. 1. Temukan dan buka log peristiwa yang **Sumbernya **greengrass****. ## Aktifkan pencatatan ke CloudWatch Log Anda dapat menerapkan [komponen pengelola log](log-manager-component.md) untuk mengonfigurasi perangkat inti untuk menulis log ke CloudWatch Log. Anda dapat mengaktifkan CloudWatch Log untuk log perangkat lunak AWS IoT Greengrass Inti, dan Anda dapat mengaktifkan CloudWatch Log untuk komponen Greengrass tertentu. **catatan** Peran pertukaran token perangkat inti Greengrass harus memungkinkan perangkat inti untuk menulis CloudWatch ke Log, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut. Jika Anda [menginstal perangkat lunak AWS IoT Greengrass Core dengan penyediaan sumber daya otomatis](quick-installation.md), perangkat inti Anda memiliki izin ini. ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams" ], "Effect": "Allow", "Resource": "arn:aws:logs:*:*:*" } ] } ``` Untuk mengonfigurasi perangkat inti untuk menulis log perangkat lunak AWS IoT Greengrass Inti ke CloudWatch Log, [buat penerapan](create-deployments.md) yang menentukan pembaruan konfigurasi yang disetel `uploadToCloudWatch` ke `true` komponen. `aws.greengrass.LogManager` AWS IoT Greengrass [Log perangkat lunak inti menyertakan log untuk inti [Greengrass](greengrass-nucleus-component.md) dan komponen plugin.](develop-greengrass-components.md#component-types) ``` { "logsUploaderConfiguration": { "systemLogsConfiguration": { "uploadToCloudWatch": "true" } } } ``` Untuk mengonfigurasi perangkat inti untuk menulis log komponen Greengrass CloudWatch ke Log[, buat penerapan yang](create-deployments.md) menentukan pembaruan konfigurasi yang menambahkan komponen ke daftar konfigurasi logging komponen. Saat Anda menambahkan komponen ke daftar ini, komponen pengelola log akan menulis lognya ke CloudWatch Log. Log komponen termasuk log untuk komponen [generik dan komponen Lambda](develop-greengrass-components.md#component-types). ``` { "logsUploaderConfiguration": { "componentLogsConfigurationMap": { "com.example.HelloWorld": { } } } } ``` Saat Anda menerapkan komponen pengelola log, Anda juga dapat mengonfigurasi batas ruang disk dan apakah perangkat inti menghapus file log setelah menulisnya ke CloudWatch Log. Untuk informasi selengkapnya, lihat [Konfigurasikan logging untuk AWS IoT Greengrass](#configure-logging). ## Konfigurasikan logging untuk AWS IoT Greengrass Anda dapat mengonfigurasi opsi berikut untuk menyesuaikan logging untuk perangkat inti Greengrass. Untuk mengonfigurasi opsi ini, [buat penerapan yang](create-deployments.md) menentukan pembaruan konfigurasi ke inti Greengrass atau komponen pengelola log. + **Menulis log ke CloudWatch Log** Untuk memecahkan masalah perangkat inti dari jarak jauh, Anda dapat mengonfigurasi perangkat inti untuk menulis perangkat lunak AWS IoT Greengrass inti dan log komponen ke Log. CloudWatch Untuk melakukannya, gunakan dan konfigurasikan [komponen pengelola log](log-manager-component.md). Untuk informasi selengkapnya, lihat [Aktifkan pencatatan ke CloudWatch Log](#enable-cloudwatch-logs). + **Menghapus file log yang diunggah** Untuk mengurangi penggunaan ruang disk, Anda dapat mengonfigurasi perangkat inti untuk menghapus file log setelah menulis file CloudWatch log ke Log. Untuk informasi selengkapnya, lihat `deleteLogFileAfterCloudUpload` parameter komponen pengelola log, yang dapat Anda tentukan untuk [log perangkat lunak AWS IoT Greengrass inti](log-manager-component.md#log-manager-component-configuration-system-logs-configuration) dan [log komponen](log-manager-component.md#log-manager-component-configuration-component-logs-configuration). + **Batas ruang disk log** Untuk membatasi penggunaan ruang disk, Anda dapat mengonfigurasi ruang disk maksimum untuk setiap log, termasuk file log yang diputar, pada perangkat inti. Misalnya, Anda dapat mengonfigurasi ruang disk gabungan maksimum untuk `greengrass.log` dan `greengrass.log` file yang diputar. [Untuk informasi selengkapnya, lihat parameter komponen inti Greengrass dan parameter komponen `logging.totalLogsSizeKB``diskSpaceLimit` pengelola log, yang dapat Anda tentukan [AWS IoT Greengrass untuk log perangkat lunak inti](log-manager-component.md#log-manager-component-configuration-system-logs-configuration) dan log komponen.](log-manager-component.md#log-manager-component-configuration-component-logs-configuration) + **Batas ukuran file log** Anda dapat mengonfigurasi ukuran file maksimum untuk setiap file log. Setelah file log melebihi batas ukuran file ini, perangkat lunak AWS IoT Greengrass Core membuat file log baru. [Komponen pengelola log](log-manager-component.md) versi 2.28 (dan sebelumnya) hanya menulis file log yang diputar ke CloudWatch Log, sehingga Anda dapat menentukan batas ukuran file yang lebih rendah untuk menulis CloudWatch log ke Log lebih sering. Komponen pengelola log versi 2.3.0 (dan yang lebih baru) memproses dan mengunggah semua log alih-alih menunggu mereka diputar. Untuk informasi lebih lanjut, lihat parameter batas ukuran [file log komponen inti Greengrass (](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-log-file-size)). `logging.fileSizeKB` + **Tingkat log minimum** Anda dapat mengonfigurasi level log minimum yang ditulis oleh komponen inti Greengrass ke log sistem file. Misalnya, Anda dapat menentukan log `DEBUG` level untuk membantu pemecahan masalah, atau Anda dapat menentukan log `ERROR` level untuk mengurangi jumlah log yang dibuat oleh perangkat inti. Untuk informasi lebih lanjut, lihat parameter tingkat log komponen inti Greengrass ([)](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-log-level). `logging.level` Anda juga dapat mengonfigurasi tingkat log minimum yang ditulis oleh komponen pengelola CloudWatch log ke Log. Misalnya, Anda dapat menentukan tingkat log yang lebih tinggi untuk mengurangi [biaya pencatatan](https://aws.amazon.com/cloudwatch/pricing/). Untuk informasi selengkapnya, lihat `minimumLogLevel` parameter komponen pengelola log, yang dapat Anda tentukan untuk [log perangkat lunak AWS IoT Greengrass inti](log-manager-component.md#log-manager-component-configuration-system-logs-configuration) dan [log komponen](log-manager-component.md#log-manager-component-configuration-component-logs-configuration). + **Interval untuk memeriksa log untuk menulis ke CloudWatch Log** Untuk menambah atau mengurangi seberapa sering komponen pengelola log menulis CloudWatch log ke Log, Anda dapat mengonfigurasi interval di mana ia memeriksa file log baru untuk ditulis. Misalnya, Anda dapat menentukan interval yang lebih rendah untuk melihat CloudWatch log di Log lebih cepat daripada yang Anda lakukan dengan interval 5 menit default. Anda dapat menentukan interval yang lebih tinggi untuk mengurangi biaya, karena komponen pengelola log mengumpulkan file log ke permintaan yang lebih sedikit. Untuk informasi selengkapnya, lihat [parameter interval unggah](log-manager-component.md#log-manager-component-configuration-periodic-upload-interval-sec) komponen pengelola log (`periodicUploadIntervalSec`). + **Format log** Anda dapat memilih apakah perangkat lunak AWS IoT Greengrass Core menulis log dalam format teks atau JSON. Pilih format teks jika Anda membaca log, atau pilih format JSON jika Anda menggunakan aplikasi untuk membaca atau mengurai log. Untuk informasi lebih lanjut, lihat parameter format log komponen inti Greengrass ([)](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format). `logging.format` + **Folder log sistem file lokal** Anda dapat mengubah folder log dari `/greengrass/v2/logs` folder lain pada perangkat inti. Untuk informasi lebih lanjut, lihat parameter direktori keluaran komponen inti Greengrass ([)](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-log-level). `logging.outputDirectory` ## AWS CloudTrail log AWS IoT Greengrass terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau Layanan AWS dalam AWS IoT Greengrass. Lihat informasi yang lebih lengkap di [Log panggilan AWS IoT Greengrass V2 API dengan AWS CloudTrail](logging-using-cloudtrail.md). # Log panggilan AWS IoT Greengrass V2 API dengan AWS CloudTrail AWS IoT Greengrass V2 terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau AWS layanan di AWS IoT Greengrass Version 2. CloudTrail menangkap semua panggilan API untuk AWS IoT Greengrass sebagai peristiwa. Panggilan yang ditangkap termasuk panggilan dari AWS IoT Greengrass konsol dan panggilan kode ke operasi AWS IoT Greengrass API. Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail acara secara berkelanjutan ke bucket S3, termasuk acara untuk AWS IoT Greengrass. Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam **Riwayat acara**. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat AWS IoT Greengrass, alamat IP dari mana permintaan dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan. Untuk informasi selengkapnya CloudTrail, lihat [Panduan AWS CloudTrail Pengguna](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html). **Topics** + [AWS IoT Greengrass V2 informasi di CloudTrail](#service-name-info-in-cloudtrail) + [AWS IoT Greengrass peristiwa data di CloudTrail](#greengrass-data-events-cloudtrail) + [AWS IoT Greengrass acara manajemen di CloudTrail](#greengrass-management-events-cloudtrail) + [Memahami entri file AWS IoT Greengrass V2 log](#understanding-service-name-entries) ## AWS IoT Greengrass V2 informasi di CloudTrail CloudTrail diaktifkan pada Akun AWS saat Anda membuat akun. Ketika aktivitas terjadi di AWS IoT Greengrass, aktivitas tersebut dicatat dalam suatu CloudTrail peristiwa bersama dengan peristiwa AWS layanan lainnya dalam **riwayat Acara**. Anda dapat melihat, mencari, dan mengunduh peristiwa terbaru di Akun AWS Anda. Untuk informasi selengkapnya, lihat [Melihat peristiwa dengan Riwayat CloudTrail acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Untuk catatan acara yang sedang berlangsung di Anda Akun AWS, termasuk acara untuk AWS IoT Greengrass, buat jejak. *Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket S3. Secara default, saat Anda membuat jejak di konsol, jejak berlaku untuk semua Wilayah AWS s. Jejak mencatat peristiwa dari semua Wilayah di AWS partisi dan mengirimkan file log ke bucket S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi AWS layanan lain untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat berikut: + [Gambaran umum untuk membuat jejak](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail layanan dan integrasi yang didukung](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html) + [Mengonfigurasi notifikasi Amazon SNS untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html) + [Menerima file CloudTrail log dari beberapa wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima file CloudTrail log dari beberapa akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Semua AWS IoT Greengrass V2 tindakan dicatat oleh CloudTrail dan didokumentasikan dalam [Referensi AWS IoT Greengrass V2 API](https://docs.aws.amazon.com/greengrass/v2/APIReference/Welcome.html). Misalnya, panggilan ke`CreateComponentVersion`, `CreateDeployment` dan `CancelDeployment` tindakan menghasilkan entri dalam file CloudTrail log. Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan hal berikut ini: + Apakah permintaan itu dibuat dengan kredenal pengguna root atau AWS Identity and Access Management (IAM). + Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna gabungan. + Apakah permintaan itu dibuat oleh AWS layanan lain. Untuk informasi selengkapnya, lihat [Elemen userIdentity CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## AWS IoT Greengrass peristiwa data di CloudTrail [Peristiwa data](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events) memberikan informasi tentang operasi sumber daya yang dilakukan pada atau di sumber daya (misalnya, mendapatkan versi komponen atau konfigurasi penerapan). Ini juga dikenal sebagai operasi bidang data. Peristiwa data sering kali merupakan aktivitas bervolume tinggi. Secara default, CloudTrail tidak mencatat peristiwa data. **Riwayat CloudTrail peristiwa** tidak merekam peristiwa data. Biaya tambahan berlaku untuk peristiwa data. Untuk informasi selengkapnya tentang CloudTrail harga, lihat [AWS CloudTrail Harga](https://aws.amazon.com/cloudtrail/pricing/). Anda dapat mencatat peristiwa data untuk jenis AWS IoT Greengrass sumber daya menggunakan CloudTrail konsol AWS CLI, atau operasi CloudTrail API. [Tabel](#data-events-table) di bagian ini menunjukkan jenis sumber daya yang tersedia untuk AWS IoT Greengrass. + Untuk mencatat peristiwa data menggunakan CloudTrail konsol, buat [penyimpanan data [jejak](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-a-trail-using-the-console-first-time.html#creating-a-trail-in-the-console) atau peristiwa](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/query-event-data-store-cloudtrail.html) untuk mencatat peristiwa data, atau [perbarui penyimpanan data jejak atau peristiwa yang ada](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) untuk mencatat peristiwa data. 1. Pilih **Peristiwa data** untuk mencatat peristiwa data. 1. Dari daftar **tipe peristiwa Data**, pilih jenis sumber daya yang ingin Anda log peristiwa data. 1. Pilih template pemilih log yang ingin Anda gunakan. Anda dapat mencatat semua peristiwa data untuk jenis sumber daya, mencatat semua `readOnly` peristiwa, mencatat semua `writeOnly` peristiwa, atau membuat templat pemilih log kustom untuk memfilter pada `readOnly``eventName`, dan `resources.ARN` bidang. + Untuk mencatat peristiwa data menggunakan AWS CLI, konfigurasikan `--advanced-event-selectors` parameter untuk mengatur `eventCategory` bidang sama dengan `Data` dan `resources.type` bidang sama dengan nilai tipe sumber daya (lihat [tabel](#data-events-table)). Anda dapat menambahkan kondisi untuk memfilter nilai`readOnly`,`eventName`, dan `resources.ARN` bidang. + Untuk mengonfigurasi jejak untuk mencatat peristiwa data, jalankan [https://docs.aws.amazon.com/cli/latest/reference/cloudtrail/put-event-selectors.html](https://docs.aws.amazon.com/cli/latest/reference/cloudtrail/put-event-selectors.html)perintah. Untuk informasi selengkapnya, lihat [Mencatat peristiwa data untuk jejak dengan. AWS CLI](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-CLI-trail-examples) + Untuk mengonfigurasi penyimpanan data peristiwa untuk mencatat peristiwa data, jalankan [https://docs.aws.amazon.com/cli/latest/reference/cloudtrail/create-event-data-store.html](https://docs.aws.amazon.com/cli/latest/reference/cloudtrail/create-event-data-store.html)perintah untuk membuat penyimpanan data peristiwa baru untuk mencatat peristiwa data, atau jalankan [https://docs.aws.amazon.com/cli/latest/reference/cloudtrail/update-event-data-store.html](https://docs.aws.amazon.com/cli/latest/reference/cloudtrail/update-event-data-store.html)perintah untuk memperbarui penyimpanan data peristiwa yang ada. Untuk informasi selengkapnya, lihat [Mencatat peristiwa data untuk menyimpan data peristiwa dengan AWS CLI](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-CLI-eds-examples). Tabel berikut mencantumkan jenis AWS IoT Greengrass sumber daya. Kolom **tipe peristiwa data (konsol)** menunjukkan nilai yang akan dipilih dari daftar **tipe peristiwa Data** di CloudTrail konsol. Kolom nilai **resources.type menunjukkan `resources.type` nilai**, yang akan Anda tentukan saat mengonfigurasi penyeleksi acara lanjutan menggunakan or. AWS CLI CloudTrail APIs CloudTrailKolom **Data yang APIs dicatat ke** menampilkan panggilan API yang dicatat CloudTrail untuk jenis sumber daya. | Jenis peristiwa data (konsol) | nilai resources.type | Data APIs masuk ke CloudTrail | | --- | --- | --- | | Sertifikat IoT | AWS::IoT::Certificate | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/logging-using-cloudtrail.html) | | Versi komponen Greengrass IoT | AWS::GreengrassV2::ComponentVersion | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/logging-using-cloudtrail.html) | | Penyebaran Greengrass IoT | AWS::GreengrassV2::Deployment | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/logging-using-cloudtrail.html) | | Hal IoT | AWS::IoT::Thing | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/logging-using-cloudtrail.html) | Anda dapat mengonfigurasi pemilih acara lanjutan untuk memfilter pada `eventName``readOnly`,, dan `resources.ARN` bidang untuk mencatat hanya peristiwa yang penting bagi Anda. Tambahkan filter `eventName` untuk menyertakan atau mengecualikan data tertentu APIs. Untuk informasi lebih lanjut tentang bidang ini, lihat [https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html). Contoh berikut menunjukkan cara mengkonfigurasi penyeleksi lanjutan menggunakan. AWS CLI Ganti *TrailName* dan *region* dengan informasi Anda sendiri. **Example — Log peristiwa data untuk hal-hal IoT** ``` aws cloudtrail put-event-selectors --trail-name TrailName --region region \ --advanced-event-selectors \ ‘[ { “Name”: “Log all thing data events”, “FieldSelectors”: [ { “Field”: “eventCategory”, “Equals”: [“Data”] }, { “Field”: “resources.type”, “Equals”: [“AWS::IoT::Thing”] } ] } ]’ ``` **Example — Filter pada API IoT tertentu** ``` aws cloudtrail put-event-selectors --trail-name TrailName --region region \ --advanced-event-selectors \ ‘[ { “Name”: “Log IoT Greengrass PutCertificateAuthorities API calls”, “FieldSelectors”: [ { “Field”: “eventCategory”, “Equals”: [“Data”] }, { “Field”: “resources.type”, “Equals”: [“AWS::IoT::Thing”] }, { “Field”: “eventName”, “Equals”: [“PutCertificateAuthorities”] } ] } ]’ ``` **Example — Log semua peristiwa data Greengrass** ``` aws cloudtrail put-event-selectors --trail-name TrailName --region region \ --advanced-event-selectors \ ‘[ { “Name”: “Log all certificate data events”, “FieldSelectors”: [ { “Field”: “eventCategory”, “Equals”: [ “Data” ] }, { “Field”: “resources.type”, “Equals”: [ “AWS::IoT::Certificate” ] } ] }, { “Name”: “Log all component version data events”, “FieldSelectors”: [ { “Field”: “eventCategory”, “Equals”: [ “Data” ] }, { “Field”: “resources.type”, “Equals”: [ “AWS::GreengrassV2::ComponentVersion” ] } ] }, { “Name”: “Log all deployment version”, “FieldSelectors”: [ { “Field”: “eventCategory”, “Equals”: [ “Data” ] }, { “Field”: “resources.type”, “Equals”: [ “AWS::GreengrassV2::Deployment” ] } ] }, { “Name”: “Log all thing data events”, “FieldSelectors”: [ { “Field”: “eventCategory”, “Equals”: [ “Data” ] }, { “Field”: “resources.type”, “Equals”: [ “AWS::IoT::Thing” ] } ] } ]’ ``` ## AWS IoT Greengrass acara manajemen di CloudTrail [Acara manajemen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) memberikan informasi tentang operasi manajemen yang dilakukan pada sumber daya di AWS akun Anda. Ini juga dikenal sebagai operasi bidang kontrol. Secara default, CloudTrail mencatat peristiwa manajemen. AWS IoT Greengrass mencatat semua operasi pesawat AWS IoT Greengrass kontrol sebagai peristiwa manajemen. Untuk daftar operasi bidang AWS IoT Greengrass kontrol yang AWS IoT Greengrass masuk ke log CloudTrail, lihat [referensi AWS IoT Greengrass API, versi 2](https://docs.aws.amazon.com/greengrass/v2/APIReference/Welcome.html). ## Memahami entri file AWS IoT Greengrass V2 log Trail adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Peristiwa menunjukkan satu permintaan dari sumber mana pun. Ini mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi file tersebut tidak muncul dalam urutan tertentu. Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `CreateDeployment` tindakan. ``` { "eventVersion": "1.08", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::123456789012:user/Administrator", "accountId": "123456789012", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "Administrator" }, "eventTime": "2021-01-06T02:38:05Z", "eventSource": "greengrass.amazonaws.com", "eventName": "CreateDeployment", "awsRegion": "us-west-2", "sourceIPAddress": "203.0.113.0", "userAgent": "aws-cli/2.1.9 Python/3.7.9 Windows/10 exe/AMD64 prompt/off command/greengrassv2.create-deployment", "requestParameters": { "deploymentPolicies": { "failureHandlingPolicy": "DO_NOTHING", "componentUpdatePolicy": { "timeoutInSeconds": 60, "action": "NOTIFY_COMPONENTS" }, "configurationValidationPolicy": { "timeoutInSeconds": 60 } }, "deploymentName": "Deployment for MyGreengrassCoreGroup", "components": { "aws.greengrass.Cli": { "componentVersion": "2.0.3" } }, "iotJobConfiguration": {}, "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup" }, "responseElements": { "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/fdfeba1d-ac6d-44ef-ab28-54f684ea578d", "iotJobId": "fdfeba1d-ac6d-44ef-ab28-54f684ea578d", "deploymentId": "4196dddc-0a21-4c54-a985-66a525f6946e" }, "requestID": "311b9529-4aad-42ac-8408-c06c6fec79a9", "eventID": "c0f3aa2c-af22-48c1-8161-bad4a2ab1841", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": true, "eventCategory": "Management", "recipientAccountId": "123456789012" } ``` # Kumpulkan data telemetri kesehatan sistem dari perangkat inti AWS IoT Greengrass Data telemetri kesehatan sistem adalah data diagnostik yang dapat membantu Anda memantau kinerja operasi kritis pada perangkat inti Greengrass Anda. Anda dapat membuat proyek dan aplikasi untuk mengambil, menganalisis, mengubah, dan melaporkan data telemetri dari perangkat edge Anda. Pakar domain, seperti para insinyur proses, dapat menggunakan aplikasi ini untuk mendapatkan wawasan tentang kesehatan armada. Anda dapat menggunakan metode berikut untuk mengumpulkan data telemetri dari perangkat inti Greengrass Anda: + Komponen **pemancar telemetri nukleus —Komponen pemancar** [telemetri nukleus (`aws.greengrass.telemetry.NucleusEmitter`) pada perangkat](nucleus-emitter-component.md) inti Greengrass menerbitkan data telemetri ke topik secara default. `$local/greengrass/telemetry` Anda dapat menggunakan data yang dipublikasikan ke topik ini untuk bertindak secara lokal di perangkat inti Anda, bahkan ketika perangkat Anda memiliki konektivitas terbatas ke cloud. Secara opsional, Anda juga dapat mengonfigurasi komponen untuk mempublikasikan data telemetri ke topik AWS IoT Core MQTT pilihan Anda. Anda harus menyebarkan komponen pemancar nukleus ke perangkat inti untuk mempublikasikan data telemetri. Tidak ada biaya yang terkait dengan penerbitan data telemetri ke topik lokal. [Namun, 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). + Agen **telemetri —Agen** telemetri pada perangkat inti Greengrass mengumpulkan data telemetri lokal dan menerbitkannya ke Amazon tanpa memerlukan interaksi pelanggan apa pun. EventBridge Perangkat inti mempublikasikan data telemetri dengan upaya terbaik. EventBridge Sebagai contoh, perangkat inti mungkin gagal untuk mengirimkan data telemetri saat offline. Fitur agen telemetri diaktifkan secara default untuk semua perangkat inti Greengrass. Anda secara otomatis mulai menerima data segera setelah Anda mengatur perangkat inti Greengrass. Selain biaya tautan data Anda, transfer data dari perangkat inti ke AWS IoT Core tanpa biaya. Ini karena agen menerbitkan ke topik yang AWS dicadangkan. Namun, tergantung pada kasus penggunaan Anda, Anda dapat dikenakan biaya saat menerima atau memproses data. **catatan** Amazon EventBridge adalah layanan bus acara yang dapat Anda gunakan untuk menghubungkan aplikasi Anda dengan data dari berbagai sumber, seperti perangkat inti Greengrass. Untuk informasi selengkapnya, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) di *Panduan EventBridge Pengguna Amazon*. Untuk memastikan bahwa perangkat lunak AWS IoT Greengrass Core berfungsi dengan baik, AWS IoT Greengrass gunakan data untuk tujuan pengembangan dan peningkatan kualitas. Fitur ini juga membantu menginformasikan kemampuan edge yang baru dan ditingkatkan. AWS IoT Greengrass menyimpan data telemetri hingga tujuh hari. Bagian ini menjelaskan cara mengkonfigurasi dan menggunakan agen telemetri. Untuk informasi tentang mengonfigurasi komponen pemancar telemetri nukleus, lihat. [Pemancar telemetri nukleus](nucleus-emitter-component.md) **Topics** + [Metrik telemetri](#telemetry-metrics) + [Konfigurasikan pengaturan agen telemetri](#configure-telemetry-agent-settings) + [Berlangganan data telemetri di EventBridge](#subscribe-for-telemetry-data) ## Metrik telemetri Tabel berikut menjelaskan metrik yang diterbitkan oleh agen telemetri. | 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. | | **Autentikasi perangkat klien** - Fitur ini memerlukan v2.4.0 atau yang lebih baru dari komponen autentikasi perangkat klien. | | `VerifyClientDeviceIdentity.Success` | Berapa kali memverifikasi bahwa identitas perangkat klien berhasil. | | `VerifyClientDeviceIdentity.Failure` | Berapa kali memverifikasi bahwa identitas perangkat klien gagal. | | `AuthorizeClientDeviceActions.Success` | Berapa kali perangkat klien diizinkan untuk menyelesaikan tindakan yang diminta. | | `AuthorizeClientDeviceActions.Failure` | Berapa kali perangkat klien tidak diizinkan untuk menyelesaikan tindakan yang diminta. | | `GetClientDeviceAuthToken.Success` | Berapa kali perangkat klien berhasil diautentikasi. | | `GetClientDeviceAuthToken.Failure` | Berapa kali perangkat klien tidak dapat diautentikasi. | | `SubscribeToCertificateUpdates.Success` | Jumlah langganan yang berhasil untuk pembaruan sertifikat. | | `SubscribeToCertificateUpdates.Failure` | Jumlah upaya yang gagal untuk berlangganan pembaruan sertifikat. | | `ServiceError` | Jumlah kesalahan internal yang tidak tertangani di seluruh autentikasi perangkat klien. | | **Stream manager** — Fitur ini membutuhkan v2.7.0 atau yang lebih baru dari komponen inti Greengrass. | | `BytesAppended` | Jumlah byte data ditambahkan ke pengelola pengaliran. | | `BytesUploadedToIoTAnalytics` | Jumlah byte data yang diekspor pengelola aliran ke saluran. AWS IoT Analytics | | `BytesUploadedToKinesis` | Jumlah byte data yang diekspor pengelola pengaliran ke pengaliran di Amazon Kinesis Data Streams. | | `BytesUploadedToIoTSiteWise` | Jumlah byte data yang diekspor manajer aliran ke properti aset di. AWS IoT SiteWise | | `BytesUploadedToS3` | Jumlah byte data yang diekspor pengelola pengaliran ke objek di Amazon S3. | | **Metrik Sistem** — Fitur ini membutuhkan v2.15.0 atau yang lebih baru dari komponen inti Greengrass. | | `CPUArchitecture` | Arsitektur unit pemrosesan pusat perangkat. | | `Family` | Keluarga sistem operasi perangkat (khusus Windows). | | `KernelVersion` | Versi kernel perangkat (hanya Unix). | | `KnowledgeBaseArticles` | Artikel Pangkalan Pengetahuan diinstal pada perangkat (hanya Windows). | | `OSBuildMajor` | Nomor build utama dari versi sistem operasi (hanya Windows). | | `OSBuildMinor` | Nomor build minor dari versi sistem operasi (hanya Windows). | | `OSName` | Nama sistem operasi perangkat. | | `OSVersion` | Versi pemasaran dari sistem operasi perangkat. | ## Konfigurasikan pengaturan agen telemetri Agen telemetri menggunakan pengaturan default berikut: + Agen telemetri mengumpulkan data telemetri setiap jam. + Agen telemetri menerbitkan pesan telemetri setiap 24 jam. Agen telemetri menerbitkan data menggunakan protokol MQTT dengan tingkat kualitas layanan (QoS) 0, yang berarti bahwa ia tidak mengonfirmasi pengiriman atau mencoba lagi upaya penerbitan. Pesan telemetri berbagi koneksi MQTT dengan pesan lain untuk langganan yang ditujukan pada AWS IoT Core. Selain biaya tautan data Anda, transfer data dari inti ke AWS IoT Core tanpa biaya. Ini karena agen menerbitkan ke topik yang AWS dicadangkan. Namun, tergantung pada kasus penggunaan Anda, Anda dapat dikenakan biaya saat menerima atau memproses data. Anda dapat mengaktifkan atau menonaktifkan fitur agen telemetri untuk setiap perangkat inti Greengrass. Anda juga dapat mengonfigurasi interval di mana perangkat inti mengagregasi dan menerbitkan data. Untuk mengonfigurasi telemetri, sesuaikan [parameter konfigurasi telemetri](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-telemetry) saat Anda men-deploy [komponen inti Greengrass](greengrass-nucleus-component.md). ## Berlangganan data telemetri di EventBridge Anda dapat membuat aturan di Amazon EventBridge yang menentukan cara memproses data telemetri yang diterbitkan dari agen telemetri di perangkat inti Greengrass. Saat EventBridge menerima data, data tersebut akan memanggil tindakan target yang ditentukan dalam aturan Anda. Misalnya, Anda dapat membuat aturan acara yang mengirim notifikasi, menyimpan informasi peristiwa, mengambil tindakan korektif, atau memanggil peristiwa lain. ### Peristiwa telemetri Peristiwa telemetri menggunakan format berikut. ``` { "version": "0", "id": "a09d303e-2f6e-3d3c-a693-8e33f4fe3955", "detail-type": "Greengrass Telemetry Data", "source": "aws.greengrass", "account": "123456789012", "time": "2020-11-30T20:45:53Z", "region": "us-east-1", "resources": [], "detail": { "ThingName": "MyGreengrassCore", "Schema": "2020-07-30", "ADP": [ { "TS": 1602186483234, "NS": "SystemMetrics", "M": [ { "N": "TotalNumberOfFDs", "Sum": 6447.0, "U": "Count" }, { "N": "CpuUsage", "Sum": 15.458333333333332, "U": "Percent" }, { "N": "SystemMemUsage", "Sum": 10201.0, "U": "Megabytes" } ] }, { "TS": 1602186483234, "NS": "GreengrassComponents", "M": [ { "N": "NumberOfComponentsStopping", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsStarting", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsBroken", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsFinished", "Sum": 1.0, "U": "Count" }, { "N": "NumberOfComponentsInstalled", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsRunning", "Sum": 7.0, "U": "Count" }, { "N": "NumberOfComponentsNew", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsErrored", "Sum": 0.0, "U": "Count" }, { "N": "NumberOfComponentsStateless", "Sum": 0.0, "U": "Count" } ] }, { "TS": 1602186483234, "NS": "aws.greengrass.ClientDeviceAuth", "M": [ { "N": "VerifyClientDeviceIdentity.Success", "Sum": 3.0, "U": "Count" }, { "N": "VerifyClientDeviceIdentity.Failure", "Sum": 1.0, "U": "Count" }, { "N": "AuthorizeClientDeviceActions.Success", "Sum": 20.0, "U": "Count" }, { "N": "AuthorizeClientDeviceActions.Failure", "Sum": 5.0, "U": "Count" }, { "N": "GetClientDeviceAuthToken.Success", "Sum": 5.0, "U": "Count" }, { "N": "GetClientDeviceAuthToken.Failure", "Sum": 2.0, "U": "Count" }, { "N": "SubscribeToCertificateUpdates.Success", "Sum": 10.0, "U": "Count" }, { "N": "SubscribeToCertificateUpdates.Failure", "Sum": 1.0, "U": "Count" }, { "N": "ServiceError", "Sum": 3.0, "U": "Count" } ] }, { "TS": 1602186483234, "NS": "aws.greengrass.StreamManager", "M": [ { "N": "BytesAppended", "Sum": 157745524.0, "U": "Bytes" }, { "N": "BytesUploadedToIoTAnalytics", "Sum": 149012.0, "U": "Bytes" }, { "N": "BytesUploadedToKinesis", "Sum": 12192.0, "U": "Bytes" }, { "N": "BytesUploadedToIoTSiteWise", "Sum": 13321.0, "U": "Bytes" }, { "N": "BytesUploadedToS3", "Sum": 12213.0, "U": "Bytes" } ] } { "TS": 1750104449426, "NS": "SystemMetrics", "M": [ { "N": "KernelVersion", "Sum": 1, "U": "6.1.140-154.222.amzn2023.x86_64" }, { "N": "OSVersion", "Sum": 1, "U": "2023.7.20250609" }, { "N": "OSName", "Sum": 1, "U": "Amazon Linux" }, { "N": "CPUArchitecture", "Sum": 1, "U": "Broadwell (Server)" }, ] } ] } } ``` Rangkaian `ADP` berisi daftar titik data agregat yang memiliki properti sebagai berikut: `TS` Stempel waktu kapan data dikumpulkan. `NS` Namespace metrik. `M` Daftar metrik. Metrik ini berisi properti berikut: `N` Nama metrik. `Sum` Jumlah nilai metrik dalam peristiwa telemetri ini. `U` Unit nilai metrik. Untuk informasi selengkapnya tentang setiap metrik, lihat[Metrik telemetri](#telemetry-metrics). ### Prasyarat untuk membuat aturan EventBridge Sebelum Anda membuat EventBridge aturan untuk AWS IoT Greengrass, Anda harus melakukan hal berikut: + Biasakan diri Anda dengan acara, aturan, dan target di EventBridge. + Buat dan konfigurasikan [target](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html) yang dipanggil oleh EventBridge aturan Anda. Aturan dapat memanggil banyak jenis target, seperti aliran Amazon Kinesis, fungsi, topik Amazon SNS AWS Lambda , dan antrian Amazon SQS. EventBridge Aturan Anda, dan target terkait harus di Wilayah AWS tempat Anda membuat sumber daya Greengrass Anda. Untuk informasi selengkapnya, lihat [Titik akhir layanan dan kuota](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) di. *Referensi Umum AWS* Untuk informasi selengkapnya, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) dan [Memulai Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) di *Panduan EventBridge Pengguna Amazon*. ### Buat aturan peristiwa untuk mendapatkan data telemetri (konsol) Gunakan langkah-langkah berikut untuk menggunakan aturan Konsol Manajemen AWS untuk membuat EventBridge aturan yang menerima data telemetri yang diterbitkan oleh perangkat inti Greengrass. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut. Untuk informasi selengkapnya, lihat [Membuat EventBridge aturan yang memicu peristiwa dari AWS sumber daya](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) di *Panduan EventBridge Pengguna Amazon*. 1. Buka [ EventBridgekonsol Amazon](https://console.aws.amazon.com/events/), dan pilih **Buat aturan**. 1. Di bawah **Nama dan deskripsi**, masukkan nama dan deskripsi untuk alarm Anda. 1. Di bawah **Tentukan pola**, konfigurasikan pola aturan. 1. Pilih **Pola kejadian**. 1. Pilih **Pola yang ditentukan sebelumnya oleh layanan**. 1. Untuk **Penyedia layanan**, pilih **AWS**. 1. Untuk **Nama layanan**, pilih **Greengrass**. 1. Untuk **Jenis peristiwa**, pilih **Data Telemetri Greengrass**. 1. Di bawah **Pilih bus peristiwa**, jaga default opsi bus peristiwa. 1. Di bawah **Pilih target**, konfigurasikan target Anda. Contoh berikut menggunakan antrean Amazon SQS, tetapi Anda dapat mengonfigurasi jenis target lainnya. 1. Untuk **Target**, pilih **Antrean SQS**. 1. Untuk **Antrean**, pilih antrean target Anda. 1. Di bawah **Tag - opsional**, tentukan tag untuk aturan tersebut atau biarkan kolom tersebut kosong. 1. Pilih **Buat**. ### Buat aturan peristiwa untuk mendapatkan data telemetri (CLI) Gunakan langkah-langkah berikut untuk menggunakan aturan AWS CLI untuk membuat EventBridge aturan yang menerima data telemetri yang diterbitkan oleh perangkat inti Greengrass. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut. 1. Buat aturan. + Ganti *thing-name* dengan nama benda dari perangkat inti. ------ #### [ Linux or Unix ] ``` aws events put-rule \ --name MyGreengrassTelemetryEventRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` ------ #### [ Windows Command Prompt (CMD) ] ``` aws events put-rule ^ --name MyGreengrassTelemetryEventRule ^ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` ------ #### [ PowerShell ] ``` aws events put-rule ` --name MyGreengrassTelemetryEventRule ` --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` ------ Properti yang dihilangkan dari tersebut pola akan diabaikan. 1. Tambahkan topik sebagai target aturan. Contoh berikut menggunakan Amazon SQS tetapi Anda dapat mengonfigurasi jenis target lainnya. + Ganti *queue-arn* dengan ARN antrian Amazon SQS Anda. ------ #### [ Linux or Unix ] ``` aws events put-targets \ --rule MyGreengrassTelemetryEventRule \ --targets "Id"="1","Arn"="queue-arn" ``` ------ #### [ Windows Command Prompt (CMD) ] ``` aws events put-targets ^ --rule MyGreengrassTelemetryEventRule ^ --targets "Id"="1","Arn"="queue-arn" ``` ------ #### [ PowerShell ] ``` aws events put-targets ` --rule MyGreengrassTelemetryEventRule ` --targets "Id"="1","Arn"="queue-arn" ``` ------ **catatan** Untuk mengizinkan Amazon EventBridge memanggil antrean target, Anda harus menambahkan kebijakan berbasis sumber daya ke topik Anda. Untuk informasi selengkapnya, lihat [izin Amazon SQS di Panduan](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sqs-permissions) Pengguna *Amazon EventBridge *. Untuk informasi selengkapnya, lihat [Peristiwa dan pola peristiwa EventBridge di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Panduan EventBridge Pengguna Amazon*. # Dapatkan pemberitahuan status kesehatan penerapan dan komponen Aturan EventBridge acara Amazon memberi Anda pemberitahuan tentang perubahan status untuk penerapan Greengrass yang diterima oleh perangkat Anda dan untuk komponen yang diinstal pada perangkat Anda. EventBridge memberikan aliran peristiwa sistem yang mendekati real-time yang menjelaskan perubahan AWS sumber daya. AWS IoT Greengrass mengirimkan acara ini ke EventBridge atas dasar *upaya terbaik*. Ini berarti bahwa AWS IoT Greengrass upaya untuk mengirim semua acara ke EventBridge tetapi, dalam beberapa kasus yang jarang terjadi, suatu peristiwa mungkin tidak disampaikan. Selain itu, AWS IoT Greengrass mungkin mengirim beberapa salinan dari peristiwa tertentu, yang berarti bahwa pendengar acara Anda mungkin tidak menerima peristiwa dalam urutan kejadian terjadi. **catatan** Amazon EventBridge adalah layanan bus acara yang dapat Anda gunakan untuk menghubungkan aplikasi Anda dengan data dari berbagai sumber, seperti perangkat [inti Greengrass](telemetry.md) dan penyebaran serta pemberitahuan komponen. Untuk informasi selengkapnya, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) di *Panduan EventBridge Pengguna Amazon*. **Topics** + [Acara perubahan status penerapan](#deployment.events-message-format) + [Acara perubahan status komponen](#component.events-message-format) + [Prasyarat untuk membuat aturan EventBridge](#create-events-rule-prereqs) + [Konfigurasikan pemberitahuan kesehatan perangkat (konsol)](#create-events-rule-console) + [Konfigurasikan pemberitahuan kesehatan perangkat (CLI)](#create-events-rule-cli) + [Konfigurasikan pemberitahuan kesehatan perangkat (CloudFormation)](#create-events-rule-cloudformation) + [Lihat juga](#deployment-notifications-see-also) ## Acara perubahan status penerapan AWS IoT Greengrass memancarkan peristiwa ketika penerapan memasuki status berikut:`FAILED`,,, `SUCCEEDED` `COMPLETED``REJECTED`, dan. `CANCELED` Anda dapat membuat EventBridge aturan yang berjalan untuk semua transisi status atau transisi ke status yang Anda tentukan. Saat penerapan memasuki status yang memulai aturan, EventBridge memanggil tindakan target yang ditentukan dalam aturan. Hal ini mengizinkan Anda untuk mengirim pemberitahuan, menangkap informasi peristiwa, mengambil tindakan korektif, atau menginisiasi peristiwa lain untuk merespon perubahan keadaan. Sebagai contoh, Anda dapat membuat aturan untuk kasus penggunaan berikut: + Memulai operasi pasca deployment, seperti mengunduh aset dan memberi tahu personil. + Kirim pemberitahuan setelah deployment berhasil atau gagal. + Terbitkankan metrik kustom tentang peristiwa deployment. [peristiwa](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) untuk perubahan keadaan deployment menggunakan format berikut: ``` { "version":"0", "id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8", "detail-type":"Greengrass V2 Effective Deployment Status Change", "source":"aws.greengrass", "account":"123456789012", "region":"us-west-2", "time":"2018-03-22T00:38:11Z", "resources":["arn:aws:greengrass:us-east-1:123456789012:coreDevices:MyGreengrassCore"], "detail":{ "deploymentId": "4f38f1a7-3dd0-42a1-af48-EXAMPLE09681", "coreDeviceExecutionStatus": "FAILED|SUCCEEDED|COMPLETED|REJECTED|CANCELED", "statusDetails": { "errorStack": ["DEPLOYMENT_FAILURE", "ARTIFACT_DOWNLOAD_ERROR", "S3_ERROR", "S3_ACCESS_DENIED", "S3_HEAD_OBJECT_ACCESS_DENIED"], "errorTypes": ["DEPENDENCY_ERROR", "PERMISSION_ERROR"], }, "reason": "S3_HEAD_OBJECT_ACCESS_DENIED: FAILED_NO_STATE_CHANGE: Failed to download artifact name: 's3://pentest27/nucleus/281/aws.greengrass.nucleus.zip' for component aws.greengrass.Nucleus-2.8.1, reason: S3 HeadObject returns 403 Access Denied. Ensure the IAM role associated with the core device has a policy granting s3:GetObject. null (Service: S3, Status Code: 403, Request ID: HR94ZNT2161DAR58, Extended Request ID: wTX4DDI+qigQt3uzwl9rlnQiYlBgwvPm/KJFWeFAn9t1mnGXTms/luLCYANgq08RIH+x2H+hEKc=)" } } ``` Anda dapat membuat aturan dan acara yang akan memperbarui Anda tentang status penerapan. Sebuah peristiwa dimulai ketika penerapan selesai sebagai salah satu`FAILED`,,, `SUCCEEDED``COMPLETED`, `REJECTED` atau. `CANCELED` Jika penerapan gagal pada perangkat inti, Anda akan menerima respons terperinci yang menjelaskan mengapa penerapan gagal. Untuk informasi selengkapnya tentang kode kesalahan penerapan, lihat[Kode kesalahan penyebaran terperinci](troubleshooting-deployment.md). **Status penyebaran** + `FAILED`. Deployment gagal. + `SUCCEEDED`. Penyebaran yang ditargetkan ke grup sesuatu berhasil diselesaikan. + `COMPLETED`. Penyebaran yang ditargetkan untuk sesuatu yang berhasil diselesaikan. + `REJECTED`. Penyebaran ditolak. Untuk informasi lebih lanjut, lihat `statusDetails` bidangnya. + `CANCELED`. Penerapan dibatalkan oleh pengguna. Ada kemungkinan bahwa peristiwa dapat diduplikasi atau rusak. Untuk menentukan urutan peristiwa, gunakan properti `time` ini. Untuk daftar lengkap kode kesalahan di `errorStacks` dan`errorTypes`, lihat [Kode kesalahan penyebaran terperinci](troubleshooting-deployment.md) dan[Kode status komponen terperinci](troubleshooting-component.md). ## Acara perubahan status komponen Untuk AWS IoT Greengrass versi 2.12.2 dan versi sebelumnya, Greengrass memancarkan peristiwa saat komponen memasuki status berikut: dan. `ERRORED` `BROKEN` Untuk Greengrass nucleus versi 2.12.3 dan yang lebih baru, Greengrass memancarkan peristiwa ketika komponen memasuki status berikut:,,, dan. `ERRORED` `BROKEN` `RUNNING` `FINISHED` Greengrass juga akan memancarkan peristiwa saat penerapan selesai. Anda dapat membuat EventBridge aturan yang berjalan untuk semua transisi status atau transisi ke status yang Anda tentukan. Ketika komponen yang diinstal memasuki status yang memulai aturan, EventBridge memanggil tindakan target yang ditentukan dalam aturan. Hal ini mengizinkan Anda untuk mengirim pemberitahuan, menangkap informasi peristiwa, mengambil tindakan korektif, atau menginisiasi peristiwa lain untuk merespon perubahan keadaan. [Acara](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) untuk perubahan status komponen menggunakan format berikut: ------ #### [ Greengrass nucleus v2.12.2 and earlier ] Status komponen: `ERRORED` atau `BROKEN` ``` { "version":"0", "id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8", "detail-type":"Greengrass V2 Installed Component Status Change", "source":"aws.greengrass", "account":"123456789012", "region":"us-west-2", "time":"2018-03-22T00:38:11Z", "resources":["arn:aws:greengrass:us-east-1:123456789012:coreDevices:MyGreengrassCore"], "detail": { "components": [ { "componentName": "MyComponent", "componentVersion": "1.0.0", "root": true, "lifecycleState": "ERRORED|BROKEN", "lifecycleStatusCodes": ["STARTUP_ERROR"], "lifecycleStateDetails": "An error occurred during startup. The startup script exited with code 1." } ] } } ``` ------ #### [ Greengrass nucleus v2.12.3 and later ] Status komponen: `ERRORED` atau `BROKEN` ``` { "version":"0", "id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8", "detail-type":"Greengrass V2 Installed Component Status Change", "source":"aws.greengrass", "account":"123456789012", "region":"us-west-2", "time":"2018-03-22T00:38:11Z", "resources":["arn:aws:greengrass:us-east-1:123456789012:coreDevices:MyGreengrassCore"], "detail": { "components": [ { "componentName": "MyComponent", "componentVersion": "1.0.0", "root": true, "lifecycleState": "ERRORED|BROKEN", "lifecycleStatusCodes": ["STARTUP_ERROR"], "lifecycleStateDetails": "An error occurred during startup. The startup script exited with code 1." } ] } } ``` Status komponen: `RUNNING` atau `FINISHED` ``` { "version":"0", "id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8", "detail-type":"Greengrass V2 Installed Component Status Change", "source":"aws.greengrass", "account":"123456789012", "region":"us-west-2", "time":"2018-03-22T00:38:11Z", "resources":["arn:aws:greengrass:us-east-1:123456789012:coreDevices:MyGreengrassCore"], "detail": { "components": [ { "componentName": "MyComponent", "componentVersion": "1.0.0", "root": true, "lifecycleState": "RUNNING|FINISHED", "lifecycleStateDetails": null } ] } } ``` ------ Anda dapat membuat aturan dan acara yang akan memperbarui Anda tentang status komponen yang diinstal. Peristiwa dimulai saat komponen mengubah status pada perangkat. Anda akan menerima tanggapan terperinci yang menjelaskan mengapa suatu komponen salah atau rusak. Anda juga akan menerima kode status yang akan menunjukkan alasan kegagalan tersebut. Untuk informasi selengkapnya tentang kode status komponen, lihat[Kode status komponen terperinci](troubleshooting-component.md). ## Prasyarat untuk membuat aturan EventBridge Sebelum Anda membuat EventBridge aturan untuk AWS IoT Greengrass, lakukan hal berikut: + Biasakan diri Anda dengan acara, aturan, dan target di EventBridge. + Buat dan konfigurasikan target yang dipanggil oleh EventBridge aturan Anda. Aturan dapat menginvokasi berbagai jenis target, termasuk: + Amazon Simple Notification Service (Amazon SNS) + AWS Lambda fungsi + Amazon Kinesis Video Streams + Antrean Amazon Simple Queue Service (Amazon SQS) Untuk informasi selengkapnya, lihat [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) dan [Memulai dengan Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) di *Panduan EventBridge Pengguna Amazon*. ## Konfigurasikan pemberitahuan kesehatan perangkat (konsol) Gunakan langkah-langkah berikut untuk membuat EventBridge aturan yang menerbitkan topik Amazon SNS saat status penerapan berubah untuk grup. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut. Untuk informasi selengkapnya, lihat [Membuat EventBridge aturan yang memicu peristiwa dari AWS sumber daya](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) di *Panduan EventBridge Pengguna Amazon*. 1. Buka [ EventBridgekonsol Amazon](https://console.aws.amazon.com/events/). 1. Di panel navigasi, pilih **Aturan**. 1. Pilih **Buat aturan**. 1. Masukkan nama dan deskripsi untuk aturan. Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus kejadian yang sama. 1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan acara yang berasal dari akun Anda, pilih **bus acara AWS default**. Ketika AWS layanan di akun Anda memancarkan suatu acara, itu selalu masuk ke bus acara default akun Anda. 1. Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**. 1. Pilih **Selanjutnya**. 1. Untuk **sumber acara**, pilih **AWS acara**. 1. Untuk **pola Acara**, pilih **AWS layanan**. 1. Untuk **AWS layanan**, pilih Greengrass. 1. Untuk **jenis Acara**, pilih dari berikut ini: + Untuk peristiwa penerapan, pilih **Greengrass** V2 Perubahan Status Penerapan Efektif. + Untuk event komponen, pilih **Greengrass** V2 Installed Component Status Change. 1. Pilih **Berikutnya**. 1. Untuk **Jenis target**, pilih **Layanan AWS **. 1. Untuk **Pilih target**, konfigurasikan target Anda. Contoh ini menggunakan topik Amazon SNS, tetapi Anda dapat mengonfigurasi tipe target lain untuk mengirim pemberitahuan. 1. Untuk **Target**, pilih **topik SNS**. 1. Untuk **Topik**, pilih topik target Anda. 1. Pilih **Berikutnya**. 1. Pilih **Berikutnya**. 1. Tinjau detail aturan dan pilih **Buat aturan**. ## Konfigurasikan pemberitahuan kesehatan perangkat (CLI) Gunakan langkah-langkah berikut untuk membuat EventBridge aturan yang menerbitkan topik Amazon SNS saat ada peristiwa perubahan status Greengrass. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut. 1. Buat aturan. + Untuk peristiwa perubahan status penerapan. ``` aws events put-rule \ --name TestRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail-type\": [\"Greengrass V2 Effective Deployment Status Change\"]}" ``` + Untuk peristiwa perubahan status komponen. ``` aws events put-rule \ --name TestRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail-type\": [\"Greengrass V2 Installed Component Status Change\"]}" ``` Properti yang dihilangkan dari tersebut pola akan diabaikan. 1. Tambahkan topik sebagai target aturan. + Ganti *topic-arn* dengan ARN topik Amazon SNS Anda. ``` aws events put-targets \ --rule TestRule \ --targets "Id"="1","Arn"="topic-arn" ``` **catatan** Untuk mengizinkan Amazon EventBridge memanggil topik target Anda, Anda harus menambahkan kebijakan berbasis sumber daya ke topik Anda. Untuk informasi selengkapnya, lihat [izin Amazon SNS di Panduan](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sns-permissions) Pengguna *Amazon EventBridge *. Untuk informasi selengkapnya, lihat [Peristiwa dan pola acara EventBridge di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Panduan EventBridge Pengguna Amazon*. ## Konfigurasikan pemberitahuan kesehatan perangkat (CloudFormation) Gunakan CloudFormation templat untuk membuat EventBridge aturan yang mengirim pemberitahuan tentang perubahan status untuk penerapan grup Greengrass Anda. Untuk informasi selengkapnya, lihat [referensi jenis EventBridge sumber daya Amazon](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Events.html) di *Panduan AWS CloudFormation Pengguna*. ## Lihat juga + [Periksa status deployment perangkat](check-deployment-status.md#check-device-deployment-status) + [Apa itu Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) di *Panduan EventBridge Pengguna Amazon* # Periksa status perangkat inti Greengrass Perangkat inti Greengrass melaporkan status komponen perangkat lunak mereka ke. AWS IoT Greengrass Anda dapat memeriksa ringkasan kesehatan setiap perangkat, dan Anda dapat memeriksa status masing-masing komponen di setiap perangkat. Perangkat inti memiliki status kesehatan berikut: + `HEALTHY`— Perangkat lunak AWS IoT Greengrass Core dan semua komponen berjalan tanpa masalah pada perangkat inti. + `UNHEALTHY`— Perangkat lunak AWS IoT Greengrass Inti atau komponen berada dalam keadaan kesalahan pada perangkat inti. **catatan** AWS IoT Greengrass bergantung pada perangkat individual untuk mengirim pembaruan status ke file. AWS Cloud Jika perangkat lunak AWS IoT Greengrass Core tidak berjalan di perangkat, atau jika perangkat tidak terhubung ke perangkat AWS Cloud, maka status perangkat yang dilaporkan mungkin tidak mencerminkan statusnya saat ini. Cap waktu status menunjukkan kapan status perangkat terakhir diperbarui. Perangkat inti mengirim pembaruan status pada waktu-waktu berikut: Saat perangkat lunak AWS IoT Greengrass inti dimulai Ketika perangkat inti menerima penerapan dari AWS Cloud Untuk Greengrass nucleus 2.12.2 dan sebelumnya, perangkat inti mengirimkan pembaruan status saat status komponen apa pun pada perangkat inti menjadi atau `ERRORED` `BROKEN` Untuk Greengrass nucleus 2.12.3 dan yang lebih baru, perangkat inti mengirimkan pembaruan status saat status komponen apa pun pada perangkat inti menjadi,,, atau `ERRORED` `BROKEN` `RUNNING` `FINISHED` Pada [interval reguler yang dapat Anda konfigurasikan](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-fss), yang defaultnya 24 jam Untuk AWS IoT Greengrass Core v2.7.0 dan yang lebih baru, perangkat inti mengirimkan pembaruan status saat penerapan lokal dan penyebaran cloud terjadi **Topics** + [Periksa kesehatan perangkat inti](#check-core-device-health-status) + [Periksa kesehatan grup perangkat inti](#check-core-device-group-health-status) + [Periksa status komponen perangkat inti](#check-core-device-component-status) ## Periksa kesehatan perangkat inti Anda dapat memeriksa status perangkat inti individu. **Untuk memeriksa status perangkat inti (AWS CLI)** + Jalankan perintah berikut untuk mengambil status deployment. Ganti *coreDeviceName* dengan nama perangkat inti untuk kueri. ``` aws greengrassv2 get-core-device --core-device-thing-name coreDeviceName ``` Tanggapan berisi informasi tentang perangkat inti, termasuk statusnya. ## Periksa kesehatan grup perangkat inti Anda dapat memeriksa status grup perangkat inti (grup objek). **Untuk memeriksa status grup perangkat (AWS CLI)** + Jalankan perintah berikut untuk mengambil status beberapa perangkat inti. Ganti ARN dalam perintah tersebut dengan ARN dari grup objek untuk kueri. ``` aws greengrassv2 list-core-devices --thing-group-arn "arn:aws:iot:region:account-id:thinggroup/thingGroupName" ``` Tanggapan berisi daftar perangkat inti dalam grup objek. Setiap entri dalam daftar berisi status perangkat inti. ## Periksa status komponen perangkat inti Anda dapat memeriksa status, seperti keadaan siklus hidup, dari komponen perangkat lunak pada perangkat inti. Untuk informasi lebih lanjut tentang keadaan siklus hidup komponen, lihat [Kembangkan AWS IoT Greengrass komponen](develop-greengrass-components.md). **Untuk memeriksa status komponen pada perangkat inti (AWS CLI)** + Jalankan perintah berikut untuk mengambil status komponen pada perangkat inti. Ganti *coreDeviceName* dengan nama perangkat inti untuk kueri. ``` aws greengrassv2 list-installed-components --core-device-thing-name coreDeviceName ``` Tanggapan berisi daftar komponen yang berjalan pada perangkat inti. Setiap entri dalam daftar berisi status siklus hidup komponen, termasuk seberapa terkini status data dan kapan perangkat inti Greengrass terakhir mengirim pesan yang berisi komponen tertentu ke cloud. Respons juga akan mencakup sumber penyebaran terbaru yang membawa komponen ke perangkat inti Greengrass. **catatan** Perintah ini mengambil daftar komponen yang dipaginasi yang dijalankan oleh perangkat inti Greengrass. Secara default, daftar ini tidak menyertakan komponen yang digunakan sebagai dependensi komponen lain. Anda dapat menyertakan dependensi dalam respons dengan menyetel `topologyFilter` parameter ke. `ALL`