Kumpulkan data telemetri kondisi sistem dari perangkat inti AWS IoT Greengrass - AWS IoT Greengrass

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

Kumpulkan data telemetri kondisi 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 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

    AWS IoT Greengrassmenyediakan beberapa komponen komunitas 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.

  • Agen telemetri —Agen telemetri pada perangkat 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.

    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. Hal ini karena agen tersebut menerbitkan ke topik tersimpan AWS. 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 lebih lanjut, lihat Apa itu Amazon EventBridge? 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 Greengrassmenyimpan 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

Metrik telemetri

Tabel berikut menjelaskan metrik yang diterbitkan oleh agen telemetri.

Nama Penjelasan

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 pengaliran ke saluran di AWS IoT Analytics.

BytesUploadedToKinesis

Jumlah byte data yang diekspor pengelola pengaliran ke pengaliran di Amazon Kinesis Data Streams.

BytesUploadedToIoTSiteWise

Jumlah byte data yang diekspor pengelola pengaliran ke properti aset di AWS IoT SiteWise.

BytesUploadedToS3

Jumlah byte data yang diekspor pengelola pengaliran ke objek di Amazon S3.

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 tidak dipungut biaya. Hal ini karena agen tersebut menerbitkan ke topik tersimpan AWS. 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 saat Anda men-deploy komponen inti Greengrass.

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, itu 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" } ] } ] } }

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 lebih lanjut tentang setiap metrik, lihatMetrik telemetri.

Prasyarat untuk membuat aturan EventBridge

Sebelum Anda membuat EventBridge aturan untukAWS IoT Greengrass, Anda harus melakukan hal berikut:

  • Biasakan diri Anda dengan acara, aturan, dan target di EventBridge.

  • Buat dan konfigurasikan target yang dipanggil oleh EventBridge aturan Anda. Aturan dapat memanggil berbagai jenis target, seperti Amazon Kinesis Streams, fungsi AWS Lambda, topik Amazon SNS, dan antrean 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 di. Referensi Umum AWS

Untuk informasi lebih lanjut, lihat Apa itu Amazon EventBridge? dan Memulai Amazon EventBridge di Panduan EventBridge Pengguna Amazon.

Buat aturan peristiwa untuk mendapatkan data telemetri (konsol)

Gunakan langkah-langkah berikut untuk menggunakan aturan AWS Management Console 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 di Panduan EventBridge Pengguna Amazon.

  1. Buka EventBridgekonsol Amazon, dan pilih Buat aturan.

  2. Di bawah Nama dan deskripsi, masukkan nama dan deskripsi untuk alarm Anda.

  3. Di bawah Tentukan pola, konfigurasikan pola aturan.

    1. Pilih Pola kejadian.

    2. Pilih Pola yang ditentukan sebelumnya oleh layanan.

    3. Untuk Penyedia layanan, pilih AWS.

    4. Untuk Nama layanan, pilih Greengrass.

    5. Untuk Jenis peristiwa, pilih Data Telemetri Greengrass.

  4. Di bawah Pilih bus peristiwa, jaga default opsi bus peristiwa.

  5. 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.

    2. Untuk Antrean, pilih antrean target Anda.

  6. Di bawah Tag - opsional, tentukan tag untuk aturan tersebut atau biarkan kolom tersebut kosong.

  7. 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 objek 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.

  2. Tambahkan topik sebagai target aturan. Contoh berikut menggunakan Amazon SQS tetapi Anda dapat mengonfigurasi jenis target lainnya.

    • Ganti queue-arn dengan ARN dari antrean 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 Pengguna Amazon EventBridge .

Untuk informasi selengkapnya, lihat Peristiwa dan pola peristiwa EventBridge di Panduan EventBridge Pengguna Amazon.