版本类型操作系统要求依赖项配置输入数据输出数据本地日志文件故障排除和调试许可证更改日志另请参阅

物联网 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

类型

此组件是一个通用组件 (aws.greengrass.generic)。Greengrass 核心运行组件的生命周期脚本。

有关更多信息，请参阅组件类型。

操作系统

此组件可以安装在运行以下操作系统的核心设备上：

Linux
Windows

要求

此组件具有以下要求：

Greengrass 核心设备必须在以下平台之一上运行：
- OS：Ubuntu 18.04 或更高版本
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- 操作系统：红帽企业 Linux (RHEL) 8
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- OS：Amazon Linux 2
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- OS：Debian 11
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- 操作系统：Windows Server 2019 或更高版本
  
  架构：x86_64 () AMD64
Greengrass 核心设备必须允许与-UA 服务器的出站网络连接。OPC

依赖项

部署组件时， AWS IoT Greengrass 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本节列出了此组件已发布版本的依赖关系以及定义每个依赖项的组件版本的语义版本限制。您还可以在AWS IoT Greengrass 控制台中查看组件每个版本的依赖关系。在组件详细信息页面上，查找 “依赖关系” 列表。

下表列出了该组件所有版本的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass 核	>=2.3.0 <3.0 <3.0.0	硬性
流管理器	>2.0.10<3.0.0	硬性
秘密经理	>=2.0.8 <3.0.0	硬性

有关组件依赖关系的更多信息，请参阅组件配方参考。

配置

此组件没有任何配置参数。

您可以使用 AWS IoT SiteWise 控制台或API配置 IoT SiteWise OPC-UA 收集器组件。有关更多信息，请参阅《AWS IoT SiteWise 用户指南》中的步骤 4：添加数据源-可选。

输入数据

此组件仅接受以下格式的数据，所有其他格式的数据都将被忽略并丢弃。下表将 OPC UA 数据类型映射到其 SiteWise 等效类型。

SiteWise 数据类型	OPCUA 数据类型	描述
`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^100`和`IEEE 754`双精度。
`BOOLEAN`	`Boolean`	`true` 或 `false`。

* 对于 OPC UA 数据类型UInt32和Int64，INTEGER如果能够表示其值，则其 SiteWise 数据类型将为，否则将 SiteWise 是DOUBLE。

输出数据

此组件将BatchPutAssetPropertyValue消息写入 AWS IoT Greengrass 流管理器。有关更多信息，请参阅 “AWS IoT SiteWise API参考” BatchPutAssetPropertyValue中的。

本地日志文件

此组件使用以下日志文件。

查看此组件的日志

在核心设备上运行以下命令以实时查看此组件的日志文件。替换/greengrass/v2或 C:\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/v2或 C:\greengrass\v2 包含 AWS IoT Greengrass 根文件夹的路径。

此日志包含详细信息和故障排除说明。故障排除信息与诊断一起提供，并附有如何解决问题的说明，有时还会提供指向更多信息的链接。诊断信息包括以下内容：

严重性级别
Timestamp
其他活动特定信息

例示例日志


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 客户端在连接到使用-UA 规范版本 1.05 的 OPC-UA 服务器时导致证书错误的问题。OPC
2.3.0	新功能在 Linux 上添加对 Greengrass nucleus 代理配置HTTP的支持。错误修复和改进修复了一个安全问题 (CVE-2019-19 135)。
2.2.0	新功能增加了对在 Linux ARMv8 架构上安装数据收集包的支持。 Linux 的最低要求ARMv8：内存：4 GB CPU: ARM Cortex-A72 或同等规格错误修复和改进改进了节点发现过程中的指标记录。改进了对不支持的数据类型的处理。改进了数据流错误的记录。
2.1.3	新功能添加对 Windows Server 2019 或更高版本的支持。错误修复和改进改进了在不支持的设备上部署此组件时的错误消息。
2.1.1	新功能增加了对配置以下订阅属性的支持： DataChangeTrigger-您可以定义启动数据变更警报的条件。 QueueSizeOPC‐UA 服务器上特定指标的队列深度，其中监控项目的通知已排队。 PublishingIntervalMilliseconds-创建订阅时指定的发布周期间隔（以毫秒为单位）。 SnapshotFrequencyMilliseconds -您可以配置快照频率超时设置，以确保 AWS IoT SiteWise Edge 摄取稳定的数据流。此版本支持采集`BAD`质量数据，并根据以下数据质量筛选数据： `UNCERTAIN`质量数据 `BAD`质量数据错误修复和改进对买家指标的改进。修复了在连接到启用加密的服务器时有时会出现问题的安全编码。修复了属性组更新失败的问题。
2.0.3	错误修复和改进。
2.0.2	错误修复并改进了与 edge 同步的资产优先级。
2.0.1	初始版本。

另请参阅

什么是 AWS IoT SiteWise？在《AWS IoT SiteWise 用户指南》中。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

代币兑换服务

物联网 SiteWise OPC-UA 数据源模拟器