Pemancar telemetri inti - AWS IoT Greengrass

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

Pemancar telemetri inti

Komponen emitor telemetri inti (aws.greengrass.telemetry.NucleusEmitter) mengumpulkan data telemetri kesehatan sistem dan menerbitkannya terus ke topik lokal danAWS IoT CoreTopik MQTT. Komponen ini memungkinkan Anda mengumpulkan telemetri sistem real-time di perangkat inti Greengrass Anda. Untuk informasi tentang agen telemetri Greengrass yang menerbitkan data telemetri sistem ke Amazon EventBridge, lihatKumpulkan data telemetri kondisi sistem dari perangkat inti AWS IoT Greengrass.

Secara default, komponen pemancar telemetri nukleus menerbitkan data telemetri setiap 60 detik ke topik publish/subscribe lokal berikut.

$local/greengrass/telemetry

Komponen pemancar telemetri nukleus tidak dipublikasikan keAWS IoT CoreTopik MQTT secara default. Anda dapat mengkonfigurasi komponen ini untuk mempublikasikan keAWS IoT CoreTopik MQTT saat Anda menyebarkannya. 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.

Versi

Komponen ini memiliki versi berikut:

  • 1.0.x

Tipe

Komponen ini adalah komponen plugin (aws.greengrass.plugin). Inti Greengrass menjalankan komponen plugin dalam Java Virtual Machine (JVM) yang sama sebagai inti. Nucleus dimulai ulang saat Anda mengubah versi komponen ini di perangkat inti.

Komponen plugin menggunakan file log yang sama seperti inti Greengrass. Untuk informasi selengkapnya, lihat PemantauanAWS IoT Greengrasslog.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

Dependensi

Saat Anda men-deploy komponen, AWS IoT Greengrass juga men-deploy versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

1.0.3

Tabel berikut mencantumkan dependensi untuk versi 1.0.3 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >>>=2.4.0 <2.4.0 Keras
1.0.2

Tabel berikut mencantumkan dependensi untuk versi 1.0.2 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >>>=2.4.0 <2.4.0 Keras
1.0.1

Tabel berikut mencantumkan dependensi untuk versi 1.0.1 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >>>=2.4.0 <2.4.0 Keras
1.0.0

Tabel berikut mencantumkan dependensi untuk versi 1.0.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >>>=2.4.0 <2.4.0 Keras

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

pubSubPublish

(Opsional) Mendefinisikan apakah akan mempublikasikan data telemetri ke$local/greengrass/telemetrytopik. Nilai yang didukung adalah true dan false.

Default: true

mqttTopic

(Opsional)AWS IoT CoreTopik MQTT yang komponen ini menerbitkan data telemetri.

Tetapkan nilai ini keAWS IoT CoreTopik MQTT yang Anda inginkan untuk menerbitkan data telemetri. Ketika nilai ini kosong, pemancar nukleus tidak mempublikasikan data telemetri keAWS Cloud.

catatan

Penggunaan topik MQTT untuk mempublikasikan data keAWS Cloudtunduk padaAWS IoT Coreharga.

Default: ""

telemetryPublishIntervalMs

(Opsional) Jumlah waktu (dalam milidetik) yang di antaranya komponen menerbitkan data telemetri. Jika Anda menetapkan nilai ini lebih rendah dari nilai minimum yang didukung, komponen akan menggunakan nilai minimum sebagai gantinya.

catatan

Interval publikasi yang lebih rendah menghasilkan penggunaan CPU yang lebih tinggi pada perangkat inti Anda. Kami menyarankan Anda memulai dengan interval publikasi default dan menyesuaikannya berdasarkan penggunaan CPU perangkat Anda.

Minimum:500

Default: 60000

contoh Contoh: Pembaruan gabungan gabungan konfigurasi

Contoh berikut menunjukkan pembaruan gabungan konfigurasi sampel yang memungkinkan penerbitan data telemetri setiap 5 detik ke$local/greengrass/telemetrytopik dan topikgreengrass/myTelemetry AWS IoT CoreTopik MQTT.

{ "pubSubPublish": "true", "mqttTopic": "greengrass/myTelemetry", "telemetryPublishIntervalMs": 5000 }

Data output

Komponen ini menerbitkan metrik telemetri sebagai array JSON pada topik berikut.

Topik lokal: $local/greengrass/telemetry

Anda dapat memilih untuk juga mempublikasikan metrik telemetri keAWS IoT CoreTopik MQTT. Untuk informasi selengkapnya tentang topik, lihatTopik MQTTdi dalamAWS IoT CorePanduan Pengembang.

contoh Contoh data sampel data

[ { "A": "Average", "N": "CpuUsage", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Percent", "V": 26.21981271562346 }, { "A": "Count", "N": "TotalNumberOfFDs", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Count", "V": 7316 }, { "A": "Count", "N": "SystemMemUsage", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Megabytes", "V": 10098 }, { "A": "Count", "N": "NumberOfComponentsStarting", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsInstalled", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsStateless", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsStopping", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsBroken", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsRunning", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 7 }, { "A": "Count", "N": "NumberOfComponentsErrored", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsNew", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsFinished", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 2 } ]

Rangkaian keluaran berisi daftar metrik yang memiliki properti sebagai berikut:

A

Jenis agregasi untuk metrik.

UntukCpuUsagemetrik, properti ini diatur keAveragekarena nilai metrik yang dipublikasikan adalah jumlah penggunaan CPU rata-rata sejak peristiwa publikasi terakhir.

Untuk semua metrik lainnya, pemancar nukleus tidak menggabungkan nilai metrik, dan properti ini diatur keCount.

N

Nama metrik.

NS

Namespace metrik.

TS

Cap waktu saat data dikumpulkan.

U

Unit nilai metrik.

V

Nilai metrik.

Pemancar inti menerbitkan metrik berikut:

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

Penggunaan

Untuk menggunakan data telemetri kesehatan sistem, Anda dapat membuat komponen khusus yang berlangganan topik tempat pemancar nukleus menerbitkan data telemetri, dan bereaksi terhadap data tersebut sesuai kebutuhan. Karena komponen pemancar nukleus menyediakan opsi untuk mempublikasikan data telemetri ke topik lokal, Anda dapat berlangganan topik itu, dan menggunakan data yang dipublikasikan untuk bertindak secara lokal di perangkat inti Anda. Perangkat inti kemudian dapat bereaksi terhadap data telemetri bahkan ketika memiliki konektivitas terbatas ke cloud.

Misalnya, Anda dapat mengonfigurasi komponen yang mendengarkan pada$local/greengrass/telemetrytopik untuk data telemetri dan mengirim data ke komponen stream manager untuk mengalirkan data Anda keAWS Cloud. Untuk informasi selengkapnya tentang membuat komponen seperti itu, lihatPesan lokal publikasi/berlangganandanBuat komponen kustom yang menggunakan stream manager.

File log log lokal

Komponen ini menggunakan file log yang sama sepertiInti Greengrasskomponen.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log

Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti/greengrass/v2atauC:\greengrass\v2dengan jalur keAWS IoT Greengrassfolder akar.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

1.0.3

Versi yang diperbarui untuk rilis inti Greengrass versi 2.0.

1.0.2

Versi yang diperbarui untuk rilis inti Greengrass versi 2.6.0.

1.0.1

Versi yang diperbarui untuk rilis inti Greengrass versi 2.5.0.

1.0.0

Versi awal.