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 emitor telemetri nukleus—Itukomponen emitor telemetri inti(aws.greengrass.telemetry.NucleusEmitter) pada perangkat inti Greengrass menerbitkan data telemetri ke$local/greengrass/telemetrytopik secara default. 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 keAWS IoT CoreTopik MQTT pilihan Anda.

    Anda harus menerapkan 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 keAWS Cloudtunduk padaAWS IoT Coreharga.

    AWS IoT Greengrassmenyediakan beberapakomponen komunitasuntuk membantu Anda menganalisis dan memvisualisasikan data telemetri secara lokal pada perangkat inti Anda menggunakan InfluxDB dan Grafana. Komponen-komponen ini menggunakan data telemetri dari komponen emitor nukleus. Untuk informasi lebih lanjut, lihat README untukKomponen penerbit InfluxDB.

  • Agen telemetri—Agen telemetri pada perangkat inti Greengrass mengumpulkan data telemetri lokal dan menerbitkannya ke Amazon EventBridge tanpa memerlukan interaksi pelanggan. Perangkat inti mempublikasikan data telemetri ke EventBridge atas dasar upaya terbaik. 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 keAWS IoT Coretanpa 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 peristiwa yang dapat Anda gunakan untuk menghubungkan aplikasi Anda dengan data dari berbagai sumber, seperti perangkat inti Greengrass. Untuk informasi selengkapnya, lihatApa itu Amazon EventBridge?di dalamAmazon EventBridge Panduan Pengguna.

Untuk memastikan bahwaAWS IoT GreengrassPerangkat lunak inti berfungsi dengan baik,AWS IoT Greengrassmenggunakan data tersebut untuk tujuan pengembangan dan peningkatan kualitas. Fitur ini juga membantu menginformasikan kemampuan edge yang baru dan ditingkatkan.AWS IoT Greengrassmempertahankan data telemetri hingga tujuh hari.

Bagian ini menjelaskan cara mengonfigurasi dan menggunakan agen telemetri. Untuk informasi tentang mengonfigurasi komponen emitor telemetri nukleus, lihatPemancar telemetri inti.

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.

Manajer pengaliran— Fitur ini membutuhkan v2.7.0 atau 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 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 bagaimana memproses data telemetri yang diterbitkan dari agen telemetri pada perangkat inti Greengrass. Saat EventBridge menerima data, ia 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.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 saat 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 EventBridgeaturan

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

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

  • Buat dan konfigurasisasarandipanggil oleh EventBridge aturan. Aturan dapat memanggil berbagai jenis target, seperti Amazon Kinesis Streams, fungsi AWS Lambda, topik Amazon SNS, dan antrean Amazon SQS.

    Klaster EventBridge aturan, dan target terkait harus berada diWilayah AWStempat Anda membuat sumber daya Greengrass Anda. Untuk informasi lebih lanjut, lihat Titik akhir layanan dan kuota di Referensi Umum AWS.

Untuk informasi selengkapnya, lihatApa itu Amazon EventBridge?danMemulai dengan Amazon EventBridgedi dalamAmazon EventBridge Panduan Pengguna.

Buat aturan peristiwa untuk mendapatkan data telemetri (konsol)

Gunakan langkah-langkah berikut untuk menggunakanAWS Management Consoleuntuk 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, lihatMembuat EventBridge aturan yang memicu peristiwa dariAWSsumber dayadi dalamAmazon EventBridge Panduan Pengguna.

  1. BukaAmazon EventBridgekonsol, dan pilihlahBuat 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 Create (Buat).

Buat aturan peristiwa untuk mendapatkan data telemetri (CLI)

Gunakan langkah-langkah berikut untuk menggunakanAWS CLIuntuk membuat EventBridge aturan yang menerima data telemetri yang diterbitkan oleh perangkat inti Greengrass. Hal ini mengizinkan server web, alamat email, dan pelanggan topik lainnya untuk merespon 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 untuk memanggil antrean target Anda, Anda harus menambahkan kebijakan berbasis sumber daya pada topik Anda. Untuk informasi selengkapnya, lihatIzin Amazon SQSdi dalamAmazon EventBridge Panduan Pengguna.

Untuk informasi selengkapnya, lihatPeristiwa dan pola peristiwa di EventBridgedi dalamAmazon EventBridge Panduan Pengguna.