对 SiteWise 边缘网关进行故障排除 - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

对 SiteWise 边缘网关进行故障排除

Amazon IoT SiteWise 边缘网关运行一组 Amazon IoT Greengrass 组件。您可以将 SiteWise Edge 网关配置为将连接器事件记录到 Amazon CloudWatch 和 SiteWise Edge 网关的本地文件系统。然后,您可以查看与连接器关联的日志文件,以便对 SiteWise Edge 网关进行故障排除。

您还可以查看 SiteWise Edge 网关报告的 CloudWatch 指标,以解决连接或数据流问题。有关更多信息,请参阅Amazon IoT Greengrass Version 1 网关指标

配置和访问 SiteWise Edge 网关日志

在查看 SiteWise Edge 网关日志之前,必须将 SiteWise Edge 网关配置为将日志发送到 Amazon CloudWatch Logs 或将日志存储在本地文件系统上。

  • 如果您想使用 CloudWatch Amazon Web Services Management Console 来查看 SiteWise Edge 网关的日志文件,请使用日志。有关更多信息,请参阅使用 Amazon CloudWatch 日志

  • 如果您想使用命令行或本地软件查看 SiteWise Edge 网关的日志文件,请使用本地文件系统日志。有关更多信息,请参阅使用服务日志

排除 SiteWise Edge 网关问题

使用以下信息对 SiteWise Edge 网关问题进行故障排除。

无法将包部署到 SiteWise Edge 网关

如果 n Amazon IoT Greengrass ucleus 组件 (aws.greengrass.Nucleus) 已过期,则可能无法将包部署到您的 SiteWise Edge 网关。您可以使用 Amazon IoT Greengrass V2 控制台升级 n Amazon IoT Greengrass ucleus 组件。

升级 n Amazon IoT Greengrass ucleus 组件(控制台)
  1. 导航到 Amazon IoT Greengrass 控制台

  2. 在导航窗格的 Amazon IoT Greengrass 下,选择部署

  3. 部署列表中,选择要修改的部署。

  4. 选择修订

  5. 指定目标页面,选择下一步

  6. 选择组件页面上公共组件下的搜索框中,输入 aws.greengrass.Nucleus,然后选择 aws.greengrass.Nucleus

  7. 选择下一步

  8. 配置组件页面上,选择下一步

  9. 配置高级设置页面上,选择下一步

  10. 检查 页上,选择 部署

Modbus TCP 源不同步

如果您的源数据类型是 ASCII、UTF8 或 ISO8859,并且您运行的是旧版本的 Modbus-TCP 协议适配器连接器,那么您的 Modbus TCP 源可能会不同步。要将连接器升级到最新版本,请执行以下操作:

  1. 登录 Amazon IoT Greengrass V1 控制台

  2. 在导航窗格中,选择

  3. Amazon IoT Greengrass 组下,选择目标组。

  4. 在导航窗格中,选择连接器

  5. 升级列中,选择可用

  6. 升级连接器页面上,选择最新版本,然后选择升级

有关更多信息,请参阅 Amazon IoT Greengrass Version 1 开发人员指南中的 Modbus-TCP 协议适配器连接器

无法连接到流管理器

如果您的 SiteWise Edge 网关 Amazon IoT Greengrass 组中未启用流管理器,则可能会看到以下swPublisher错误日志消息。

com.amazonaws.greengrass.streammanager.client.StreamManagerClientImpl: Connect failed

从版本 6 开始, Amazon IoT SiteWise 连接器需要流管理器。有关如何启用流管理器的更多信息,请参阅 配置群 Amazon IoT Greengrass 组 的步骤 5。

无法连接到 OPC-UA 源

如果已安装的 OpenJDK 版本不受支持,您可能会看到以下 OPCUACollector 错误日志消息。

java.security.KeyStoreException: Key protection algorithm not found: java.security.UnrecoverableKeyException: Encrypt Private Key failed: unrecognized algorithm name: PBEWithSHA1AndDESede Failed to start OPC-UA Connection for Source 'Server 1': Failed to add key to store

要降级到支持的 OpenJDK 版本,请按照本节中的步骤操作。这些步骤假定您使用的是装有 Ubuntu 的设备。如果您使用的是其他 Linux 发行版,请查阅您设备的相关文档。

降级到支持 Amazon Corretto 8
  1. 若要卸载当前的 OpenJDK,请运行以下命令之一。

    • sudo apt purge -y openjdk-8-jre-headless
    • sudo apt-get purge -y java-1.8.0-amazon-corretto-jdk
  2. 要下载并安装支持的 Amazon Corretto 8,请运行以下命令。

    curl -s https://corretto.aws/downloads/resources/8.282.08.1/java-1.8.0-amazon-corretto-jdk_8.282.08-1_amd64.deb --output /tmp/java-1.8.0-amazon-corretto-jdk_8.282.08-1_amd64.deb sudo apt-get update && sudo apt-get install java-common sudo dpkg --install /tmp/java-1.8.0-amazon-corretto-jdk_8.282.08-1_amd64.deb
  3. 要重新启动 Amazon IoT Greengrass V1 Core 软件,请运行以下命令。

    sudo /greengrass/ggc/core/greengrassd restart

