Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Mengumpulkan 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. Agen telemetri pada inti Greengrass mengumpulkan data telemetri lokal dan menerbitkannya ke Amazon tanpa memerlukan interaksi pelanggan. EventBridge Perangkat inti mempublikasikan data telemetri dengan upaya terbaik. EventBridge Sebagai contoh, perangkat inti mungkin gagal untuk mengirimkan data telemetri saat offline. **catatan** [Amazon EventBridge adalah layanan bus acara yang dapat Anda gunakan untuk menghubungkan aplikasi Anda dengan data dari berbagai sumber, seperti perangkat inti Greengrass dan pemberitahuan penyebaran.](deployment-notifications.md) 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*. 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. Untuk memastikan bahwa komponen tepi Greengrass 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 hanya menyimpan data telemetri hingga tujuh hari. Fitur ini tersedia dalam perangkat lunak AWS IoT Greengrass Core v1.11.0 dan diaktifkan secara default untuk semua inti Greengrass, termasuk inti yang ada. Anda secara otomatis mulai menerima data segera setelah Anda meningkatkan ke perangkat lunak AWS IoT Greengrass Core v1.11.0 atau yang lebih baru. Untuk informasi tentang cara mengakses atau mengelola data telemetri yang dipublikasikan, lihat [Berlangganan untuk menerima data telemetri](#subscribe-for-telemetry-data). Agen telemetri mengumpulkan dan menerbitkan metrik sistem berikut. **Metrik Telemetri** | Nama | Deskripsi | Sumber | | --- | --- | --- | | `SystemMemUsage` | Jumlah memori yang saat ini digunakan oleh semua aplikasi pada perangkat inti Greengrass, termasuk sistem operasi. | Sistem | | `CpuUsage` | Jumlah CPU yang saat ini digunakan oleh semua aplikasi pada perangkat inti Greengrass, termasuk sistem operasi. | Sistem | | `TotalNumberOfFDs` | Bilangan deskriptor file yang disimpan oleh sistem operasi perangkat inti Greengrass. Satu file deskriptor secara unik mengidentifikasi satu file yang terbuka. | Sistem | | `LambdaOutOfMemory` | Jumlah yang berjalan dan menghasilkan fungsi Lambda akan kehabisan memori. | Sistem | | `DroppedMessageCount` | Jumlah pesan dibatalkan yang ditujukan untuk AWS IoT Core. | `GGCloudSpooler` komponen sistem | | `LambdaTimeout` | Jumlah timeout untuk menjalankan fungsi Lambda yang ditetapkan pengguna. | Fungsi, dan sistem Lambda yang ditentukan pengguna AWS Cloud | | `LambdaUngracefullyKilled` | Jumlah yang berjalan yang ditetapkan pengguna fungsi Lambda gagal untuk selesai. | Fungsi, dan sistem Lambda yang ditentukan pengguna AWS Cloud | | `LambdaError` | Jumlah yang berjalan yang menghasilkan catatan kesalahan penulisan fungsi Lambda yang ditetapkan pengguna. | Fungsi, dan sistem Lambda yang ditentukan pengguna AWS Cloud | | `BytesAppended` | Jumlah byte data ditambahkan ke pengelola pengaliran. | `GGStreamManager` komponen sistem | | `BytesUploadedToIoTAnalytics` | Jumlah byte data yang diekspor pengelola aliran ke saluran. AWS IoT Analytics | `GGStreamManager` komponen sistem | | `BytesUploadedToKinesis` | Jumlah byte data yang diekspor pengelola pengaliran ke pengaliran di Amazon Kinesis Data Streams. | `GGStreamManager` komponen sistem | | `BytesUploadedToIoTSiteWise` | Jumlah byte data yang diekspor manajer aliran ke properti aset di. AWS IoT SiteWise | `GGStreamManager` komponen sistem | | `BytesUploadedToS3ExportTaskExecutor` | Jumlah byte data yang diekspor pengelola pengaliran ke objek di Amazon S3. | `GGStreamManager` komponen sistem | | `BytesUploadedToHTTP` | Jumlah byte data yang diekspor pengelola pengaliran ke HTTP. | `GGStreamManager` komponen sistem | ## Mengonfigurasi pengaturan telemetri Telemetri Greengrass menggunakan pengaturan berikut: + Agen telemetri mengumpulkan data telemetri setiap jam. + Agen telemetri menerbitkan pesan telemetri setiap 24 jam. **catatan** Pengaturan tidak dapat diubah. Anda dapat mengaktifkan atau menonaktifkan fitur telemetri untuk perangkat core Greengrass. AWS IoT Greengrass menggunakan [bayangan](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html) untuk mengelola konfigurasi telemetri. Perubahan Anda segera berlaku ketika inti memiliki koneksi ke AWS IoT Core. Agen telemetri menerbitkan data menggunakan protokol MQTT dengan tingkat kualitas layanan (QoS) 0. Ini berarti bahwa hal tersebut 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 tidak AWS IoT Core dikenakan 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. ### Persyaratan Persyaratan berikut berlaku, ketika Anda mengonfigurasi pengaturan telemetri: + Anda harus menggunakan perangkat lunak AWS IoT Greengrass Core v1.11.0 atau yang lebih baru. **catatan** Jika Anda menjalankan versi sebelumnya dan Anda tidak ingin menggunakan telemetri, Anda tidak perlu melakukan apapun. + Anda harus memberikan izin IAM untuk memperbarui bayangan inti (benda) dan memanggil konfigurasi APIs sebelum Anda memperbarui pengaturan telemetri. Contoh kebijakan IAM berikut memungkinkan Anda mengelola bayangan dan waktu aktif konfigurasi core tertentu: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowManageShadow", "Effect": "Allow", "Action": [ "iot:GetThingShadow", "iot:UpdateThingShadow", "iot:DeleteThingShadow", "iot:DescribeThing" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:thing/core-name-*" ] }, { "Sid": "AllowManageRuntimeConfig", "Effect": "Allow", "Action": [ "greengrass:GetCoreRuntimeConfiguration", "greengrass:UpdateCoreRuntimeConfiguration" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:thing/core-name" ] } ] } ``` ------ Anda dapat memberikan akses terperinci atau bersyarat ke sumber daya, misalnya, dengan menggunakan wildcard `*` skema penamaan. Untuk informasi lebih lanjut, lihat [Penambahan dan Penghapusan kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dalam *Panduan Pengguna IAM*. ### Konfigurasikan pengaturan telemetri (konsol) Berikut ini menunjukkan cara memperbarui pengaturan telemetri inti Greengrass di konsol. AWS IoT Greengrass 1. **Di panel navigasi AWS IoT konsol, di bawah **Kelola**, perluas perangkat **Greengrass**, lalu pilih Grup (V1).** 1. Untuk **grup Greengrass**, pilih grup target. 1. Pada halaman konfigurasi grup, di bagian **Ikhtisar**, pilih inti **Greengrass** Anda. 1. Pada halaman konfigurasi inti, pilih tab **Telemetri**. 1. **Di bagian **Telemetri kesehatan sistem**, pilih Konfigurasi.** 1. Di **Konfigurasi telemetri**, pilih Telemetri untuk mengaktifkan atau menonaktifkan status Telemetri. **penting** Secara default, fitur telemetri diaktifkan untuk perangkat lunak AWS IoT Greengrass Core v1.11.0 atau yang lebih baru. Perubahan berlaku pada saatwaktu aktif. Anda tidak perlu men-deploy grup. ### Mengonfigurasi pengaturan telemetri (CLI) Di AWS IoT Greengrass API, `TelemetryConfiguration` objek mewakili pengaturan telemetri inti Greengrass. Objek ini adalah bagian dari objek `RuntimeConfiguration` yang terkait dengan core. Anda dapat menggunakan AWS IoT Greengrass API, AWS CLI, atau AWS SDK untuk mengelola telemetri Greengrass. Contoh di bagian ini menggunakan AWS CLI. **Untuk memeriksa pengaturan telemetri** Perintah berikut mendapat pengaturan telemetri dari core Greengrass. + Ganti *core-thing-name* dengan nama inti target. Untuk mendapatkan nama benda, Anda menggunakan [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)perintah. Perintah mengembalikan ARN dari hal yang berisi nama hal. ``` aws greengrass get-thing-runtime-configuration --thing-name core-thing-name ``` Perintah mengembalikan objek `GetCoreRuntimeConfigurationResponse` dalam respons JSON. Contoh: ``` { "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "OutOfSync", "Telemetry": "On" } } } ``` **Untuk mengkonfigurasi pengaturan telemetri** Perintah berikut membarui pengaturan telemetri untuk core Greengrass. + Ganti *core-thing-name* dengan nama inti target. Untuk mendapatkan nama benda, Anda menggunakan [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)perintah. Perintah mengembalikan ARN dari hal yang berisi nama hal. ``` aws greengrass update-thing-runtime-configuration --thing-name core-thing-name --telemetry-configuration '{ "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "InSync", "Telemetry": "Off" } } } ``` ``` aws greengrass update-thing-runtime-configuration --thing-name core-thing-name --telemetry-configuration "{\"TelemetryConfiguration\":{\"ConfigurationSyncStatus\":\"InSync\",\"Telemetry\":\"Off\"}}" ``` Perubahan pengaturan telemetri telah diterapkan jika `ConfigurationSyncStatus` adalah `InSync`. Perubahan berlaku pada saatwaktu aktif. Anda tidak perlu men-deploy grup. #### TelemetryConfiguration objek Objek `TelemetryConfiguration` memiliki properti berikut: `ConfigurationSyncStatus` Periksa apakah pengaturan telemetri sudah sinkron. Anda mungkin tidak membuat perubahan pada properti ini. Jenis: string Nilai yang valid: `InSync` atau `OutOfSync` `Telemetry` Menghidupkan atau mematikan telemetri. Default-nya adalah `On`. Jenis: string Nilai yang valid: `On` atau `Off` ## Berlangganan untuk menerima data telemetri Anda dapat membuat aturan di Amazon EventBridge yang menentukan cara memproses data telemetri yang diterbitkan dari 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 acara, mengambil tindakan korektif, atau memanggil acra lain. ### Peristiwa Telemetri Acara untuk perubahan status deployment termasuk data telemetri menggunakan format berikut: ``` { "version": "0", "id": "f70f943b-9ae2-e7a5-fec4-4c22178a3e6a", "detail-type": "Greengrass Telemetry Data", "source": "aws.greengrass", "account": "123456789012", "time": "2020-07-28T20:45:53Z", "region": "us-west-1", "resources": [], "detail": { "ThingName": "CoolThing", "Schema": "2020-06-30", "ADP": [ { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToKinesis", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToS3ExportTaskExecutor", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToHTTP", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToIoTAnalytics", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToIoTSiteWise", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function", "M": [ { "N": "LambdaTimeout", "Sum": 15, "U": "Count" } ] }, { "TS": 123231546, "NS": "CloudSpooler", "M": [ { "N": "DroppedMessageCount", "Sum": 15, "U": "Count" } ] }, { "TS": 1593727692, "NS": "SystemMetrics", "M": [ { "N": "SystemMemUsage", "Sum": 11.23, "U": "Megabytes" }, { "N": "CpuUsage", "Sum": 35.63, "U": "Percent" }, { "N": "TotalNumberOfFDs", "Sum": 416, "U": "Count" } ] }, { "TS": 1593727692, "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function", "M": [ { "N": "LambdaOutOfMemory", "Sum": 12, "U": "Count" }, { "N": "LambdaUngracefullyKilled", "Sum": 100, "U": "Count" }, { "N": "LambdaError", "Sum": 7, "U": "Count" } ] } ] } } ``` Array `ADP` berisi daftar titik data agregat yang memiliki sifat sebagai berikut: `TS` Wajib. Timestamp saat data dikumpulkan. `NS` Wajib. Namespace dari sistem. `M` Wajib. Daftar metrik. Metrik ini berisi properti berikut: `N` Nama [metrik](#telemetry-metrics). `Sum` Nilai metrik agregat. Agen telemetri menambahkan nilai baru ke total sebelumnya, sehingga jumlahnya adalah nilai yang terus meningkat. Anda dapat menggunakan timestamp untuk menemukan nilai agregasi tertentu. Misalnya, untuk menemukan nilai agregat terbaru, kurangi nilai berstempel waktu sebelumnya dari nilai berstempel waktu terbaru. `U` Unit nilai metrik. `ThingName` Wajib. Nama perangkat hal yang Anda targetkan. ### 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 dengan 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 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. Pilih **Bus acara** - dan aktifkan aturan pada bus acara yang dipilih.. 1. Pilih **tipe Rule** dan pilih **Rule with an event pattern**. 1. Pilih **Berikutnya**. 1. Untuk **sumber Acara**, pilih **AWS acara atau acara EventBridge mitra**. 1. Untuk **acara Contoh, pilih **AWS acara****, dan pilih Data **Telemetri Greengrass**. 1. Dalam **pola Peristiwa**, buat pilihan berikut: 1. Untuk **Sumber peristiwa**, pilih **Layanan AWS **. 1. Untuk **AWS layanan**, pilih **Greengrass**. 1. Untuk **jenis Acara**, pilih Data **Telemetri Greengrass**. 1. Pilih **Berikutnya**. 1. Untuk **Target 1**, pilih **AWS layanan**. 1. Untuk **Pilih target**, pilih **antrian SQS**. 1. Untuk **Antrian**, pilih fungsi Anda. ### 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 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 inti. Untuk mendapatkan nama benda, Anda menggunakan [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)perintah. Perintah mengembalikan ARN dari hal yang berisi nama hal. ``` aws events put-rule \ --name TestRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` Properti apa pun yang Anda hilangkan dari 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. ``` aws events put-targets \ --rule TestRule \ --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 acara EventBridge di](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Panduan EventBridge Pengguna Amazon*. ## Memecahkan masalah telemetri AWS IoT Greengrass Gunakan informasi berikut untuk membantu memecahkan masalah dengan mengonfigurasi AWS IoT Greengrass telemetri. ### Kesalahan: Respons berisi "ConfigurationStatus“:OutOfSync" "setelah Anda menjalankan get-thing-runtime-configuration perintah **Solusi:** + Layanan AWS IoT Device Shadow membutuhkan waktu untuk memproses pembaruan konfigurasi runtime dan mengirimkan pembaruan ke perangkat inti Greengrass. Anda dapat menunggu dan memeriksa apakah pengaturan telemetri nanti akan disinkronkan. + Pastikan bahwa perangkat core Anda online. + Aktifkan [Amazon CloudWatch Logs in AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html#viewing-logs) untuk memantau bayangan. + Gunakan [AWS IoT metrik](https://docs.aws.amazon.com/iot/latest/developerguide/monitoring-cloudwatch.html) untuk memantau hal Anda.