对 SiteWise 边缘网关进行故障排除 - AWS IoT SiteWise
配置和访问 SiteWise Edge 网关日志排除 SiteWise Edge 网关问题对 AWS IoT SiteWise Edge 应用程序进行故障排除 Siemens Industrial Edge疑难解答 AWS IoT Greengrass 问题

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

对 SiteWise 边缘网关进行故障排除

浏览相关主题，解决常见的 AWS IoT SiteWise Edge 网关问题。

您还可以查看 SiteWise Edge 网关报告的 CloudWatch 指标，以解决连接或数据流问题。有关更多信息，请参阅 AWS IoT SiteWise 使用 Amazon CloudWatch 指标进行监控。

配置和访问 SiteWise Edge 网关日志

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

  • 如果您想使用 CloudWatch AWS Management Console 来查看 SiteWise Edge 网关的日志文件，请使用日志。有关更多信息，请参阅 使用 Amazon CloudWatch 日志。

  • 如果您想使用命令行或本地软件查看 SiteWise Edge 网关的日志文件，请使用本地文件系统日志。有关更多信息，请参阅 使用服务日志。

排除 SiteWise Edge 网关问题

使用以下信息对 SiteWise Edge 网关问题进行故障排除。

无法将包部署到 SiteWise Edge 网关

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

升级 n AWS IoT Greengrass ucleus 组件（控制台）

  1. 导航到 AWS IoT Greengrass 控制台。

  2. 在导航窗格的 AWS IoT Greengrass 下，选择部署。

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

  4. 选择修订。

  5. 在指定目标页面，选择下一步。

  6. 在选择组件页面上公共组件下的搜索框中，输入 aws.greengrass.Nucleus，然后选择 aws.greengrass.Nucleus。

  7. 选择下一步。

  8. 在配置组件页面上，选择下一步。

  9. 在配置高级设置页面上，选择下一步。

  10. 在 检查 页上，选择 部署。

AWS IoT SiteWise 不接收来自 OPC UA 服务器的数据

如果您的 AWS IoT SiteWise 资产未接收 OPC UA 服务器发送的数据，则可以搜索 SiteWise Edge 网关的日志来解决问题。查找包含以下消息的信息级别 swPublisher 日志。

Emitting diagnostic name=PublishError.SomeException

根据类型 SomeException 在日志中，使用以下异常类型和相应的问题对您的 SiteWise Edge 网关进行故障排除：

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

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

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

      如果您已经映射了想要输入的所有 OPC UA 变量 AWS IoT SiteWise，则可以筛选 SiteWise Edge 网关发送了哪些 OPC UA 变量。有关更多信息，请参阅 使用 OPC UA 节点过滤器。

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

  • TimestampOutOfRangeException— 您的 SiteWise Edge 网关正在发送超出可 AWS IoT SiteWise 接受范围的数据。 AWS IoT SiteWise 拒绝过去时间戳早于 7 天或将来 5 分钟以上的任何数据点。如果您的 SiteWise Edge 网关断电或与 AWS 云的连接中断，则可能需要清除 SiteWise Edge 网关的缓存。

  • ThrottlingException或者 LimitExceededException— 您的请求超出了 AWS IoT SiteWise 服务配额，例如采集的数据点速率或资产属性数据API操作的请求速率。检查您的配置是否未超过 AWS IoT SiteWise 配额。

仪表板中没有显示任何数据

如果您的控制面板中没有显示任何数据，则 SiteWise Edge 网关的发布器配置和 Dat a Sour ce 可能不同步。如果它们不同步，更新数据源的名称可能会加快从云端到边缘的同步，从而修复不同步错误。

更新数据源的名称

  1. 导航到 AWS IoT SiteWise 控制台。

  2. 在导航窗格中，选择 Edge 网关。

  3. 选择连接到仪表板的 SiteWise Edge 网关。

  4. 在数据来源下，选择编辑。

  5. 选择一个新的源名称，然后选择保存以确认您的更改。

  6. 确认数据来源表中的数据来源名称已更新，以验证您的更改。

