串流管理員 - AWS IoT Greengrass

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

串流管理員

串流管理員元件 (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 的限制和限制。若要解決此問題,您可以從下列選項中進行選擇。

      • 透過提供AWS_S3_US_EAST_1_REGIONAL_ENDPOINT=regional環境變數,將串流管理員元件設定為使用us-east-1區域中的區域 S3 端點。

      • 建立 Amazon S3 閘道 VPC 端點,而不是 Amazon S3 界面 VPC 端點。S3 閘道端點支援對 S3 全球端點的存取。如需詳細資訊,請參閱建立閘道端點

端點和連接埠

除了基本作業所需的端點和連接埠之外,此元件還必須能夠對下列端點和連接埠執行輸出要求。如需詳細資訊,請參閱 允許裝置流量透過 Proxy 或防火牆

端點 連線埠 必要 描述

iotanalytics.region.amazonaws.com

443

如果您將資料發佈到,則為必要 AWS IoT Analytics。

kinesis.region.amazonaws.com

443

如果您將資料發佈至 Firehose,則需要此項。

data.iotsitewise.region.amazonaws.com

443

如果您將資料發佈到,則為必要 AWS IoT SiteWise。

*.s3.amazonaws.com

443

如果將資料發佈到 S3 儲存貯體,則為必要項

您可以*用發佈資料的每個值區名稱取代。

相依性

部署元件時, AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的需求,才能成功部署元件。本節列出此元件之已發行版本的相依性,以及定義每個相依性之元件版本的語意版本條件約束。您也可以在AWS IoT Greengrass 主控台中檢視元件每個版本的相依性。在元件詳細資料頁面上,尋找 [相依性] 清單。

2.1.11

下表列出此元件 2.1.11 至 2.1.10 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.1.9 – 2.1.10

下表列出此元件 2.1.9 至 2.1.10 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.1.5 – 2.1.8

下表列出此元件 2.1.5 至 2.1.8 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.1.2 – 2.1.4

下表列出此元件 2.1.2 至 2.1.4 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.1.1

下表列出此元件 2.1.1 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.1.0

下表列出此元件 2.1.0 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.0.15

下表列出此元件 2.0.15 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.0.13 and 2.0.14

下表列出此元件 2.0.13 和 2.0.14 版本的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.0.0 軟式
代幣交換服務 > 硬式
2.0.11 and 2.0.12

下表列出此元件 2.0.11 和 2.0.12 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.0.10

下表列出此元件 2.0.10 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.0.9

下表列出此元件 2.0.9 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.0.8

下表列出此元件 2.0.8 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.0 軟式
代幣交換服務 > 硬式
2.0.7

下表列出此元件 2.0.7 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 > = 2.0.3 軟式
代幣交換服務 > 硬式

如需有關元件相依性的詳細資訊,請參閱元件方案參考

組態

此元件提供下列組態參數,您可以在部署元件時自訂這些參數。

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

(選擇性) 用來與串流管理員通訊的本機連接埠號碼。

您可以指定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" }

本機記錄檔

此元件會使用下列記錄檔。

Linux
/greengrass/v2/logs/aws.greengrass.StreamManager.log
Windows
C:\greengrass\v2\logs\aws.greengrass.StreamManager.log
若要檢視此元件的記錄
  • 在核心裝置上執行下列命令,即時檢視此元件的記錄檔。以 AWS IoT Greengrass 根資料夾的路徑取代/greengrass/v2C:\greengrass\v2

    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

變更記錄

下表說明元件每個版本中的變更。

版本

變更

2.1.12

錯誤修復和改進

更新證明資料的使用順序,讓 Greengrass 證明資料偏好用於服務要求 AWS 。

2.1.11

版本更新了 Greengrass 核 2.12.0 版本釋放。

2.1.10

錯誤修復和改進

修正 HTTPS 代理伺服器設定不信任 Greengrass 憑證授權單位 (CA) 憑證鏈結的問題。

2.1.9

版本更新了 Greengrass 核 2.11.0 版本釋放。

2.1.8

錯誤修復和改進

修復了流管理器無限重試 SiteWise 導出失敗的問題。InvalidRequestException

2.1.7

錯誤修復和改進

修正串流管理員無法正確讀取 Proxy 組態的問題。

2.1.6

錯誤修復和改進

修正了在某些 ARMv8 處理器(包括 Jetson Nano)上啟動時可能導致當機的問題。

2.1.5

版本更新了 Greengrass 核 2.10.0 版本釋放。

2.1.4

錯誤修復和改進
  • 修正 SiteWise API 的單一批次傳回ConflictingOperationException中具有相同時間戳記的相同屬性資產項目,導致串流管理員持續重試的問題。

  • 將預設連線逾時從 3 秒更新為 1 分鐘。

2.1.3

錯誤修復和改進

修復以系統用戶身份運行時 Windows 操作系統上的啟動問題。

2.1.2

錯誤修復和改進
  • 修正 Windows 作業系統上使用非英文語言的問題。

  • 版本更新 Greengrass 2.9.0 版本釋放。

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
錯誤修復和改進

修正無法將串流管理員 v2.0.7 升級至 v2.0.8 和 v2.0.11 之間的版本的問題。如果您使用串流管理員將資料匯出至雲端,您現在可以升級至 v2.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

初始版本。