IoT SiteWise OPC-UA 收集器 - AWS IoT Greengrass

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

IoT SiteWise OPC-UA 收集器

IoT SiteWise OPC-UA 收集器元件 (aws.iot.SiteWiseEdgeCollectorOpcua) 可讓 AWS IoT SiteWise 閘道器從本機 OPC-UA 伺服器收集資料。

使用此組件, AWS IoT SiteWise 網關可以連接到多個 OPC-UA 服務器。如需有 AWS IoT SiteWise 關設備的詳細資訊,請參閱《使用 AWS IoT SiteWise 指南》中的「在邊緣AWS IoT SiteWise使用」。

版本

此元件具有下列版本:

  • 2.5.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) 或 ARMv8 (建築 64)

    • 作業系統:紅帽企業版 (RHEL) 8

      架構:64 (AMD64) 或 ARMv8 (建築 64)

    • 操作系統:Amazon Linux 2

      架構:64 (AMD64) 或 ARMv8 (建築 64)

    • 操作系統:Debian

      架構:64 (AMD64) 或 ARMv8 (建築 64)

    • 作業系統:視窗伺服器 2019 或更新版

      體系結構:64 () AMD64

  • Greengrass 核心裝置必須允許輸出網路連線至 OPC-UA 伺服器。

相依性

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

下表列出此元件所有版本的相依性。

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

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

組態

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

您可以使用主 AWS IoT SiteWise 控台或設API定 IoT SiteWise OPC-UA 收集器元件。有關詳情,請參閱《AWS IoT SiteWise 使用指南》中的步驟 4:新增資料來源-可選

輸入資料

該組件僅接受以下格式的數據,其他所有將被忽略和丟棄。下表將 OPC UA 資料類型對應至 SiteWise 相等資料類型。

SiteWise 資料類型

OPCUA 資料類型

Description

STRING

String

Guid

XmlElement

最大長度為 1024 個字節的字符串。

INTEGER

SByte

Byte

Int16

UInt16

Int32

UInt32*

Int64*

範圍為的有符號 32 位元整數-2,147,483,648 to 2,147,483,647

DOUBLE

UInt32*

Int64*

Float

Double

具有範圍從–10^100 to 10^100IEEE 754雙精度的浮點數。

BOOLEAN

Boolean

truefalse

* 對於 OPC UA 數據類型 UInt32Int64,它的 SiteWise 數據類型將 SiteWise 是INTEGER如果能夠表示其值,否則將是DOUBLE

輸出資料

此組件將BatchPutAssetPropertyValue消息寫入 AWS IoT Greengrass 流管理器。如需詳細資訊,請參閱〈AWS IoT SiteWise API參考BatchPutAssetPropertyValue中的〈〉。

本機記錄檔

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

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

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait

疑難排解和偵錯

此元件包含新的事件記錄檔,可協助客戶識別並修正問題。記錄檔與本機記錄檔不同,可在下列位置找到。更換/greengrass/v2C:\greengrass\v2 與 AWS IoT Greengrass 根文件夾的路徑。

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgeCollectorOpcua/logs/IotSiteWiseOpcUaCollectorEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgeCollectorOpcua\logs\IotSiteWiseOpcUaCollectorEvents.log

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

  • 嚴重性等級

  • 時間戳記

  • 其他事件特定資訊

範例日誌
dataSourceConnectionSuccess: Summary: Successfully connected to OpcUa server Level: INFO Timestamp: '2023-06-15T21:04:16.303Z' Description: Successfully connected to the data source. AssociatedMetrics: - Name: FetchedDataStreams Description: The number of fetched data streams for this data source Value: 1.0 Namespace: IoTSiteWise Dimensions: - Name: SourceName Value: SourceName{value=OPC-UA Server} - Name: ThingName Value: test-core AssociatedData: - Name: DataSourceTrace Description: Name of the data source Data: - OPC-UA Server - Name: EndpointUri Description: The endpoint to which the connection was attempted. Data: - '"opc.tcp://10.0.0.1:1234"'

授權

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

變更記錄

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

版本

變更

2.5.0
新功能
  • 添加一個數據源選項,以將簡單的數組和 DateTime 值轉換為字符串。

  • 新增內容群組選項,以在從 OPC-UA 伺服器收集資料時選取來源或伺服器時間戳記。

錯誤修復和改進
  • 重設預設輪詢組態以使用來源時間戳記。

2.4.2

錯誤修復和改進
  • 修正 OPC UA 伺服器探索期間可能多次探索節點的問題。

  • 修正快照功能,以確保每個快照資料點的時間戳記都是新的。

2.4.1

錯誤修復和改進
  • 修復了與代理支持相關的問題。

  • 修復了線程清理失敗並導致數據阻塞的問題。

2.4.0

新功能
  • 新增事件記錄檔,以便更輕鬆地識別和修復問題。

錯誤修復和改進
  • 修正連線至使用 OPC-UA 規格 1.05 版的-UA 伺服器時,造成憑證錯誤的 OPC-UA 用戶端問題。OPC

2.3.0

新功能
  • 添加對 Linux 上 Greengrass 核HTTP代理配置的支援。

錯誤修復和改進
  • 已修正一個安全性問題CVE。

2.2.0

新功能
  • 添加對在 Linux ARMv8 架構上安裝數據收集包的支持。

  • 對於 Linux 的最低要求ARMv8:

    • 記憶體:4 GB

    • CPU: ARM 皮質-A72 或同等規格

錯誤修復和改進
  • 改進了節點發現過程中指標的記錄。

  • 改進了對不支持數據類型的處理。

  • 改進了數據流錯誤的日誌記錄。

2.1.3

新功能
  • 添加對視窗服務器 2019 或更高版本的支持。

錯誤修復和改進
  • 改善在不支援的裝置上部署此元件時的錯誤訊息。

2.1.1

新功能
  • 添加對配置以下訂閱屬性的支持:

    • DataChangeTrigger‐您可以定義啟動資料變更警示的條件。

    • QueueSize‐某特定測量結果的 OPC‐UA 伺服器上佇列深度,其中「受監控項目」的通知會排入佇列。

    • PublishingIntervalMilliseconds‐建立訂閱時指定的發佈週期間隔 (以毫秒為單位)。

    • SnapshotFrequencyMilliseconds ‐您可以設定快照頻率逾時設定,以確保 AWS IoT SiteWise Edge 擷取穩定的資料流。

  • 此版本支援擷取BAD品質資料,並根據下列資料品質篩選資料:

    • UNCERTAIN品質資料

    • BAD品質資料

錯誤修復和改進
  • 客戶指標的改進。

  • 修正連線至啟用加密的伺服器時,有時會造成問題的安全性編碼。

  • 修正內容群組無法更新的問題。

2.0.3

錯誤修復和改進。

2.0.2

錯誤修復和改進了資產優先級與邊緣同步。

2.0.1

初始版本。

另請參閱