Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Manajer pengaliran
Komponen pengelola aliran (aws.greengrass.StreamManager) memungkinkan Anda memproses aliran data untuk ditransfer ke perangkat inti Greengrass AWS Cloud dari.
Untuk informasi lebih lanjut tentang cara mengonfigurasi dan menggunakan stream manager di komponen kustom, lihat Kelola aliran data di perangkat inti Greengrass.
Versi
Komponen ini memiliki versi berikut:
-
2.3.x
-
2.2.x
-
2.1.x
-
2.0.x
catatan
Jika Anda menggunakan pengelola aliran untuk mengekspor data ke cloud, Anda tidak dapat memutakhirkan komponen pengelola aliran versi 2.0.7 ke versi antara v2.0.8 dan v2.0.11. Jika Anda menggunakan pengelola aliran untuk pertama kalinya, sebaiknya gunakan komponen pengelola aliran versi terbaru.
Tipe
Komponen ini adalah komponen generik (aws.greengrass.generic). In ti Greengrass menjalankan 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:
-
Per an pertukaran token harus mengizinkan akses ke AWS Cloud tujuan yang Anda gunakan dengan pengelola aliran. Untuk informasi selengkapnya, lihat:
-
Komponen pengelola aliran didukung untuk dijalankan di VPC. Untuk menerapkan komponen ini di VPC, berikut ini diperlukan.
-
Komponen pengelola aliran harus memiliki konektivitas ke AWS layanan tempat Anda mempublikasikan data.
-
Amazon S3:
com.amazonaws.region.s3 -
Aliran Data Amazon Kinesis:
com.amazonaws.region.kinesis-streams -
AWS IoT SiteWise:
com.amazonaws.region.iotsitewise.data
-
-
Jika Anda mempublikasikan data ke Amazon S3 di
us-east-1wilayah tersebut, komponen ini akan mencoba menggunakan titik akhir global S3 secara default; namun, titik akhir ini tidak tersedia melalui titik akhir antarmuka Amazon S3 VPC. Untuk informasi selengkapnya, lihat Pem batasan dan batasan AWS PrivateLink untuk Amazon S3. Untuk mengatasi ini, Anda dapat memilih dari opsi berikut.-
Konfigurasikan komponen pengelola aliran untuk menggunakan titik akhir S3 regional di
us-east-1wilayah tersebut, dengan mengatur-Daws.s3UseUsEast1RegionalEndpoint=regionaldiJVM_ARGS. -
Buat titik akhir VPC gateway Amazon S3 alih-alih titik akhir VPC antarmuka Amazon S3. Titik akhir gateway S3 mendukung akses ke titik akhir global S3. Untuk informasi selengkapnya, lihat Membuat titik akhir gateway.
-
-
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 |
|---|---|---|---|
|
|
443 | Tidak |
Diperlukan jika Anda mempublikasikan data ke Firehose. |
|
|
443 | Tidak |
Diperlukan jika Anda mempublikasikan data ke AWS IoT SiteWise. |
|
|
443 | Tidak |
Diperlukan jika Anda mempublikasikan data ke bucket S3. Anda dapat mengganti |
AWS IoT Analytics dihentikan
AWS IoT Analytics dihentikan pada 15 Desember 2025. iotanalytics.Endpoint tidak lagi berfungsi. Jika Anda memiliki aliran yang dikonfigurasi dengan tujuan region.amazonaws.com.rproxy.goskope.comIoTAnalyticsConfig ekspor, hapus untuk menghindari upaya ekspor yang gagal terus menerus. Untuk informasi selengkapnya, lihat AWS IoT Analytics saluran (dihentikan).
Dependensi
Saat Anda menerapkan komponen, AWS IoT Greengrass juga menerapkan 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
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, dan pengguna sistem yang menjalankan komponen pengelola aliran harus 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 manajer aliran. 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/streamsDefault:
/work/aws.greengrass.StreamManager/greengrass/v2 STREAM_MANAGER_SERVER_PORT-
(Opsional) Nomor port lokal yang akan digunakan untuk berkomunikasi dengan stream manager.
Anda dapat menentukan
0untuk 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. Stream Manager SDK mengontrol interaksi antara klien dan pengelola aliran. Parameter ini menentukan klien mana yang dapat memanggil Manajer Pengaliran untuk bekerja dengan pengaliran. Untuk informasi selengkapnya, lihat autentikasi klien stream manager.
Jika Anda menentukan
true, Stream Manager SDK hanya mengizinkan komponen Greengrass sebagai klien.Jika Anda menentukan
false, Stream Manager SDK memungkinkan semua proses pada perangkat inti 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: Tanpa batas
STREAM_MANAGER_EXPORTER_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
sizeThresholdForMultipartUploadBytesuntuk 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. STREAM_MANAGER_EXPORTER_KINESIS_INTER_CALL_DELAY_MS-
(Opsional) Penundaan, dalam milidetik, pengelola aliran menunggu di antara permintaan berturut-turut saat mengekspor aliran ke tujuan Kinesis Data Streams. Penundaan ini hanya berlaku ketika pengelola aliran tidak dapat menentukan tata letak pecahan aliran data target. Ini dapat terjadi ketika peran pertukaran token Greengrass tidak menyertakan
kinesis:ListShardsizin. Ketika pengelola aliran dapat menentukan tata letak shard, ia menggunakan pacing shard-aware alih-alih penundaan ini. Untuk mematikan penundaan fallback, atur parameter ini ke0.Default:
1000(1 detik) LOG_LEVEL-
(Opsional) Level logging 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.
startupTimeoutSeconds-
(Opsional) Waktu maksimum dalam detik untuk memulai komponen. Status komponen berubah menjadi
ERROREDjika melebihi batas waktu ini.Default:
120
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.
Untuk melihat log komponen ini
-
Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti
atau/greengrass/v2C:\greengrass\v2dengan jalur ke folder AWS IoT Greengrass root.
Changelog
Tabel berikut menjelaskan perubahan dalam setiap versi komponen.
|
Versi |
Perubahan |
|---|---|
|
2.3.1 |
|
|
2.3.0 |
|
|
2.2.1 |
|
|
2.2.0 |
|
|
2.1.13 |
|
|
2.1.12 |
|
|
2.1.11 |
Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis. |
|
2.1.10 |
|
|
2.1.9 |
Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis. |
|
2.1.8 |
|
|
2.1.7 |
|
|
2.1.6 |
|
|
2.1.5 |
Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis. |
|
2.1.4 |
|
|
2.1.3 |
|
|
2.1.2 |
|
|
2.1.1 |
Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis. |
|
2.1.0 |
|
|
2.0.15 |
Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis. |
|
2.0.14 |
Versi ini berisi perbaikan bug dan peningkatan. |
|
2.0.13 |
Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis. |
| 2.0.12 |
|
|
2.0.11 |
Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis. |
|
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. |