Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # 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*.