版本 Type 作業系統要求相依性組態輸入資料本機記錄檔疑難排解和偵錯授權變更記錄另請參閱

IoT SiteWise 出版

IoT SiteWise 發行者元件 (aws.iot.SiteWiseEdgePublisher) 可讓 AWS IoT SiteWise 閘道將資料從邊緣匯出到 AWS 雲端.

如需有 AWS IoT SiteWise 關設備的詳細資訊，請參閱《使用 AWS IoT SiteWise 指南》中的「在邊緣AWS IoT SiteWise使用」。

主題

版本
Type
作業系統
要求
相依性
組態
輸入資料
本機記錄檔
疑難排解和偵錯
授權
變更記錄
另請參閱

版本

此元件具有下列版本：

3.1.x 版本
3.0.x
2.4.x 版本
2.3.x 版本
2.2.x 版本
2.1.x
2.0.x

Type

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

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

作業系統

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

Linux
Windows

要求

此元件具有下列需求：

Greengrass 核心裝置必須在下列其中一個平台上執行：
- 操作系統:Ubuntu 18.04 或更高版本
  
  體系結構：64（AMD64）或阿爾姆 8（建築 64）
- 作業系統:紅帽企業版 (RHEL) 8
  
  體系結構：64（AMD64）或阿爾姆 8（建築 64）
- 操作系統:Amazon Linux 2
  
  體系結構：64（AMD64）或阿爾姆 8（建築 64）
- 操作系統:Debian
  
  體系結構：64（AMD64）或阿爾姆 8（建築 64）
- 作業系統:視窗伺服器 2019 或更新版
  
  系統架構：四十四 (AMD64)
Greengrass 核心設備必須連接到互聯網。

Greengrass 核心裝置必須獲得授權才能執行動作。iotsitewise:BatchPutAssetPropertyValue如需詳細資訊，請參閱授權核心裝置與 AWS 服務互動。

範例許可政策


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

端點和連接埠

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

端點	連線埠	必要	描述
`data.iotsitewise.region.amazonaws.com`	443	是	將資料發佈至 AWS IoT SiteWise。

相依性

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

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

相依性	兼容版本	相依性類型
Greengrass 核	> = 2.3.0<3.0.0	硬式
串流管理員	>=2.0.10	硬式

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

組態

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

您可以使用主 AWS IoT SiteWise 控台或 API 來設定 IoT SiteWise 發行者元件。如需詳細資訊，請參閱《AWS IoT SiteWise 使用指南》中的步驟 3：設定發行者 -選用。

輸入資料

此組件從 AWS IoT Greengrass 流管理器讀取PutAssetPropertyValueEntry消息。如需詳細資訊，請參閱 AWS IoT SiteWise API 參考PutAssetPropertyValueEntry中的。

本機記錄檔

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

若要檢視此元件的記錄

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

疑難排解和偵錯

此元件包含新的事件記錄檔，可協助客戶識別並修正問題。記錄檔與本機記錄檔不同，可在下列位置找到。以 AWS IoT Greengrass 根資料夾的路徑取代/greengrass/v2或 C:\greengrass\v2。

此記錄檔包含詳細資訊和疑難排解指示。疑難排解資訊會與診斷程式一起提供，其中包含如何解決問題的說明，有時還會提供進一步資訊的連結。診斷資訊包括下列項目：

嚴重性等級
時間戳記
其他事件特定資訊

範例日誌


accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

授權

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

變更記錄

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

