支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪[從 遷移 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 設定 AWS IoT Greengrass 串流管理員
在 AWS IoT Greengrass 核心上，串流管理員可以存放、處理和匯出 IoT 裝置資料。串流管理員可提供您用來設定群組層級執行時間設定的參數。這些設定適用於 Greengrass 核心上的所有串流。您可以使用 AWS IoT 主控台或 AWS IoT Greengrass API 來設定串流管理員設定。變更會在部署群組之後生效。
**注意**
設定串流管理員之後，您可以建立和部署在 Greengrass 核心上執行並與串流管理員互動的 IoT 應用程式。這些 IoT 應用程式通常是使用者定義的 Lambda 函數。如需詳細資訊，請參閱[使用 StreamManagerClient 搭配串流](work-with-streams.md)。
## 串流管理員參數
串流管理員提供下列參數，可讓您定義群組層級的設定。所有參數都是選用的。
**儲存目錄**
參數名稱：`STREAM_MANAGER_STORE_ROOT_DIR`
用來儲存串流的本機目錄絕對路徑。此值必須以正斜線開頭 (例如 `/data`)。
如需保護串流資料安全的資訊，請參閱 [本機資料安全性](stream-manager.md#stream-manager-security-stream-data)。
最低 AWS IoT Greengrass 核心版本：1.10.0
**伺服器連接埠**
參數名稱：`STREAM_MANAGER_SERVER_PORT`
用於與串流管理員通訊的本機連接埠號碼。預設值為 `8088`。
最低 AWS IoT Greengrass 核心版本：1.10.0
**驗證用戶端**
參數名稱：`STREAM_MANAGER_AUTHENTICATE_CLIENT`
表示用戶端是否須經過驗證才能與串流管理員互動。用戶端和串流管理員之間的所有互動都由 AWS IoT Greengrass 核心 SDK 控制。此參數決定哪些用戶端可以呼叫 AWS IoT Greengrass 核心 SDK 來使用串流。如需詳細資訊，請參閱[用戶端身分驗證](stream-manager.md#stream-manager-security-client-authentication)。
有效值為 `true` 或 `false`。預設值為 `true` (建議)。
+ `true`。 僅允許 Greengrass Lambda 函數做為用戶端。Lambda 函數用戶端使用內部 AWS IoT Greengrass 核心通訊協定來驗證 AWS IoT Greengrass 核心 SDK。
+ `false`。 允許在 AWS IoT Greengrass 核心上執行的任何程序成為用戶端。除非業務案例需要，否則請勿設定為 `false`。例如，`false`只有在核心裝置上的非 Lambda 程序必須直接與串流管理員通訊時，才會將此值設定為 ，例如在核心上執行的 [Docker 容器](docker-app-connector.md)。
最低 AWS IoT Greengrass 核心版本：1.10.0
**最高頻寬**
參數名稱：`STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH`
可用來匯出資料的平均最高頻寬 (以千位元數/秒為單位)。預設允許無限使用可用頻寬。
最低 AWS IoT Greengrass 核心版本：1.10.0
**執行緒集區大小**
參數名稱：`STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE`
可用於匯出資料的作用中執行緒數量上限。預設值為 `5`。
最佳大小取決於您的硬體、串流磁碟區和規劃的匯出串流數量。如果匯出速度很慢，您可以調整此設定，找出適合您硬體和商務案例的最佳大小。核心裝置硬體的 CPU 和記憶體是限制因素。首先，您可以嘗試將此值設定為等同於裝置上處理器核心的數量。
請小心不要設定高於硬體可支援的大小。每個串流都會消耗硬體資源，因此您應該嘗試限制受限裝置上的匯出串流數目。
最低 AWS IoT Greengrass 核心版本：1.10.0
**JVM 引數**
參數名稱：`JVM_ARGS`
自訂 Java 虛擬機器參數，以在啟動時傳遞給串流管理員。多個引數應用空格分隔。
僅限必須覆寫 JVM 使用的預設設定時，才能使用此參數。例如，如果您計劃匯出大量串流，可能需要增加預設堆積大小。
最低 AWS IoT Greengrass 核心版本：1.10.0
**唯讀輸入檔案目錄**
參數名稱：`STREAM_MANAGER_READ_ONLY_DIRS`
以逗號分隔的絕對路徑清單，指向存放輸入檔案的根檔案系統外部的目錄。串流管理員會讀取檔案並將其上傳至 Amazon S3，並將目錄掛載為唯讀。如需匯出至 Amazon S3 的詳細資訊，請參閱 [Amazon S3 物件](stream-export-configurations.md#export-to-s3)。
只有在下列情況為 true 時，才使用此參數：
+ 匯出至 Amazon S3 之串流的輸入檔案目錄位於下列其中一個位置：
+ 根檔案系統以外的分割區。
+ 在根檔案系統的 `/tmp`下。
+ Greengrass 群組[的預設容器化](lambda-group-config.md#lambda-containerization-groupsettings)為 **Greengrass 容器**。
範例值：`/mnt/directory-1,/mnt/directory-2,/tmp`
最低 AWS IoT Greengrass 核心版本：1.11.0
**分段上傳的大小下限**
參數名稱：`STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES`
分段中組件的大小下限 （以位元組為單位） 上傳至 Amazon S3。串流管理員使用此設定和輸入檔案的大小，來決定如何在分段 PUT 請求中批次處理資料。預設和最小值為`5242880`位元組 (5 MB)。
串流管理員使用串流的 `sizeThresholdForMultipartUploadBytes` 屬性來判斷要匯出至 Amazon S3 做為單一或分段上傳。使用者定義的 Lambda 函數會在建立匯出至 Amazon S3 的串流時設定此閾值。預設閾值為 5 MB。
最低 AWS IoT Greengrass 核心版本：1.11.0
## 設定串流管理員設定 (主控台)
您可以使用 AWS IoT 主控台執行下列管理任務：
+ [檢查是否已啟用串流管理員](#check-stream-manager-console)
+ [在群組建立期間啟用或停用串流管理員](#enable-stream-manager-console-new-group)
+ [啟用或停用現有群組的串流管理員](#enable-stream-manager-console-existing-group)
+ [變更串流管理員設定](#change-stream-manager-console)
部署 Greengrass 群組之後，變更就會生效。如需說明如何部署 Greengrass 群組的教學課程，其中包含與串流管理員互動的 Lambda 函數，請參閱 [將資料串流匯出至 AWS 雲端 （主控台）](stream-manager-console.md)。
**注意**
當您使用主控台啟用串流管理員並部署群組時，串流管理員的記憶體大小預設為 4194304 KB (4 GB)。我們建議您將記憶體大小設定為至少 128000 KB。
### 檢查是否已啟用串流管理員 (主控台)
1. 在 AWS IoT 主控台導覽窗格的**管理**下，展開 **Greengrass 裝置**，然後選擇**群組 (V1)**。
1. 選擇目標群組。
1. 選擇 **Lambda 函數索引標籤**。
1. 在 **System Lambda 函數**下，選取**串流管理員**，然後選擇**編輯**。
1. 檢查啟用或停用狀態。還會顯示已設定的任何自訂串流管理員設定。
### 在群組建立期間啟用或停用串流管理員 (主控台)
1. 在 AWS IoT 主控台導覽窗格的**管理**下，展開 **Greengrass 裝置**，然後選擇**群組 (V1)**。
1. 選擇 **Create Group (建立群組)**。您在下一個頁面的選擇會決定設定群組串流管理員的方法。
1. 繼續進行**命名您的群組**，然後選擇 **Greengrass 核心**頁面。
1. 選擇**建立群組**。
1. 在群組組態頁面上，選擇 **Lambda 函數**索引標籤，選取**串流管理員**，然後選擇**編輯**。
+ 若要使用預設設定啟用串流管理員，請選擇**使用預設設定啟用**。
+ 若要以自訂設定啟用串流管理員，請選擇 **Customize settings (自訂設定)**。
1. 在**設定串流管理員**頁面上，選擇**使用自訂設定啟用**。
1. 在 **Custom settings (自訂設定)** 下，輸入串流管理員參數的值。如需詳細資訊，請參閱[串流管理員參數](#stream-manager-parameters)。將欄位保留空白 AWS IoT Greengrass ，以允許 使用其預設值。
+ 若要停用串流管理員，請選擇**停用**。
1. 在 **Configure stream manager (設定串流管理員)** 頁面上，選擇 **Disable (停用)**。
1. 選擇**儲存**。
1. 繼續透過剩餘的頁面建立群組。
1. 在**用戶端裝置**頁面上，下載您的安全資源，檢閱資訊，然後選擇**完成**。
**注意**
啟用串流管理員時，您必須先在核心裝置上[安裝 Java 8 執行時間](stream-manager.md#stream-manager-requirements)，才能部署群組。
### 啟用或停用現有群組 (主控台) 的串流管理員
1. 在 AWS IoT 主控台導覽窗格的**管理**下，展開 **Greengrass 裝置**，然後選擇**群組 (V1)**。
1. 選擇目標群組。
1. 選擇 **Lambda 函數索引標籤**。
1. 在 **System Lambda 函數**下，選取**串流管理員**，然後選擇**編輯**。
1. 檢查啟用或停用狀態。還會顯示已設定的任何自訂串流管理員設定。
### 變更串流管理員設定 (主控台)
1. 在 AWS IoT 主控台導覽窗格的**管理**下，展開 **Greengrass 裝置**，然後選擇**群組 (V1)**。
1. 選擇目標群組。
1. 選擇 **Lambda 函數索引標籤**。
1. 在 **System Lambda 函數**下，選取**串流管理員**，然後選擇**編輯**。
1. 檢查啟用或停用狀態。還會顯示已設定的任何自訂串流管理員設定。
1. 選擇**儲存**。
## 設定串流管理員設定 (CLI)
在 中 AWS CLI，使用系統 `GGStreamManager` Lambda 函數來設定串流管理員。System Lambda 函數是 AWS IoT Greengrass Core 軟體的元件。對於串流管理員和其他一些系統 Lambda 函數，您可以透過管理 Greengrass 群組中對應的 `Function`和 `FunctionDefinitionVersion` 物件來設定 Greengrass 功能。如需詳細資訊，請參閱[AWS IoT Greengrass 群組物件模型概觀](deployments.md#api-overview)。
您可以使用 API 執行下列管理任務。本節中的範例示範如何使用 AWS CLI，但您也可以直接呼叫 AWS IoT Greengrass API AWS 或使用 SDK。
+ [檢查是否已啟用串流管理員](#check-stream-manager-cli)
+ [啟用、停用或設定串流管理員](#enable-stream-manager-cli)
變更會在部署群組之後生效。如需說明如何使用與串流管理員互動的 Lambda 函數部署 Greengrass 群組的教學課程，請參閱 [將資料串流匯出至 AWS 雲端 (CLI)](stream-manager-cli.md)。
**提示**
若要查看串流管理員是否已啟用並從核心裝置執行，您可以在裝置上的終端機中執行下列命令。
```
ps aux | grep -i 'streammanager'
```
### 檢查是否已啟用串流管理員 (CLI)
如果您部署的函數定義版本包含系統 `GGStreamManager` Lambda 函數，則會啟用串流管理員。若要檢查，請執行下列動作：
1. 取得目標 Greengrass 群組 ID 和目標群組版本 ID。此程序假設這是最新的群組和群組版本。下列查詢會傳回最近建立的群組。
```
aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
```
或者，您可以依名稱查詢。群組名稱不需要是唯一名稱，因此可能會傳回多個群組。
```
aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
```
**注意**
您也可以在 AWS IoT 主控台中找到這些值。群組 ID 會顯示在群組的 **Settings (設定)** 頁面上。群組版本 IDs會顯示在群組的**部署**索引標籤上。
1. 從輸出中的目標群組複製 `Id` 和 `LatestVersion` 值。
1. 取得最新的群組版本。
+ 將 *group-id* 取代為您複製`Id`的 。
+ 將 *latest-group-version-id* 取代為您複製`LatestVersion`的 。
```
aws greengrass get-group-version \
--group-id group-id \
--group-version-id latest-group-version-id
```
1. 從輸出中的 `FunctionDefinitionVersionArn`，取得函數定義的 ID 和函數定義版本。
+ 函數定義 ID 是遵循 Amazon Resource Name (ARN) 中客`functions`群的 GUID。
+ 函數定義版本 ID 是遵循 ARN 中的 `versions` 區段的 GUID。
```
arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/function-definition-id/versions/function-definition-version-id
```
1. 取得函數定義版本。
+ 用函數定義 ID 替換 *function-definition-id*。
+ 用函數定義版本 ID 替換 *function-definition-version-id*。
```
aws greengrass get-function-definition-version \
--function-definition-id function-definition-id \
--function-definition-version-id function-definition-version-id
```
如果輸出中的 `functions` 陣列包括 `GGStreamManager` 函數，則會啟用串流管理員。為函數定義的任何環境變數代表串流管理員的自訂設定。
### 若要啟用、停用或設定串流管理員 (CLI)
在 中 AWS CLI，使用系統 `GGStreamManager` Lambda 函數來設定串流管理員。變更會在部署群組之後生效。
+ 若要啟用串流管理員，請加入函數定義版本的 `functions` 陣列中的 `GGStreamManager`。若要設定自訂設定，請為對應的[串流管理員參數](#stream-manager-parameters)定義環境變數。
+ 若要停用串流管理員，請從函數定義版本的 `functions` 陣列中移除 `GGStreamManager`。
**採用預設設定的串流管理員**
下列範例設定會以預設設定啟用串流管理員。它將任意函數 ID 設為 `streamManager`。
```
{
"FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
"FunctionConfiguration": {
"MemorySize": 4194304,
"Pinned": true,
"Timeout": 3
},
"Id": "streamManager"
}
```
對於 `FunctionConfiguration` 屬性，您可能知道下列事項：
+ `MemorySize` 設定為具有預設設定的 4194304 KB (4 GB)。您可以隨時變更此值。我們建議您將 `MemorySize`設定為至少 128000 KB。
+ `Pinned` 必須設定為 `true`。
+ 函數定義版本需要 `Timeout`，但 `GGStreamManager` 不會使用它。
**採用自訂設定的串流管理員**
下列範例組態可讓串流管理員具有儲存目錄、伺服器連接埠和執行緒集區大小參數的自訂值。
```
{
"FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
"FunctionConfiguration": {
"Environment": {
"Variables": {
"STREAM_MANAGER_STORE_ROOT_DIR": "/data",
"STREAM_MANAGER_SERVER_PORT": "1234",
"STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE": "4"
}
},
"MemorySize": 4194304,
"Pinned": true,
"Timeout": 3
},
"Id": "streamManager"
}
```
AWS IoT Greengrass 對於未指定為環境變數的[串流管理員參數](#stream-manager-parameters)， 會使用預設值。
**具有 Amazon S3 匯出自訂設定的串流管理員**
下列範例組態可讓串流管理員具有上傳目錄的自訂值，以及最小分段上傳大小參數。
```
{
"FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
"FunctionConfiguration": {
"Environment": {
"Variables": {
"STREAM_MANAGER_READ_ONLY_DIRS": "/mnt/directory-1,/mnt/directory-2,/tmp",
"STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES": "10485760"
}
},
"MemorySize": 4194304,
"Pinned": true,
"Timeout": 3
},
"Id": "streamManager"
}
```
**若要啟用、停用或設定串流管理員 (CLI)**
1. 取得目標 Greengrass 群組 ID 和目標群組版本 ID。此程序假設這是最新的群組和群組版本。下列查詢會傳回最近建立的群組。
```
aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
```
或者，您可以依名稱查詢。群組名稱不需要是唯一名稱，因此可能會傳回多個群組。
```
aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
```
**注意**
您也可以在 AWS IoT 主控台中找到這些值。群組 ID 會顯示在群組的 **Settings (設定)** 頁面上。群組版本 IDs會顯示在群組的**部署**索引標籤上。
1. 從輸出中的目標群組複製 `Id` 和 `LatestVersion` 值。
1. 取得最新的群組版本。
+ 將 *group-id* 取代為您複製`Id`的 。
+ 將 *latest-group-version-id* 取代為您複製`LatestVersion`的 。
```
aws greengrass get-group-version \
--group-id group-id \
--group-version-id latest-group-version-id
```
1. 從輸出複製 `CoreDefinitionVersionArn`和所有其他版本 ARNs，但 除外`FunctionDefinitionVersionArn`。您稍後會在建立群組版本時使用這些值。
1. 從輸出中的 `FunctionDefinitionVersionArn`，複製函數定義的 ID。該 ID 是 ARN 中跟在 `functions` 區段後面的 GUID，如下列範例所示。
```
arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6
```
**注意**
或者，您可以執行 [https://docs.aws.amazon.com/cli/latest/reference/greengrass/create-function-definition.html](https://docs.aws.amazon.com/cli/latest/reference/greengrass/create-function-definition.html)命令來建立函數定義，然後從輸出複製 ID。
1. 新增函數定義版本至函數定義。
+ 將 *function-definition-id* 取代為您為函數定義複製的 `Id`。
+ 在`functions`陣列中，包含您要在 Greengrass 核心上使用的所有其他函數。您可以使用 `get-function-definition-version` 命令來取得現有函數的清單。
**以預設設定啟用串流管理員**
下列範例透過在`functions`陣列中包含 `GGStreamManager`函數來啟用串流管理員。此範例使用[串流管理員參數](#stream-manager-parameters)的預設值。
```
aws greengrass create-function-definition-version \
--function-definition-id function-definition-id \
--functions '[
{
"FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
"FunctionConfiguration": {
"MemorySize": 4194304,
"Pinned": true,
"Timeout": 3
},
"Id": "streamManager"
},
{
"FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
"FunctionConfiguration": {
"Executable": "myLambdaFunction.function_handler",
"MemorySize": 16000,
"Pinned": true,
"Timeout": 5
},
"Id": "myLambdaFunction"
},
... more user-defined functions
]
}'
```
範例中的 `myLambdaFunction`函數代表其中一個使用者定義的 Lambda 函數。
**用自訂設定啟用串流管理員**
下列範例會藉由在 `functions` 陣列中包括 `GGStreamManager` 函數來啟用串流管理員。除非您想要變更預設值，否則所有串流管理員設定都是選用的。此範例說明如何使用環境變數來設定自訂值。
```
aws greengrass create-function-definition-version \
--function-definition-id function-definition-id \
--functions '[
{
"FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
"FunctionConfiguration": {
"Environment": {
"Variables": {
"STREAM_MANAGER_STORE_ROOT_DIR": "/data",
"STREAM_MANAGER_SERVER_PORT": "1234",
"STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE": "4"
}
},
"MemorySize": 4194304,
"Pinned": true,
"Timeout": 3
},
"Id": "streamManager"
},
{
"FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
"FunctionConfiguration": {
"Executable": "myLambdaFunction.function_handler",
"MemorySize": 16000,
"Pinned": true,
"Timeout": 5
},
"Id": "myLambdaFunction"
},
... more user-defined functions
]
}'
```
對於 `FunctionConfiguration` 屬性，您可能知道下列事項：
+ `MemorySize` 設定為具有預設設定的 4194304 KB (4 GB)。您可以隨時變更此值。我們建議您將 `MemorySize`設定為至少 128000 KB。
+ `Pinned` 必須設定為 `true`。
+ 函數定義版本需要 `Timeout`，但 `GGStreamManager` 不會使用它。
**停用串流管理員**
下列範例會省略停用串流管理員的 `GGStreamManager` 函數。
```
aws greengrass create-function-definition-version \
--function-definition-id function-definition-id \
--functions '[
{
"FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
"FunctionConfiguration": {
"Executable": "myLambdaFunction.function_handler",
"MemorySize": 16000,
"Pinned": true,
"Timeout": 5
},
"Id": "myLambdaFunction"
},
... more user-defined functions
]
}'
```
如果您不想部署任何 Lambda 函數，您可以完全省略函數定義版本。
1. 從輸出複製函數定義版本的 `Arn`。
1. 建立包含系統 Lambda 函數的群組版本。
+ 為該群組將 *group-id* 取代為 `Id`。
+ 將 *core-definition-version-arn* 取代為您從最新群組版本所複製的 `CoreDefinitionVersionArn`。
+ 將 *function-definition-version-arn* 取代為您為功能定義版本所複製的 `Arn`。
+ 取代您已從最新群組版本複製之其他群組元件 (例如 `SubscriptionDefinitionVersionArn` 或 `DeviceDefinitionVersionArn`) 的 ARN。
+ 移除任何未使用的參數。比如說若您的群組版本不包含任何資源，則請移除 `--resource-definition-version-arn`。
```
aws greengrass create-group-version \
--group-id group-id \
--core-definition-version-arn core-definition-version-arn \
--function-definition-version-arn function-definition-version-arn \
--device-definition-version-arn device-definition-version-arn \
--logger-definition-version-arn logger-definition-version-arn \
--resource-definition-version-arn resource-definition-version-arn \
--subscription-definition-version-arn subscription-definition-version-arn
```
1. 從輸出複製 `Version`。這是新群組版本的 ID。
1. 部署具有新群組版本的群組。
+ 將 *group-id* 取代為您為群組所複製的 `Id`。
+ 將 *group-version-id* 取代為您為新群組版本所複製的 `Version`。
```
aws greengrass create-deployment \
--group-id group-id \
--group-version-id group-version-id \
--deployment-type NewDeployment
```
如果您想要稍後再次編輯串流管理員設定，請遵循此程序。請務必建立函數定義版本，其中包含具有更新組態的`GGStreamManager`函數。群組版本必須參考您要部署到核心的所有元件版本 ARNs。變更會在部署群組之後生效。
## 另請參閱
+ [管理 AWS IoT Greengrass 核心上的資料串流](stream-manager.md)
+ [使用 StreamManagerClient 搭配串流](work-with-streams.md)
+ [匯出支援 AWS 雲端 目的地的組態](stream-export-configurations.md)
+ [將資料串流匯出至 AWS 雲端 （主控台）](stream-manager-console.md)
+ [將資料串流匯出至 AWS 雲端 (CLI)](stream-manager-cli.md)