Pemancar telemetri nukleus - 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 nukleus

Komponen pemancar telemetri nukleus (aws.greengrass.telemetry.NucleusEmitter) mengumpulkan data telemetri kesehatan sistem dan menerbitkannya terus menerus ke topik dan topik lokal. AWS IoT Core MQTT Komponen ini memungkinkan Anda untuk mengumpulkan telemetri sistem real-time pada perangkat inti Greengrass Anda. Untuk informasi tentang agen telemetri Greengrass yang menerbitkan data telemetri sistem ke Amazon, lihat. EventBridge Kumpulkan data telemetri kondisi sistem dari perangkat inti AWS IoT Greengrass

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

$local/greengrass/telemetry

Komponen pemancar telemetri nukleus tidak mempublikasikan ke topik secara default. AWS IoT Core MQTT Anda dapat mengonfigurasi komponen ini untuk dipublikasikan ke suatu AWS IoT Core MQTT topik saat Anda menerapkannya. Penggunaan MQTT topik untuk mempublikasikan data ke AWS Cloud tunduk pada AWS IoT Core harga.

AWS IoT Greengrass menyediakan 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 komponen README penerbit InfluxDB.

Versi

Komponen ini memiliki versi berikut:

  • 1.0.x

Tipe

Komponen ini adalah komponen plugin (aws.greengrass.plugin). Inti Greengrass menjalankan komponen ini di Java Virtual Machine JVM () yang sama dengan nukleus. Nukleus 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 Memantau AWS IoT Greengrass log.

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 menerapkan komponen, gunakan AWS IoT Greengrass juga 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.9

Tabel berikut mencantumkan dependensi untuk versi 1.0.9 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 1.0.8 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 1.0.7 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 1.0.6 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 1.0.5 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 1.0.4 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.4.0 <2.9.0 Keras
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.8.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.7.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.6.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.5.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 topik. $local/greengrass/telemetry Nilai yang didukung adalah true dan false.

Default: true

mqttTopic

(Opsional) AWS IoT Core MQTT Topik di mana komponen ini menerbitkan data telemetri.

Tetapkan nilai ini ke AWS IoT Core MQTT topik yang ingin Anda publikasikan data telemetri. Ketika nilai ini kosong, pemancar nukleus tidak mempublikasikan data telemetri ke. AWS Cloud

catatan

Penggunaan MQTT topik untuk mempublikasikan data ke AWS Cloud tunduk pada AWS IoT Core harga.

Default: ""

telemetryPublishIntervalMs

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

catatan

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

Minimal: 500

Default: 60000

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh berikut menunjukkan pemutakhiran gabungan konfigurasi sampel yang memungkinkan penerbitan data telemetri setiap 5 detik ke $local/greengrass/telemetry topik dan topik. greengrass/myTelemetry AWS IoT Core MQTT

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

Data output

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

Topik lokal: $local/greengrass/telemetry

Anda dapat memilih untuk juga mempublikasikan metrik telemetri ke suatu topik. AWS IoT Core MQTT Untuk informasi selengkapnya tentang topik, lihat MQTTtopik di Panduan AWS IoT Core Pengembang.

contoh Contoh 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 } ]

Array keluaran berisi daftar metrik yang memiliki properti berikut:

A

Jenis agregasi untuk metrik.

Untuk CpuUsage metrik, properti ini disetel ke Average karena nilai metrik yang dipublikasikan adalah jumlah CPU penggunaan rata-rata sejak peristiwa publikasi terakhir.

Untuk semua metrik lainnya, pemancar nukleus tidak menggabungkan nilai metrik, dan properti ini disetel ke. Count

N

Nama metrik.

NS

Namespace metrik.

TS

Stempel waktu kapan data dikumpulkan.

U

Unit nilai metrik.

V

Nilai metrik.

Pemancar nukleus 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 yang CPU 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.

Penggunaan

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

Misalnya, Anda dapat mengonfigurasi komponen yang mendengarkan $local/greengrass/telemetry topik untuk data telemetri dan mengirim data ke komponen pengelola aliran untuk mengalirkan data Anda ke file. AWS Cloud Untuk informasi lebih lanjut tentang membuat komponen seperti itu, lihat Pesan lokal publikasi/berlangganan danBuat komponen kustom yang menggunakan stream manager.

Berkas log lokal

Komponen ini menggunakan file log yang sama dengan komponen inti Greengrass.

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/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

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

Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis.

1.0.8

Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis.

1.0.7

Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis.

1.0.6

Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis.

1.0.5

Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis.

1.0.4

Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis.

1.0.3

Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.

1.0.2

Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis.

1.0.1

Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.

1.0.0

Versi awal.