本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
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开发人员指南.