版本	變更
3.1.3	錯誤修復和改進已解決建立事件記錄檔但未記錄任何事件的問題。`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log` 已新增下列 CloudWatch 量度，用於監視與 MQTT 代理程式之間的連線： `IoTSiteWisePublisher.IsConnectedToMqttBroker` `IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker` `IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived` `IoTSiteWisePublisher.MqttMessageReceivedSuccessCount` `IoTSiteWisePublisher.MqttReceivedSuccessBytes` 如需這些指標的詳細資訊，請參閱AWS IoT Greengrass Version 2 閘道指標。解決了即使將實木複合地板文件上傳到 S3 失敗，仍然會調`BatchCreateJob`用 API 的問題。
3.1.2	錯誤修復和改進修復了 3.1.1 版中引入的 CPU 使用率過高的問題。
3.1.1	錯誤修復和改進新增其他記錄，以在發生錯誤時識別受影響的資料別名。針對擷取的資料年齡新增 AWS IoT SiteWise API 限制的本機強制執行功能。修正當有多個 Amazon S3 目的地時，發佈者混合 StreamManager 串流的檢查點的問題。修正發行者從 StreamManager 串流讀取方式的效能瓶頸。
3.1.0	新功能添加對將數據作為實木複合地板文件發布到 Amazon S3 的支持。添加對 AWS IoT SiteWise 緩衝擷取的支援。
3.0.0	錯誤修復和改進修復了與代理支持相關的問題。新功能支援從 MQTT 代理程式擷取資料。
2.4.1	錯誤修復和改進啟用元件與 Java 編輯器 11 版本 11.0.20.8.1 及更高版本一起使用。組件版本 2.4.0 和 2.3.3 顯示`"Could not find or load main class"`錯誤消息時，與 Java Corretto 版本 11.0.20.8.1 使用。
2.4.0	新功能添加新的事件日誌，以便更容易識別和修復問題。錯誤修復和改進改善發行者檢查點復原。
2.3.3	錯誤修復和改進改善支援高輸送量的能力。
2.3.2	錯誤修復和改進修復了下載發布者配置時的 HTTP 代理支持。
2.3.1	新功能添加對在 Linux ARMv8 體系結構上安裝數據收集包的支持。對於 Linux 的最低要求：記憶體：4 GB 中央處理器：臂皮質-A72 或同等規格
2.2.3	錯誤修復和改進移除不在可重新擷取例外清單中的一般例外重試。
2.2.2	錯誤修復和改進 AWS IoT SiteWise 透過 HTTP 代理伺服器重新引入資料上傳支援。
2.2.1	注意此版本不支援 HTTP 代理伺服器組態。2.2.2 及更高版本重新引入了對此功能的支持。新功能添加對此組件的支持，以在將數據上傳到時切換壓縮 AWS IoT SiteWise。
2.2.0	注意此版本不支援 HTTP 代理伺服器組態。2.2.2 及更高版本重新引入了對此功能的支持。新功能更新此組件以在將數據發送到 AWS IoT SiteWise 服務之前壓縮數據。在大多數情況下，與此元件的舊版相比，這項變更可減少 75% 的頻寬使用量。在大多數情況下，這項變更會將 CPU 使用率增加最多 5%。在處理大量資料的閘道上，此變更最多可將 CPU 使用率增加 15%。這項變更不會影響 AWS IoT SiteWise 服務費用或服務配額使用量。添加對視窗服務器 2019 或更高版本的支持。錯誤修復和改進修正檢查點檔案損毀時造成此元件無法啟動的問題。
2.1.4	錯誤修復和改進修復了與 Java 版本 8 的兼容性。
2.1.3	警告除了美國東部 (俄亥俄)、加拿大 (中部) 和 AWS GovCloud (美國東部) 區域外，已不再提供此版本。此元件版本需要執行 Java 11 或更新版本。此版本中的改進功能在此元件的更新版本中提供。錯誤修復和改進改善在不支援的裝置上部署此元件時的錯誤訊息。資料上傳失敗時記錄錯誤的更新。
2.1.2	錯誤修復和改進更新以在資料到期時叫用過期的資料匯出功能。
2.1.1	錯誤修復和改進。
2.1.0	新功能添加對首先將最新數據發布到雲的支持。添加對不將過期數據發布到雲的支持。添加對本地存儲過期數據的支持。錯誤修復和改進減少磁碟 I/O 和對應的延遲。
2.0.2	錯誤修復和改進。
2.0.1	初始版本。

另請參閱

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

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

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

文件慣用形式

IoT SiteWise OPC-UA 數據源模擬器

IoT SiteWise 處理