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 AWS Cloud Greengrass.
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.1.x
-
2.0.x
catatan
Jika Anda menggunakan pengelola aliran untuk mengekspor data ke cloud, Anda tidak dapat memutakhirkan versi 2.0.7 komponen pengelola aliran ke versi antara v2.0.8 dan v2.0.11. Jika Anda menerapkan pengelola aliran untuk pertama kalinya, kami sangat menyarankan agar Anda menerapkan versi terbaru komponen pengelola aliran.
Tipe
Komponen ini adalah komponen generik (aws.greengrass.generic
). Inti 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:
-
Peran 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 fileVPC. Untuk menerapkan komponen ini di aVPC, 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-1
wilayah 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 Pembatasan 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-1
wilayah tersebut, dengan menyiapkannya-Daws.s3UseUsEast1RegionalEndpoint=regional
.JVM_ARGS
-
Buat VPC titik akhir gateway Amazon S3 alih-alih titik akhir antarmuka Amazon S3. VPC 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 | Wajib | Deskripsi |
---|---|---|---|
|
443 | Tidak |
Diperlukan jika Anda mempublikasikan data ke AWS IoT Analytics. |
|
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 |
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
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 manajer 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 stream manager. Perintah-perintah ini memungkinkan pengguna sistem defaultggc_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:
/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
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. Manajer Stream SDK mengontrol interaksi antara klien dan manajer aliran. Parameter ini menentukan klien mana yang dapat memanggil Stream Manager SDK untuk bekerja dengan aliran. Untuk informasi selengkapnya, lihat autentikasi klien stream manager.
Jika Anda menentukan
true
, Stream Manager hanya SDK 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. Memori CPU dan perangkat keras perangkat inti Anda adalah 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 input untuk menentukan cara mengumpulkan data dalam PUT permintaan 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 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 mengganti 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" }
Berkas 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/v2
C:\greengrass\v2
dengan jalur ke folder AWS IoT Greengrass root.
Changelog
Tabel berikut menjelaskan perubahan dalam setiap versi komponen.
Versi |
Perubahan |
---|---|
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 perbaikan. |
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. |