Manajer pengaliran - AWS IoT Greengrass

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

Manajer pengaliran

Komponen stream manager (aws.greengrass.StreamManager) memungkinkan Anda untuk memproses aliran data untuk dipindahkan ke AWS Cloud dari perangkat inti Greengrass.

Untuk informasi lebih lanjut tentang cara mengonfigurasi dan menggunakan stream manager di komponen kustom, lihat Mengelola aliran data di perangkat inti Greengrass.

Versi

Komponen ini memiliki versi berikut:

  • 2.1.x

  • 2.0.x

catatan

Jika Anda menggunakan stream manager untuk mengekspor data ke cloud, Anda tidak dapat meningkatkan versi 2.0.7 komponen stream manager ke versi antara v2.0.8 dan v2.0.11. Jika Anda menggunakan stream manager untuk pertama kalinya, kami sangat menyarankan agar Anda menggunakan komponen stream manager versi terbaru.

Tipe

Inikomponen adalah komponen generik (aws.greengrass.generic). YangInti Greengrassmenjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

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

  • Linux

  • Windows

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

Titik akhir dan port

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Titik Akhir Port Diperlukan Deskripsi

iotanalytics.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mempublikasikan data keAWS IoT Analytics.

kinesis.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mempublikasikan data ke Kinesis Data Firehose.

data.iotsitewise.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mempublikasikan data keAWS IoT SiteWise.

*.s3.amazonaws.com

443 Tidak

Diperlukan jika Anda mempublikasikan data ke bucket S3.

Anda dapat mengganti*dengan nama setiap bucket tempat Anda mempublikasikan data.

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.

2.1.0

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >====2.0.0 <2.4.0 Lunak
Layanan pertukaran token >=0.0.0 Keras
2.0.15

Tabel berikut mencantumkan dependensi untuk versi 2.0.15 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >====2.0.0 <2.4.0 Lunak
Layanan pertukaran token >=0.0.0 Keras
2.0.13 and 2.0.14

Tabel berikut mencantumkan dependensi untuk versi 2.0.14 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >====2.0.0 <2.4.0 Lunak
Layanan pertukaran token >=0.0.0 Keras
2.0.11 and 2.0.12

Tabel berikut mencantumkan dependensi untuk versi 2.0.12 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >====2.0.0 <2.4.0 Lunak
Layanan pertukaran token >=0.0.0 Keras
2.0.10

Tabel berikut mencantumkan dependensi untuk versi 2.0.10 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.4.0 Lunak
Layanan pertukaran token >=0.0.0 Keras
2.0.9

Tabel berikut mencantumkan dependensi untuk versi 2.0.9 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.3.0 Lunak
Layanan pertukaran token >=0.0.0 Keras
2.0.8

Tabel berikut mencantumkan dependensi untuk versi 2.0.8 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.2.0 Lunak
Layanan pertukaran token >=0.0.0 Keras
2.0.7

Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.3 <2.1.0 Lunak
Layanan pertukaran token >=0.0.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.

STREAM_MANAGER_STORE_ROOT_DIR

(Opsional) Path absolut dari direktori lokal yang digunakan untuk menyimpan pengaliran. Nilai ini harus dimulai dengan garis miring ke depan (misalnya, /data).

Anda harus menentukan folder yang ada, danpengguna sistem yang menjalankan komponen pengelola aliranharus memiliki izin untuk membaca dan menulis ke folder ini. Misalnya, Anda dapat menjalankan perintah berikut untuk membuat dan mengkonfigurasi folder,/var/greengrass/streams, yang Anda tentukan sebagai folder root stream manager. Perintah ini memungkinkan pengguna sistem default,ggc_user, untuk membaca dan menulis ke folder ini.

sudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streams

Default: /greengrass/v2/work/aws.greengrass.StreamManager

STREAM_MANAGER_SERVER_PORT

(Opsional) Nomor port lokal yang akan digunakan untuk berkomunikasi dengan stream manager.

Anda dapat menentukan 0 untuk menggunakan port yang tersedia secara acak.

Default: 8088

STREAM_MANAGER_AUTHENTICATE_CLIENT

