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

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

Amazon IoT SiteWise 网关故障排除

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

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

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

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

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

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

排查网关问题

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

无法将包部署到Amazon IoT SiteWise Edge 网关

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

升级 nAmazon 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. Review(检查)页上,选择 Deploy(部署)。

Modbus TCP 源不同步

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

  1. 登录 Amazon IoT GreengrassV1 控制台

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

  3. 在 “Amazon IoT Greengrass群组” 下,选择目标群组。

  4. 在导航窗格中,选择 Sch en

  5. 升级列中,选择可用

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

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

无法连接到直播管理器

如果您的网关Amazon IoT Greengrass群组上未启用直播管理器,您可能会看到以下swPublisher错误日志消息。

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

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

无法连接到 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 发行版,请查阅您设备的相关文档。

降级为支持亚马逊 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 服务器发送的数据,您可以搜索网关的日志来解决问题。查找包含以下消息的信息级别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 云的连接,您可能需要清除网关的缓存。

  • ThrottlingExceptionLimitExceededException— 您的请求超过了Amazon IoT SiteWise服务配额,例如采集数据点的速率或资产财产数据 API 操作的请求速率。检查您的配置是否未超过 Amazon IoT SiteWise 配额

仪表板中未显示任何数据

如果仪表板中没有显示任何数据,则在Amazon IoT SiteWise控制台中检查发布商配置数据源是否不同步。要解决此问题,请使用以下产品:

  1. 登录Amazon IoT SiteWise控制台

  2. 在 “边” 部分中,打开 “网关” 部分。

  3. 在 “数据源” 下,选择 “编辑”

    
                Amazon IoT SiteWise网关数据源编辑屏幕截图。
  4. 选择新的来源名称,然后选择 “保存” 以确认您的更改。

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

更改数据源名称可以加快从云到边缘的同步,从而修复 “不同步” 错误。

排查 Amazon IoT Greengrass 问题

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