IoT SiteWise 處理

IoT 處 SiteWise 理器元件 (aws.iot.SiteWiseEdgeProcessor) 可讓 AWS IoT SiteWise 閘道在邊緣處理資料。

有了這個元件， AWS IoT SiteWise 閘道可以使用資產模型和資產來處理閘道裝置上的資料。如需有 AWS IoT SiteWise 關設備的詳細資訊，請參閱《使用 AWS IoT SiteWise 指南》中的「在邊緣AWS IoT SiteWise使用」。

主題

版本
Type
作業系統
要求
相依性
組態
本機記錄檔
授權
變更記錄
另請參閱

版本

此元件具有下列版本：

3.2.x
3.1.x 版本
3.0.x
2.2.x 版本
2.1.x
2.0.x

Type

此元件是一般元件 (aws.greengrass.generic)。Greengrass 核會執行元件的生命週期指令碼。

如需詳細資訊，請參閱元件類型。

作業系統

此元件可安裝在執行下列作業系統的核心裝置上：

Linux
Windows

要求

此元件具有下列需求：

Greengrass 核心裝置必須在下列其中一個平台上執行：
- 操作系統:
  
  系統架構：四十四 (AMD64)
- 作業系統:紅帽企業版 (RHEL) 8
  
  系統架構：四十四 (AMD64)
- 操作系統:Amazon Linux 2
  
  系統架構：四十四 (AMD64)
- 作業系統:視窗伺服器 2019 或更新版
  
  系統架構：四十四 (AMD64)
Greengrass 核心裝置必須允許連接埠 443 上的輸入流量。
Greengrass 核心裝置必須允許連接埠 443 和 8883 上的輸出流量。
下列連接埠保留供使用 AWS IoT SiteWise：80、443、3001、4569、4572、8000、8082、8084、8085、8086、8445、9000、9500、11080 和 50010。為流量使用保留的連接埠可能會導致連線終止。

注意
只有此元件的版本 2.0.15 及更新版本才需要連接埠 8087。
Greengrass 裝置角色必須具有允許您在裝置上使用 AWS IoT SiteWise 閘道的權限。 AWS IoT Greengrass V2 若要取得更多資訊，請參閱AWS IoT SiteWise 使用指南中的「需求」。

端點和連接埠

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

端點	連線埠	必要	描述
`model.iotsitewise.region.amazonaws.com`	443	是	取得資產和資 AWS IoT SiteWise 產模型的相關資訊。
`edge.iotsitewise.region.amazonaws.com`	443	是	取得核心裝置 AWS IoT SiteWise 閘道組態的相關資訊。
`ecr.region.amazonaws.com`	443	是	從 Amazon 彈性容器註冊表下載 AWS IoT SiteWise 邊緣網關碼頭映像。
`iot.region.amazonaws.com`	443	是	取得適用於您的 AWS 帳戶.
`sts.region.amazonaws.com`	443	是	取得您的 AWS 帳戶.
`monitor.iotsitewise.region.amazonaws.com`	443	否	如果您存取核心裝置上的 AWS IoT SiteWise Monitor 入口網站，則為必要項

相依性

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

下表列出此元件 2.0.x 至 2.1.x 版的相依性。

相依性	兼容版本	相依性類型
代幣交換服務	> = 2.0.3	硬式
串流管理員	>=2.0.10 <3.0.0	硬式
Greengrass	> = 2.3.0	硬式

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

組態

此元件沒有任何組態參數。

本機記錄檔

此元件使用下列記錄檔。

若要檢視此元件的記錄

