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

iotanalytics.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mempublikasikan data ke AWS IoT Analytics.

kinesis.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mempublikasikan data ke Firehose.

data.iotsitewise.region.amazonaws.com

443 Tidak

Diperlukan jika Anda mempublikasikan data ke AWS 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 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.

2.1.13

Tabel berikut mencantumkan dependensi untuk versi 2.1.11 hingga 2.1.10 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.14.0 Lunak
Layanan pertukaran Token >=0.0.0 Keras
2.1.11 - 2.1.12

Tabel berikut mencantumkan dependensi untuk versi 2.1.11 hingga 2.1.10 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.13.0 Lunak
Layanan pertukaran Token >=0.0.0 Keras
2.1.9 – 2.1.10

Tabel berikut mencantumkan dependensi untuk versi 2.1.9 hingga 2.1.10 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.12.0 Lunak
Layanan pertukaran Token >=0.0.0 Keras
2.1.5 – 2.1.8

Tabel berikut mencantumkan dependensi untuk versi 2.1.5 hingga 2.1.8 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.11.0 Lunak
Layanan pertukaran Token >=0.0.0 Keras
2.1.2 – 2.1.4

Tabel berikut mencantumkan dependensi untuk versi 2.1.2 hingga 2.1.4 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.10.0 Lunak
Layanan pertukaran Token >=0.0.0 Keras
2.1.1

Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.9.0 Lunak
Layanan pertukaran Token >=0.0.0 Keras
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.8.0 Lunak
Layanan pertukaran Token >=0.0.0 Keras
2.0.15

Tabel berikut mencantumkan dependensi untuk versi 2.0.15 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.13 dan 2.0.14 dari komponen ini.

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

Tabel berikut mencantumkan dependensi untuk versi 2.0.11 dan 2.0.12 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti Greengrass >=2.0.0 <2.5.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, 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: /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. 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 menentukantrue, Stream Manager hanya SDK mengizinkan komponen Greengrass sebagai klien.

Jika Anda menentukanfalse, 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.

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

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

Perbaikan bug dan peningkatan

Mendukung FIPS titik akhir untuk AWS IoT SiteWise

2.1.12

Perbaikan bug dan peningkatan

Memperbarui urutan kredensi yang digunakan sehingga kredenal Greengrass lebih disukai untuk permintaan layanan. AWS

2.1.11

Versi diperbarui untuk Greengrass nucleus versi 2.12.0 rilis.

2.1.10

Perbaikan bug dan peningkatan

Memperbaiki masalah di mana konfigurasi HTTPS proxy tidak mempercayai rantai sertifikat otoritas sertifikat Greengrass Certificate Authority (CA).

2.1.9

Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis.

2.1.8

Perbaikan bug dan peningkatan

Memperbaiki masalah di mana manajer aliran mencoba ulang SiteWise ekspor yang gagal tanpa batas. InvalidRequestException

2.1.7

Perbaikan bug dan peningkatan

Memperbaiki masalah di mana manajer aliran gagal membaca konfigurasi proxy dengan benar.

2.1.6

Perbaikan bug dan peningkatan

Memperbaiki masalah yang dapat menyebabkan crash saat startup pada ARMv8 prosesor tertentu, termasuk Jetson Nano.

2.1.5

Versi diperbarui untuk Greengrass nucleus versi 2.10.0 rilis.

2.1.4

Perbaikan bug dan peningkatan
  • Memperbaiki masalah saat entri untuk aset properti yang sama dengan stempel waktu yang sama dalam satu batch kembali ConflictingOperationException dari SiteWise API yang menyebabkan pengelola aliran terus mencoba lagi.

  • Memperbarui batas waktu koneksi default dari 3 detik hingga 1 menit.

2.1.3

Perbaikan bug dan peningkatan

Memperbaiki masalah startup pada OS Windows saat berjalan sebagai SYSTEM pengguna.

2.1.2

Perbaikan bug dan peningkatan
  • Memperbaiki masalah pada OS Windows yang menggunakan bahasa non-Inggris.

  • Versi diperbarui untuk Greengrass nucleus versi 2.9.0 rilis.

2.1.1

Versi diperbarui untuk Greengrass nucleus versi 2.8.0 rilis.

2.1.0

Fitur baru

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
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 pengelola aliran untuk mengekspor data ke cloud, Anda sekarang dapat meningkatkan ke v2.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.