本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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 SiteWise边缘网关
如果 Greengrass 原子核成分（aws.greengrass.Nucleus) 已过期，您可能无法将软件包部署到Amazon IoT SiteWiseEdge 网关。您可以使用Amazon IoT Greengrass V2控制台升级 Greengrass 核组件。
升级 Greengrass 核心组件（控制台）
-
在导航窗格中的下Greengrass，选择部署.
-
在部署列表中，选择要修改的部署。
-
选择修订.
-
在存储库的指定目标页面上，选择下一步.
-
在存储库的选择组件页面，位于公共组件，在搜索框中，输入
aws.greengrass.Nucleus，然后选择aws.greengrass.Nucle. -
选择 Next（下一步）。
-
在存储库的配置组件页面上，选择下一步.
-
在存储库的配置高级设置页面上，选择下一步.
-
在 Review（检查）页上，选择 Deploy（部署）。
Modbus TCP 源不同步
如果你的源数据类型是 ASCII、UTF8 或 ISO8859，并且你正在运行旧版本的 modbus-TCP 协议适配器连接器，那么你的 Modbus TCP 源可能不同步。要将连接器升级到最新版本，请执行以下操作：
-
在导航窗格中，选择 Groups。
-
UNDERGreengrass，请选择目标组。
-
在导航窗格中，选择连接器.
-
在升级列，选择Available.
-
在存储库的升级连接器页面上，选择最新版本，然后选择升级.
有关更多信息，请参阅 。modbus-TCP 协议适配器连接器中的Amazon IoT Greengrass Version 1开发人员指南.
无法连接到流管理器
您可能会看到以下内容swPublisher如果您的网关上未启用流管理器，则会出现错误日志消息Amazon IoT Greengrass组中)。
com.amazonaws.greengrass.streammanager.client.StreamManagerClientImpl: Connect failed
从版本 6 开始，Amazon IoT SiteWise连接器需要流管理器。有关如何启用流管理器的更多信息，请参阅配置 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。如果您使用不同的 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 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 -
重新启动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 天或晚于以后 5 分钟的任何数据future。如果您的网关断电了或断开了与 Amazon 云的连接，您可能需要清除网关的缓存。
-
ThrottlingException要么LimitExceededException— 您的请求超过了Amazon IoT SiteWise服务配额，例如提取的数据点的速率或资产属性数据 API 操作的请求速率。检查您的配置是否未超过 Amazon IoT SiteWise 配额。
排查 Amazon IoT Greengrass 问题
要找到在上配置或部署网关的许多问题的解决方案Amazon IoT Greengrass，请参问题排查Amazon IoT Greengrass中的Amazon IoT Greengrass开发人员指南.