設定 AWS IoT Greengrass 串流管理員 - AWS IoT Greengrass

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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

如需保護串流資料安全的資訊,請參閱 本機資料安全性

預設:/greengrass/v2/work/aws.greengrass.StreamManager

伺服器連接埠

參數名稱:STREAM_MANAGER_SERVER_PORT

用於與串流管理員通訊的本機連接埠號碼。預設值為 8088

您可以指定0使用隨機可用的連接埠。

驗證用戶端

參數名稱:STREAM_MANAGER_AUTHENTICATE_CLIENT

表示用戶端是否須經過驗證才能與串流管理員互動。客戶端和流管理器之間的所有交互都由流管理器 SDK 控制。這個參數決定哪些用戶端可以呼叫串流管理員 SDK 來處理串流。如需詳細資訊,請參閱 用戶端身分驗證

有效值為 truefalse。預設值為 true (建議)。

  • true。 只允許 Greengrass 組件作為客戶端。元件會使用內部AWS IoT Greengrass核心通訊協定,透過串流管理員 SDK 進行驗證。

  • false。 允許在AWS IoT Greengrass核心上運行的任何進程是一個客戶端。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。

另請參閱