物联网 SiteWise OPC-UA 采集器 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

物联网 SiteWise OPC-UA 采集器

物联网 SiteWise OPC-UA 收集器组件 (aws.iot.SiteWiseEdgeCollectorOpcua) 使 Amazon IoT SiteWise 网关能够从本地 OPC-UA 服务器收集数据。

使用此组件, Amazon IoT SiteWise 网关可以连接到多台 OPC-UA 服务器。有关 Amazon IoT SiteWise 网关的更多信息,请参阅Amazon IoT SiteWise 用户指南》中的在边缘使用 Amazon IoT SiteWise

版本

此组件有以下版本:

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Type

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

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

操作系统

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

  • 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 服务器的出站网络连接。

依赖项

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

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

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

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

配置

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

您可以使用 Amazon IoT SiteWise 控制台或 API 来配置 IoT SiteWise OPC-UA 收集器组件。有关更多信息,请参阅《Amazon 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^100IEEE 754双精度。

BOOLEAN

Boolean

truefalse

* 对于 OPC UA 数据类型UInt32Int64INTEGER如果能够表示其值,则其 SiteWise 数据类型将为,否则将 SiteWise DOUBLE是。

输出数据

此组件将BatchPutAssetPropertyValue消息写入 Amazon IoT Greengrass 流管理器。有关更多信息,请参阅《Amazon 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 替换为 Amazon 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 替换为 Amazon IoT Greengrass 根文件夹的路径。

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

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

  • 严重性级别

  • 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.4.2

错误修复和改进
  • 修复了 OPC UA 服务器发现期间可能多次发现节点的问题。

  • 修复了快照功能,以确保每个快照数据点的时间戳都是新的。

2.4.1

错误修复和改进
  • 修复了与代理支持有关的问题。

  • 修复了线程清理失败并导致数据阻塞的问题。

2.4.0

新功能
  • 添加事件日志,便于识别和修复问题。

错误修复和改进
  • 修复了 OPC-UA 客户端在连接到使用 OPC-UA 规范版本 1.05 的 OPC-UA 服务器时导致证书错误的问题。

2.3.0

新功能
  • 在 Linux 上添加对 Greengrass n ucleu s HTTP 代理配置的支持。

错误修复和改进

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 -您可以配置快照频率超时设置,以确保 Amazon IoT SiteWise Edge 摄取稳定的数据流。

  • 此版本支持采集BAD质量数据,并根据以下数据质量筛选数据:

    • UNCERTAIN质量数据

    • BAD质量数据

错误修复和改进
  • 对买家指标的改进。

  • 修复了在连接到启用加密的服务器时有时会出现问题的安全编码。

  • 修复了属性组更新失败的问题。

2.0.3

错误修复和改进。

2.0.2

错误修复并改进了与 edge 同步的资产优先级。

2.0.1

初始版本。

另请参阅