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

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

Amazon IoT SiteWise 网关故障排除

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

您也可以查看 CloudWatch 网关报告的指标,用于解决连接或数据流问题。有关更多信息,请参阅 网关指标

配置和访问 Amazon IoT SiteWise 网关日志

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

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

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

排查网关问题

使用以下信息排查网关问题。

无法将包部署到Amazon IoT SiteWiseEdgge

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

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

  2. 在导航窗格中,在Greengrass,选择部署.

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

  4. 选择修改.

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

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

  7. 选择 Next(下一步)。

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

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

  10. Review(检查)页上,选择 Deploy(部署)。

Modbus TCP 源不同步

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

  1. 登录Amazon IoT GreengrassV1 控制台.

  2. 在导航窗格中,选择 Groups

  3. 下面Greengrass,请选择目标组。

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

  5. 升级列,选择Available.

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

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

无法连接到直播管理器

您可能会看到以下内容swPublisher如果您的网关上未启用直播管理器,则会显示错误日志消息Amazon IoT Greengrassgroup。

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

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

无法连接到 OPC-UA 源

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

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 一起使用 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,运行以下命令。

    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核心软件,运行以下命令。

    sudo /greengrass/ggc/core/greengrassd restart

Amazon IoT SiteWise 不从 OPC-UA 服务器接收数据

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

Emitting diagnostic name=PublishError.SomeException

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

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

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

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

      如果您已在 Amazon IoT SiteWise 中映射了所需的所有 OPC-UA 变量,则可以筛选网关发送的 OPC-UA 变量。有关更多信息,请参阅 使用 OPC-UA 节点筛选条件

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

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

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

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

排查 Amazon IoT Greengrass 问题

要找到在上配置或部署网关的许多问题的解决方案Amazon IoT Greengrass,请参阅问题排查Amazon IoT Greengrass在里面Amazon IoT Greengrass开发人员指南.