本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 核心组件(控制台)
-
在导航窗格中,在Greengrass,选择部署.
-
在部署列表中,选择要修改的部署。
-
选择修改.
-
在指定目标页面,选择下一页.
-
在选择组件页面,下方公共组件,在搜索框中,输入
aws.greengrass.Nucleus
,然后选择aws.greengrass.Nuc. -
选择 Next(下一步)。
-
在配置组件页面,选择下一页.
-
在配置高级设置页面,选择下一页.
-
在 Review(检查)页上,选择 Deploy(部署)。
Modbus TCP 源不同步
如果您的源数据类型为 ASCII、UTF8 或 ISO8859,并且您运行的是旧版本的 Modbus-TCP 协议适配器连接器,则您的 Modbus TCP 源可能不同步。要将连接器升级到最新版本,请执行以下操作:
-
在导航窗格中,选择 Groups。
-
下面Greengrass,请选择目标组。
-
在导航窗格中,选择连接器.
-
在升级列,选择Available.
-
在升级连接器页面上,请选择最新版本,然后选择升级.
有关更多信息,请参阅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
-
要卸载当前的 OpenJDK,请运行以下命令之一。
-
sudo apt purge -y openjdk-8-jre-headless
-
sudo apt-get purge -y java-1.8.0-amazon-corretto-jdk
-
-
下载并安装支持的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
-
要重新启动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开发人员指南.