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

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

类型

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

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

操作系统

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

Linux
Windows

要求

此组件具有以下要求：

Greengrass 核心设备必须在以下其中一个平台上运行：
- OS：Ubuntu 18.04 或更高版本
  
  架构：x86_64 (AMD64) 或 ARMv8 (Aarch64)
- OS：Red Hat Enterprise 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 核心设备必须允许与 OPC-UA 服务器进行出站网络连接。

依赖项

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

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

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.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 数据类型	OPC UA 数据类型	描述
`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，如果 SiteWise 能够表示其值，则其 SiteWise 数据类型将为 INTEGER，否则将为 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 Core 软件许可协议下发行。

更改日志

下表介绍每个组件版本的更改。

版本	更改
2.5.0	新功能添加数据来源选项，将简单数组和 DateTime 值转换为字符串。添加属性组选项，在从 OPC-UA 服务器收集数据时选择源时间戳或服务器时间戳。错误修复和改进将默认轮询配置重置为使用源时间戳。
2.4.2	错误修复和改进修复了以下问题：OPC UA 服务器发现期间可能多次发现节点。修复了快照功能，以确保每个快照数据点的时间戳都是新的。
2.4.1	错误修复和改进修复了与代理支持有关的问题。修复了以下问题：线程清理失败并导致数据阻塞。
2.4.0	新功能添加事件日志，便于识别和修复问题。错误修复和改进修复了以下问题：OPC-UA 客户端在连接到使用 OPC-UA 规范版本 1.05 的 OPC-UA 服务器时导致证书错误。
2.3.0	新功能在 Linux 上支持 Greengrass Nucleus HTTP 代理配置。错误修复和改进修复了一个安全问题（CVE-2019-19135）。
2.2.0	新功能添加了对在 Linux ARMv8 架构上安装数据收集包的支持。 Linux ARMv8 的最低要求：内存：4 GB CPU：ARM Cortex-A72 或同等规格错误修复和改进改进了节点发现过程中的指标日志记录。改进了对不支持的数据类型的处理。改进了数据流错误的日志记录。
2.1.3	新功能支持 Windows Server 2019 或更高版本。错误修复和改进改进了在不支持的设备上部署此组件时的错误消息。
2.1.1	新功能支持配置以下订阅属性： DataChangeTrigger — 您可以定义启动数据变更警报的条件。 QueueSize – OPC‐UA 服务器上特定指标的队列深度，其中受监控项目的通知已排队。 PublishingIntervalMilliseconds – 创建订阅时指定的发布周期间隔（以毫秒为单位）。 SnapshotFrequencyMilliseconds — 您可以配置快照频率超时设置，以确保 AWS IoT SiteWise 边缘摄取稳定的数据流。此版本支持采集 `BAD` 质量数据，并根据以下数据质量筛选数据： `UNCERTAIN` 质量数据 `BAD` 质量数据错误修复和改进客户指标改进。修复了在连接到启用加密的服务器时有时会出现问题的安全编码。修复了属性组更新失败的问题。
2.0.3	错误修复和改进。
2.0.2	关于与边缘同步的资产优先级的错误修复和改进。
2.0.1	初始版本。

另请参阅

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

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

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

文档惯例

令牌交换服务

IoT SiteWise OPC-UA 数据来源模拟器