aws.iot 中显示 “找不到或加载主类”。 SiteWiseEdgePublisher 在 /greengrass/v2/logs 处记录错误

如果您看到此错误，则可能需要更新 SiteWise Edge 网关的 Java 版本。

  • 从终端设备运行以下命令：

    java -version

    您的 SiteWise Edge 网关所运行的 java 版本将显示在下面OpenJDK Runtime Environment。您会看到如下响应：

    openjdk version "11.0.20" 2023-07-18 LTS
OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS
OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node)

如果你运行的是 Java 版本 11.0.20.8.1，则必须将 IoT P SiteWise ublisher 包更新到 2.4.1 或更高版本。只有 java 版本 11.0.20.8.1 受到影响，具有其他 Java 版本的环境可以继续使用旧版本的 IoT SiteWise Publisher 组件。有关更新组件包的更多信息，请参阅更改 SiteWise Edge 网关组件包的版本。

我看见了 'SESSION_ TAKEN _OVER' 或 'com.aws.greengrass.mqttclient。 MqttClient: 无法通过 Spooler 发布消息，将重试。' 在日志中

如果您在的日志com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.中看到包含的警告SESSION_TAKEN_OVER或包含错误的信息/greengrass/v2/logs/greengrass.log，则可能是您正在尝试对多台设备上的多个 SiteWise Edge 网关使用相同的配置文件。每个 SiteWise Edge 网关都需要一个唯一的配置文件才能连接到您的 AWS 账户。

我看到了 'com.aws.greengrass.deployment。 IotJobsHelper: 未找到部署作业。' 或 “部署结果已报告。” 在日志中

如果您在的日志Deployment result already reported.中看到com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.或/greengrass/v2/logs/greengrass.log，则可能正在尝试重复使用相同的配置文件。

有多种解决方案：

  • 如果要重复使用配置文件，请执行以下操作：

    1. 导航到 AWS IoT SiteWise 控制台。

    2. 在导航窗格中，选择 网关。

    3. 选择要重复使用的 SiteWise Edge 网关。

    4. 选择 “更新” 选项卡。

    5. 选择其他发布者版本，然后选择 “部署”。

按照中的为创建网关 Siemens Industrial Edge步骤创建新的配置文件。

不包括转换后的数据类型

如果您在将不支持的 OPC UA 数据类型转换为字符串时看到错误 AWS IoT SiteWise，可能有以下几个原因：

  • 您尝试转换的数据类型是复杂的数据类型。不支持复杂的数据类型。

  • 使用 Amazon S3 将目标用作AWS IoT SiteWise 缓冲区时，完整的字符串值会保留在推送到 Amazon S3 存储桶的文件中。稍后向中提取数据时 AWS IoT SiteWise，长度超过 1024 字节的完整字符串值将被拒绝。

对 AWS IoT SiteWise Edge 应用程序进行故障排除 Siemens Industrial Edge

要对Siemens Industrial Edge设备上的 AWS IoT SiteWise Edge 应用程序进行故障排除，您可以通过Siemens Industrial Edge Management或Siemens Industrial Edge设备 (IED) 门户访问该应用程序的日志。有关更多信息，请参阅 Siemens 文档中的下载日志。

我的数据未显示在 AWS IoT SiteWise

  • 确保您的Databus用户没有问题，并且 Databus_Configurat ion 的复选标记图标为绿色而不是灰色。

  • 您可能无法在包含以下内容的版本Siemens Industrial Edge Management上运行Secure Storage。升级您的西门子操作系统版本。有关更多信息，请参阅 Siemens Secure Storage和 AWS IoT SiteWise Edge 应用程序。

我在日志中看到 “缺少配置文件 AWS _REGION”。

如果您Config file missing AWS_REGION在西门子日志中看到JSON，则配置文件已损坏。你需要创建一个新的配置文件。按照中的为创建网关 Siemens Industrial Edge步骤创建新的配置文件。

疑难解答 AWS IoT Greengrass 问题

要查找在上配置或部署 SiteWise Edge 网关的许多问题的解决方案 AWS IoT Greengrass，请参阅AWS IoT Greengrass 开发人员指南 AWS IoT Greengrass中的疑难解答。