本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
串流管理員
串流管理員元件 (aws.greengrass.StreamManager) 可讓您處理資料串流，以便 AWS 雲端 從 Greengrass 核心裝置傳輸到。
如需如何在自訂元件中設定和使用串流管理員的詳細資訊，請參閱管理核心裝 Greengrass 資料串流。
版本
此元件具有下列版本：
-
2.1.x
-
2.0.x
注意
如果您使用串流管理員將資料匯出至雲端，則無法將串流管理員元件的 2.0.7 版升級為 v2.0.8 和 v2.0.11 之間的版本。如果您是第一次部署串流管理員，強烈建議您部署最新版本的串流管理員元件。
Type
此元件是一般元件 (aws.greengrass.generic)。Greengrass 核會執行元件的生命週期指令碼。
如需詳細資訊，請參閱元件類型。
作業系統
此元件可安裝在執行下列作業系統的核心裝置上：
Linux
Windows
要求
此元件具有下列需求：
-
T oken 交換角色必須允許存取您搭配串流管理員使用的 AWS 雲端 目的地。如需詳細資訊，請參閱：
-
串流管理員元件支援在VPC. 若要在中部署此元件VPC，需要下列項目。
-
串流管理員元件必須與您發佈資料的目標 AWS 服務具有連線能力。
-
Amazon S3：
com.amazonaws.region.s3 -
Amazon Kinesis Data Streams：
com.amazonaws.region.kinesis-streams -
AWS IoT SiteWise:
com.amazonaws.region.iotsitewise.data
-
-
如果您將資料發佈到
us-east-1區域中的 Amazon S3，則此元件預設會嘗試使用 S3 全球端點；不過，此端點無法透過 Amazon S3 VPC 界面端點使用。如需詳細資訊，請參閱 Amazon S3 AWS PrivateLink 的限制和限制。若要解決此問題，您可以從下列選項中進行選擇。-
透過在中設定，將串流管理員元件設定為使用
us-east-1區域中的區域 S3 端點JVM_ARGS。-Daws.s3UseUsEast1RegionalEndpoint=regional -
建立 Amazon S3 閘道VPC端點，而不是 Amazon S3 界面VPC端點。S3 閘道端點支援對 S3 全球端點的存取。如需詳細資訊，請參閱建立閘道端點。
-
-
端點和連接埠
除了基本作業所需的端點和連接埠之外，此元件還必須能夠對下列端點和連接埠執行輸出要求。如需詳細資訊，請參閱允許裝置流量透過 Proxy 或防火牆。
| 端點 | 連線埠 | 必要 | 描述 |
|---|---|---|---|
|
|
443 | 否 |
如果您將資料發佈到，則為必要 AWS IoT Analytics。 |
|
|
443 | 否 |
如果您將資料發佈至 Firehose，則需要此項。 |
|
|
443 | 否 |
如果您將資料發佈到，則為必要 AWS IoT SiteWise。 |
|
|
443 | 否 |
如果將資料發佈到 S3 儲存貯體，則為必要項 您可以 |
相依性
部署元件時， AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的需求，才能成功部署元件。本節列出此元件之已發行版本的相依性，以及定義每個相依性之元件版本的語意版本條件約束。您也可以在AWS IoT Greengrass 主控台
如需有關元件相依性的詳細資訊，請參閱元件方案參考。
組態
此元件提供下列組態參數，您可以在部署元件時自訂這些參數。
STREAM_MANAGER_STORE_ROOT_DIR-
(選擇性) 用來儲存串流之本機目錄的絕對路徑。此值必須以正斜線開頭 (例如
/data)。您必須指定現有的資料夾，而且執行串流管理員元件的系統使用者必須擁有讀取和寫入此資料夾的權限。例如，您可以執行下列命令來建立和設定資料夾
/var/greengrass/streams，您可以將其指定為串流管理員根資料夾。這些指令允許預設系統使用者讀取和寫入此資料夾。ggc_usersudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streams預設：
/greengrass/v2 STREAM_MANAGER_SERVER_PORT-
(選擇性) 用來與串流管理員通訊的本機連接埠號碼。
您可以指定
0使用隨機可用的連接埠。預設：
8088 STREAM_MANAGER_AUTHENTICATE_CLIENT-
(選擇性) 您可以強制要求用戶端進行驗證，然後才能與串流管理員互動。串流管理員SDK控制用戶端和串流管理員之間的互動。此參數會決定哪些用戶端可呼叫「串流管理員」SDK 來處理串流。如需詳細資訊，請參閱串流管理員用戶端驗證。
如果您指定
true，串流管理員只SDK允許 Greengrass 元件做為用戶端。如果您指定
false，串流管理員會SDK允許核心裝置上的所有處理序做為用戶端。預設：
true STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH-
(選擇性) 串流管理員可用來匯出資料的平均最大頻寬 (以每秒 KB 為單位)。
預設：無限制
STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE-
(選擇性) 串流管理員可用來匯出資料的作用中繫線數目上限。
最佳大小取決於您的硬體、串流磁碟區和規劃的匯出串流數量。如果匯出速度很慢，您可以調整此設定，找出適合您硬體和商務案例的最佳大小。核心裝置硬體的記憶體CPU和記憶體是限制因素。首先，您可以嘗試將此值設定為等同於裝置上處理器核心的數量。
請小心不要設定高於硬體可支援的大小。每個串流都會耗用硬體資源，因此請嘗試限制受限裝置上的匯出串流數量。
預設值：5 個執行緒
STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES-
(選擇性) 多部分上傳至 Amazon S3 時，零件的大小下限 (以位元組為單位)。流管理器使用此設置和輸入文件的大小來確定如何批處理數據在多部分PUT請求。
注意
串流管理員使用串流
sizeThresholdForMultipartUploadBytes屬性來判斷是以單一或多部分上傳方式匯出到 Amazon S3。 AWS IoT Greengrass 元件可以在建立匯出至 Amazon S3 的串流時設定此閾值。預設值：
5242880(5 MB)。這也是最小值。 LOG_LEVEL-
(選擇性) 元件的記錄層級。從下列記錄層級中進行選擇，依照層級順序列出：
-
TRACE -
DEBUG -
INFO -
WARN -
ERROR
預設：
INFO -
JVM_ARGS-
(選擇性) 要在啟動時傳遞至串流管理員的自訂 Java 虛擬機器引數。用空格分隔多個引數。
只有當您必須覆寫使用的預設設定時，才使用此參數JVM。例如，如果您計劃匯出大量串流，可能需要增加預設堆積大小。
範例：組態合併更新
下列範例組態指定使用非預設連接埠。
{ "STREAM_MANAGER_SERVER_PORT": "18088" }
本機記錄檔
此元件使用下列記錄檔。
若要檢視此元件的記錄
-
在核心裝置上執行下列命令，即時檢視此元件的記錄檔。更換
/greengrass/v2C:\greengrass\v2與 AWS IoT Greengrass 根文件夾的路徑。
變更記錄
下表說明元件每個版本中的變更。
|
版本 |
變更 |
|---|---|
|
2.1.13 |
|
|
2.1.12 |
|
|
2.1.11 |
版本更新了 Greengrass 核 2.12.0 版本釋放。 |
|
2.1.10 |
|
|
2.1.9 |
版本更新了 Greengrass 核 2.11.0 版本釋放。 |
|
2.1.8 |
|
|
2.1.7 |
|
|
2.1.6 |
|
|
2.1.5 |
版本更新了 Greengrass 2.10.0 版本。 |
|
2.1.4 |
|
|
2.1.3 |
|
|
2.1.2 |
|
|
2.1.1 |
版本更新 Greengrass 2.8.0 版本的版本。 |
|
2.1.0 |
|
|
2.0.15 |
版本更新 Greengrass 2.6.0 版本的版本。 |
|
2.0.14 |
此版本包含錯誤修復和改進。 |
|
2.0.13 |
版本更新了 Greengrass 核 2.5.0 版本。 |
| 2.0.12 |
|
|
2.0.11 |
版本更新 Greengrass 2.4.0 版本的版本。 |
|
2.0.10 |
版本更新了 Greengrass 核 2.3.0 版本。 |
|
2.0.9 |
版本更新了 Greengrass 核 2.2.0 版本。 |
|
2.0.8 |
版本更新 Greengrass 2.1.0 版本發布。 |
|
2.0.7 |
初始版本。 |