(Opsional) Anda dapat membuatnya wajib bagi klien untuk melakukan autentikasi sebelum mereka dapat berinteraksi dengan stream manager. SDK Manajer Aliran mengendalikan interaksi antara klien dan stream manager. Parameter ini menentukan klien mana yang dapat memanggil Manajer Pengaliran untuk bekerja dengan pengaliran. Untuk informasi selengkapnya, lihat autentikasi klien stream manager.

Jika Anda menentukantrue, SDK Pengelola Aliran hanya mengizinkan komponen Greengrass sebagai klien.

Jika Anda menentukanfalse, SDK Pengelola Aliran memungkinkan semua proses pada perangkat inti untuk menjadi klien.

Default: true

STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH

(Opsional) Bandwidth maksimum rata-rata (dalam kilobit per detik) yang dapat digunakan oleh pengelola pengaliran untuk mengekspor data.

Default: Tidak ada batasan

STREAM_MANAGER_THREAD_POOL_SIZE

(Opsional) Jumlah maksimum utas aktif yang dapat digunakan stream manager untuk mengekspor data.

Ukuran optimal tergantung pada perangkat keras Anda, volume aliran, dan jumlah yang direncanakan dari aliran ekspor. Jika kecepatan ekspor lambat, Anda dapat menyesuaikan pengaturan ini untuk menemukan ukuran optimal untuk perangkat keras dan kasus bisnis Anda. CPU dan memori perangkat keras inti Anda merupakan faktor pembatas. Untuk memulai, Anda dapat mencoba menetapkan nilai ini sama dengan jumlah inti prosesor pada perangkat.

Hati-hati untuk tidak menetapkan ukuran yang lebih tinggi dari yang dapat didukung perangkat keras Anda. Setiap aliran mengonsumsi sumber daya perangkat keras, jadi cobalah untuk membatasi jumlah aliran ekspor pada perangkat yang dibatasi.

Default: 5 utas

STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES

(Opsional) Ukuran minimum (dalam byte) dari bagian dalam unggahan multipart ke Amazon S3. Stream manager menggunakan pengaturan ini dan ukuran file inputnya untuk menentukan bagaimana melakukan batch data dalam permintaan PUT multipart.

catatan

Stream manager menggunakan properti aliran sizeThresholdForMultipartUploadBytes untuk menentukan apakah akan mengekspor ke Amazon S3 sebagai unggahan tunggal atau multipart. Komponen AWS IoT Greengrass dapat mengatur ambang batas ini ketika membuat aliran yang diekspor ke Amazon S3.

Default: 5242880 (5 MB). Ini juga merupakan nilai minimum.

LOG_LEVEL

(Opsional) Tingkat pencatatan untuk komponen. Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

Default: INFO

JVM_ARGS

(Opsional) Argumen Mesin Virtual Java kustom yang akan disampaikan ke stream manager saat startup. Pisahkan beberapa argumen dengan spasi.

Gunakan parameter ini hanya ketika Anda harus menimpa pengaturan default yang digunakan oleh JVM. Misalnya, Anda mungkin perlu meningkatkan ukuran timbunan default jika berencana mengekspor sejumlah besar pengaliran.

contoh Contoh: Pembaruan gabungan konfigurasi

Contoh konfigurasi berikut menentukan untuk menggunakan port non-default.

{ "STREAM_MANAGER_SERVER_PORT": "18088" }

File log lokal

Komponen ini menggunakan file log berikut.

Linux
/greengrass/v2/logs/aws.greengrass.StreamManager.log
Windows
C:\greengrass\v2\logs\aws.greengrass.StreamManager.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/aws.greengrass.StreamManager.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.greengrass.StreamManager.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

Versi

Perubahan

2.1.0

Fitur baru

2.0.15

Versi yang diperbarui untuk rilis inti Greengrass versi 2.6.0.

2.0.14

Versi ini berisi perbaikan dan perbaikan bug.

2.0.13

Versi yang diperbarui untuk rilis inti Greengrass versi 2.5.0.

2.0.12
Perbaikan bug dan peningkatan

Memperbaiki masalah yang mencegah upgrade stream manager v2.0.7 ke versi antara v2.0.8 dan v2.0.11. Jika Anda menggunakan stream manager untuk mengekspor data ke cloud, Anda sekarang dapat meningkatkan ke v2.0.12.

2.0.11

Versi yang diperbarui untuk rilis inti Greengrass versi 2.4.0.

2.0.10

Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.

2.0.9

Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0.

2.0.8

Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0.

2.0.7

Versi awal.