本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
設定 AWS IoT Greengrass 串流管理員
在 Greengrass 核心裝置上,串流管理員可以存放、處理和匯出 IoT 裝置資料。串流管理員提供您用來設定執行時間設定的參數。這些設定適用於 Greengrass 核心裝置上的所有串流。您可以在部署元件時,使用 AWS IoT Greengrass 主控台或 API 來設定串流管理員設定。變更會在部署完成後生效。
串流管理員參數
串流管理員提供下列參數,您可以在將元件部署到核心裝置時設定這些參數。所有參數都是選用的。
- 儲存目錄
-
參數名稱:
STREAM_MANAGER_STORE_ROOT_DIR
用於存放串流之本機資料夾的絕對路徑。此值必須以正斜線開頭 (例如
/data
)。您必須指定現有的資料夾,而且執行串流管理員元件的系統使用者必須具有讀取和寫入此資料夾的許可。例如,您可以執行下列命令來建立和設定資料夾
/var/greengrass/streams
,您指定此資料夾做為串流管理員根資料夾。這些命令允許預設系統使用者ggc_user
讀取和寫入此資料夾。sudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streams
如需保護串流資料安全的資訊,請參閱 本機資料安全性。
預設:
/work/aws.greengrass.StreamManager/greengrass/v2
- 伺服器連接埠
-
參數名稱:
STREAM_MANAGER_SERVER_PORT
用於與串流管理員通訊的本機連接埠號碼。預設值為
8088
。您可以指定
0
使用隨機的可用連接埠。 - 驗證用戶端
-
參數名稱:
STREAM_MANAGER_AUTHENTICATE_CLIENT
表示用戶端是否須經過驗證才能與串流管理員互動。用戶端和串流管理員之間的所有互動都由串流管理員 SDK 控制。此參數決定哪些用戶端可以呼叫 Stream Manager SDK 來使用串流。如需詳細資訊,請參閱用戶端身分驗證。
有效值為
true
或false
。預設值為true
(建議)。-
true
。 僅允許 Greengrass 元件做為用戶端。元件使用內部 AWS IoT Greengrass 核心通訊協定來驗證 Stream Manager SDK。 -
false
。 允許在 AWS IoT Greengrass Core 上執行的任何程序成為用戶端。除非您的商業案例需要,false
否則請勿將值設定為 。例如,false
只有在核心裝置上的非元件程序必須直接與串流管理員通訊時,才能使用 。
-
- 最高頻寬
-
參數名稱:
STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH
可用來匯出資料的平均最高頻寬 (以千位元數/秒為單位)。預設允許無限使用可用頻寬。
- 執行緒集區大小
-
參數名稱:
STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE
可用於匯出資料的作用中執行緒數量上限。預設值為
5
。最佳大小取決於您的硬體、串流磁碟區和規劃的匯出串流數量。如果匯出速度很慢,您可以調整此設定,找出適合您硬體和商務案例的最佳大小。核心裝置硬體的 CPU 和記憶體是限制因素。首先,您可以嘗試將此值設定為等同於裝置上處理器核心的數量。
請小心不要設定高於硬體可支援的大小。每個串流都會耗用硬體資源,因此請嘗試限制受限裝置上的匯出串流數量。
- JVM 引數
-
參數名稱:
JVM_ARGS
自訂 Java 虛擬機器參數,以在啟動時傳遞給串流管理員。多個引數應用空格分隔。
僅限必須覆寫 JVM 使用的預設設定時,才能使用此參數。例如,如果您計劃匯出大量串流,可能需要增加預設堆積大小。
- Logging level (記錄層級)
-
參數名稱:
LOG_LEVEL
元件的記錄層級。從下列日誌層級中進行選擇,此處依層級順序列出:
-
TRACE
-
DEBUG
-
INFO
-
WARN
-
ERROR
預設:
INFO
-
- 分段上傳的大小下限
-
參數名稱:
STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES
分段中部分的大小下限 (以位元組為單位) 上傳至 Amazon S3。串流管理員使用此設定和輸入檔案的大小,來判斷如何在分段 PUT 請求中批次處理資料。預設和最小值為
5242880
位元組 (5 MB)。注意
串流管理員使用串流的
sizeThresholdForMultipartUploadBytes
屬性來判斷要匯出至 Amazon S3,做為單一或分段上傳。使用者定義的 Greengrass 元件會在建立匯出至 Amazon S3 的串流時設定此閾值。預設閾值為 5 MB。