Amazon IoT SiteWise 不接收来自 OPC-UA 服务器的数据

如果您的 Amazon IoT SiteWise 资产未接收 OPC-UA 服务器发送的数据,则可以搜索 SiteWise Edge 网关的日志来解决问题。查找包含以下消息的信息级别 swPublisher 日志。

Emitting diagnostic name=PublishError.SomeException

根据日志SomeException中的类型,使用以下异常类型和相应的问题对您的 SiteWise Edge 网关进行故障排除:

  • ResourceNotFoundException— 您的 OPC-UA 服务器发送的数据与任何资产的属性别名都不匹配。在以下两种情况下,可能会发生此异常:

    • 您的属性别名与 OPC-UA 变量不完全匹配,包括您定义的任何源前缀。检查属性别名和源前缀是否正确。

    • 您尚未将 OPC-UA 变量映射到资产属性。有关更多信息,请参阅将工业数据流映射到资产属性

      如果您已经映射了想要输入的所有 OPC-UA 变量,则可以筛选 Ed Amazon IoT SiteWise ge 网关发送了哪些 OPC-UA 变量。 SiteWise 有关更多信息,请参阅使用 OPC-UA 节点筛选条件

  • AccessDeniedException— 您的 SiteWise Edge 网关的 Amazon IoT Greengrass 群组没有足够的权限使用该BatchPutAssetPropertyValue操作向资产属性发送数据。有关更多信息,请参阅 Amazon IoT SiteWise 连接器要求

  • InvalidRequestException— 您的 OPC-UA 变量数据类型与您的资产属性数据类型不匹配。例如,如果 OPC-UA 变量具有整数数据类型,相应的资产属性则必须是整数数据类型。双精度类型的资产属性不能接收 OPC-UA 整数值。要解决此问题,请使用正确的数据类型定义新属性。

  • TimestampOutOfRangeException— 您的 SiteWise Edge 网关正在发送超出可 Amazon IoT SiteWise 接受范围的数据。 Amazon IoT SiteWise 拒绝过去时间戳早于 7 天或将来 5 分钟以上的任何数据点。如果您的 SiteWise Edge 网关断电或与 Amazon 云的连接中断,则可能需要清除 SiteWise Edge 网关的缓存。

  • ThrottlingException或者 LimitExceededException— 您的请求超出了 Amazon IoT SiteWise 服务配额,例如提取的数据点速率或资产属性数据 API 操作的请求速率。检查您的配置是否未超过 Amazon IoT SiteWise 配额

控制面板中未显示任何数据

如果控制面板中没有显示任何数据,那么请在Amazon IoT SiteWise 控制台中检查发布者配置数据来源是否不同步。要修复这一问题,请使用以下过程:

  1. 登录 Amazon IoT SiteWise 控制台

  2. Edge 部分,打开网关部分。

  3. 数据来源下,选择编辑

    
                SiteWise 边缘网关数据源编辑屏幕截图。
  4. 选择一个新的源名称,然后选择保存以确认您的更改。

  5. 确认数据来源表中的数据来源名称已更新,以验证您的更改。

更改数据来源名称可能会加快从云端到边缘的同步,从而修复不同步错误。

aws.iot 中显示 “找不到或加载主类”。 SiteWiseEdgePublisher 在 /greengrass/v2/logs 处记录错误

如果您看到此错误,则可能需要更新 SiteWise Edge 网关的 Java 版本。

  • 从终端设备运行以下命令:

    java -version

    您的 SiteWise Edge 网关所运行的 java 版本将显示在下面OpenJDK Runtime Environment。您会看到如下响应:

    openjdk version "11.0.20" 2023-07-18 LTS OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node)

如果你运行的是 Java 版本 11.0.20.8.1,则必须将 IoT P SiteWise ublisher 包更新到 2.4.1 或更高版本。只有 java 版本 11.0.20.8.1 受到影响,具有其他 Java 版本的环境可以继续使用旧版本的 IoT SiteWise Publisher 组件。有关更新组件包的更多信息,请参阅更改 SiteWise Edge 网关组件包的版本

疑难解答 Amazon IoT Greengrass 问题

要查找在上配置或部署 SiteWise Edge 网关的许多问题的解决方案 Amazon IoT Greengrass,请参阅Amazon IoT Greengrass 开发人员指南 Amazon IoT Greengrass中的疑难解答