在核心裝置上執行下列命令，即時檢視此元件的記錄檔。以 AWS IoT Greengrass 根資料夾的路徑取代/greengrass/v2或 C:\greengrass\v2。
Linux
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait
```

授權

此元件包括下列協力廠商軟體/授權：

阿帕奇 -2.0
理工學
BSD-條款
BSD-条款
卡德的 -1.0
卡德的 -1.1
ISC
茲利卜
具有 GCC 異常的 GPL-3.0
公共領域
蟒蛇 2.0
德国联合国足球协会
BSD-1-條款
OpenSSL
EPL-1.0
EPL-2.0
GPL-2.0 與類別路徑例外
邁普爾 -2.0
C0-1.0
JSON

此元件根據 Greengrass 核心軟體授權合約發行。

變更記錄

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

版本	變更
3.2.1	錯誤修復和改進修正 AWS IoT SiteWise API 呼叫未與 SiteWise Edge 同步分頁的問題。修正不再發佈`MessageRemaining.SiteWise_Edge_Stream`量度的問題。已新增下列 CloudWatch 指標，以監視與 MQTT 代理程式的連線。 `IoTSiteWiseProcessor.IsConnectedToMqttBroker` `IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker` `IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived` `IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount` `IoTSiteWiseProcessor.MqttReceivedSuccessBytes` 如需這些指標的詳細資訊，請參閱AWS IoT Greengrass Version 2 閘道指標。
3.2.0	效能提升優化 API 服務以減少內存佔用空間，並且需要更少的磁盤空間來安裝這樣可減少 2 GB 的初始記憶體使用量 (現在啟動時使用 7.5 GB 的記憶體，但仍建議使用 16 GB)，整個元件的下載大小減少 500 MB (現在需要下載 1.4 GB)。新功能 `GetAssetPropertyValueAggregates`API 現在支援邊緣上 15 分鐘的聚合視窗。連接埠 8081 和 8082 不再需要可用，此元件才能正確執行。注意 AWS IoT SiteWise 資料平面 API 的本機端點 (例如`get-asset-property-value`) 正在從變更`http://localhost:8081`為`http://localhost:11080/data`。 AWS IoT SiteWise 控制平面 API 的本機端點 (例如`list-asset-models`) 已從變更`http://localhost:11080`為`http://localhost:11080/control`。 AWS 一律建議您使用邊 SiteWise 緣閘道 HTTPS 端點。這些端點尚未變更。錯誤修復和改進現在，如果先前的同步中斷，從同步處理 AWS IoT SiteWise 會將資源轉換為有效狀態。這將修復強制重新啟動後某些資源損壞的問題。修復了在同步期間修改資源時，邊緣上可能會損壞資源的罕見情況。現在，如果偵測到此情況，同步將會失敗，並在下次同步中重試資源。修正可能允許 API 的 HTTP 端點在外部呼叫的問題。現在只能使用 HTTPS 來呼叫本機回送位址以外的 API。 `ListAssets`API 現在會針對儲存在邊緣的資產顯示資產階層。修正資料處理套件無法在 Windows 上重新啟動、升級或降級的問題。修正 Windows 作業系統資料處理套件中的錯誤，此錯誤會導致客戶無法使用認證與 MQTT 代理人連線。
3.1.3	錯誤修復和改進修正當某些資源實際失敗時，資料處理套件不正確回報成功同步處理的問題。允許多個資產具有相同的名稱，只要它們沒有相同的父項。
3.1.1	錯誤修復和改進修復了由於時區不匹配而導致 Sigv4 請求失敗的問題。修正轉換和量度屬性在重新啟動後依賴屬性時停止計算的問題。啟用自訂串流管理員連接埠設定的支援。修正同步至邊緣的屬性可能會停止更新的問題。
3.1.0	錯誤修復和改進修復 `ListAssetModels` API 無法生成下一個令牌的問題。
3.0.0	新功能支援從 MQTT 代理程式擷取資料。
2.2.1	錯誤修復和改進調整同步處理程序，使控制平面資料儲存與雲端運作方式更加一致。這會稍微影響升級。注意在 2.2.1 版或更高版本上同步的控制平面資料將與舊版不相容。要降級到以前的版本，您需要完成全新安裝。這不會影響升級，在舊版上同步的資料將適用於 2.2.1 版。對 AWS 憑證鏈結進行其他修改以排定 AWS IoT Greengrass V2 憑證的優先順序
2.1.37	錯誤修復和改進棄用 dependency-routing-service 過程並將其功能移動到該 property-state-service 過程中，以減少通信過程中的資源使用量。將 `get-asset-property-value-history` API 的最大結果限制增加到 20,000，以符合所使用的限制 AWS IoT SiteWise。修正未指定最大結果限制時，`get-asset-property-value-history`API 的分頁結果中未提供下一個權杖的問題。
2.1.35	錯誤修復和改進修改 AWS 認證鏈結以排定認 AWS IoT Greengrass 證的優先順序。修正部署為 AWS IoT 物件群組的一部分時，帳戶偵測的問題。
2.1.34	錯誤修復和改進調整度量/轉換計算以在 Linux 上使用多執行緒。Windows 會繼續執行單執行緒運算，以確保相容性。修正某些計算視窗會遺失度量計算的問題。
2.1.33	錯誤修復和改進修正了向 Greengrass 控制台報告錯誤狀態的問題。
2.1.32	錯誤修復和改進添加對自定義用戶名和組的支持。
2.1.31	錯誤修復和改進添加支援，以計算在中建模的資料的時間加權平均值和時間加權標準差。 AWS IoT SiteWise
2.1.29	錯誤修復和改進添加對邊緣功能過濾資產的支持。
2.1.28	錯誤修復和改進最佳化資源同步處理，讓大量資產能夠從邊 AWS 雲端緣同步。
2.1.24	錯誤修復和改進修正第二次同步資源時導致儀表板消失的問題。
2.1.23	錯誤修復和改進為`aws.iot.SiteWiseEdgeProcessor`安裝過程添加了超時，以避免 Internet 連接速度慢時安裝失敗。優化資源同步以提高雲端和邊緣之間的同步效率。
2.1.21	警告從 2.0.x 升級到 2.1.x 將導致本地數據丟失。新功能添加對視窗服務器 2019 或更高版本的支持。移除基於 Linux 的操作系統的 docker。
2.0.16	此版本包含錯誤修復和改進。
2.0.15	錯誤修復和改進將此元件用於資源同步處理 API 作業的連接埠從 8085 變更為 8087。因此，此元件現在需要連接埠 8087 才能使用。此元件仍需要連接埠 8085 才能使用。更新 AWS OpsHub 驗證以在登錄期間拒絕未經授權的用戶，而不是當用戶嘗試調用 API 操作時。
2.0.14	此版本包含錯誤修復和改進。
2.0.13	錯誤修復和改進修正問題，以便當此元件向 Amazon 指 CloudWatch標報告資料時，現在可正確指出哪些資料未建模。
2.0.9	錯誤修復和改進改善在核心裝置上建立和更新 AWS IoT SiteWise 資源的可靠性。新增其他本機 API 作業，您可用來監視核心裝置上安裝的元件、每個元件的版本，以及每個元件的狀態。您可以在核心裝置上的 AWS IoT SiteWise 應用程式的 [設定] 索引標籤上檢視此資訊。 AWS OpsHub 為此元件執行的 Docker 容器新增健全狀態。您可以執行命`docker ps`令來檢視容器的健全狀況狀態。
2.0.7	錯誤修復和改進修復了對在核心設備上查看 AWS IoT SiteWise Monitor 門戶的支持。
2.0.6	錯誤修復和改進修正 AWS IoT SiteWise `statetime()`此元件在核心裝置上計算的`earliest()`、和`latest()`功能。
2.0.5	錯誤修復和改進添加對此組件在核心設備上計算的轉換 AWS IoT SiteWise `pretrigger()`函數的支持。變更此元件儲存輕量型目錄存取通訊協定 (LDAP) 組態以進行驗證的路徑。
2.0.2	初始版本。

另請參閱

什麼是 AWS IoT SiteWise？在《AWS IoT SiteWise 使用者指南》中。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

IoT SiteWise 出版

出版商支援的元件