对 SiteWise 边缘网关进行故障排除 - Amazon IoT SiteWise
配置和访问 SiteWise Edge 网关日志排除 SiteWise Edge 网关问题对 Amazon IoT SiteWise Edge 应用程序进行故障排除 Siemens Industrial Edge疑难解答 Amazon IoT Greengrass 问题
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

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

通过浏览相关主题来解决常见的 Amazon IoT SiteWise Edge 网关问题。

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

配置和访问 SiteWise Edge 网关日志

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

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

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

排除 SiteWise Edge 网关问题

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

无法将包部署到 SiteWise Edge 网关

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

升级 n Amazon 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. 在 检查 页上，选择 部署。

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

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

Emitting diagnostic name=PublishError.SomeException

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

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

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

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

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

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

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

控制面板中未显示任何数据

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

要更新数据来源的名称，请按以下步骤操作：

  1. 导航至 Amazon IoT SiteWise 控制台。

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

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

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

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

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

aws.iot 中显示 “找不到或加载主类”。 SiteWiseEdgePublisher 日志at /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 网关都需要一个唯一的配置文件才能连接到您的 Amazon 账户。

我看到了 'com.aws.greengrass.deployment。 IotJobsHelper: 未找到部署作业。' 或“Deployment result already reported. ”

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

这种情况有多种解决方案：

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

    1. 导航至 Amazon IoT SiteWise 控制台。

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

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

    4. 选择更新选项卡。

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

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

尝试在 OPC UA 数据源的属性组中配置时间戳设置时，我看到 “SYNC_FAILED” 状态

在 Amazon IoT SiteWise 更新 2.5.0 版本的 OPC UA 收集器组件时，我们引入了一个新的时间戳配置选项。 Amazon IoT Greengrass 您可以使用设备上的时间戳，也可以使用服务器上的时间戳。旧版本的 OPC UA 收集器组件不支持此选项，因此无法同步。

有两种方法可以解决数据源同步失败的状态。推荐的方法是将 IoT SiteWise OPC UA 收集器组件升级到 2.5.0 或更高版本。或者，如果您将时间戳设置为，则可以继续使用较旧的 OPC UA 收集器组件版本。Source要了解如何升级 IoT SiteWise OPC UA 收集器组件，请参阅更新 Amazon IoT SiteWise 组件的版本。我们建议使用所有组件的最新版本。

注意

当数据源同步状态失败时，不会出现数据中断。源数据继续流入 Amazon IoT SiteWise。配置根本没有与部署中的 IoT SiteWise OPC UA 收集器组件同步。 Amazon IoT Greengrass V2

更改属性组的时间戳配置

  1. 导航至 Amazon IoT SiteWise 控制台。

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

  3. 选择要编辑的网关。

  4. 在数据源部分，选择同步失败状态的数据源，然后选择编辑。

  5. 展开高级配置，然后展开群组设置。

  6. 在时间戳中，选择来源。选择 S ourc e 会将该timestampToReturn属性从配置中删除。默认情况下，此设置允许从您的设备收集数据源时间戳，从而允许数据源与 IoT SiteWise OPC UA 收集器组件同步。

  7. 选择保存。

不包括转换后的数据类型

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

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

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

信任商店问题

如果您在 SiteWise Edge 中遇到与信任存储相关的问题，请考虑以下故障排除步骤：

  • 验证 Amazon IoT Greengrass 根 CA 证书在相应的信任存储中是否存在且格式正确

  • 确保 Java KeyStore 密码设置正确，并且 SiteWise Edge 组件可以访问

  • 检查所有自定义证书（例如 HTTPS 代理）的格式是否正确（通常为 PEM）并正确导入到信任存储库中

  • 确认信任存储库具有正确的文件权限并且 SiteWise Edge 进程可以访问

  • 查看 SiteWise Edge 日志中是否存在任何与 SSL/TLS 相关的错误，这些错误可能表明存在信任存储问题

  • 使用诸如验证信任存储库功能之类openssl的工具独立测试 SSL/TLS 连接

支持代理的安装问题

如果您在代理配置过程中遇到问题，请考虑以下故障排除步骤：

  • 验证代理 URL 的格式是否正确且包含正确的架构（http://或https://）

  • 如果任何代理凭证包含特殊字符，请确保它们都经过网址编码

  • 确认无代理列表包含所有必需的本地地址和 Amazon 服务端点

  • 对于 HTTPS 代理，请验证所提供的 CA 证书是否为 PEM 格式

  • 查看安装日志，了解可能表明问题根源的特定错误消息

  • 独立测试代理连接以确保其正常运行

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

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

我的数据未显示在 Amazon IoT SiteWise

  • 确保您的 Databus 用户没有任何问题，并且 Databus_Configuration 的对勾图标为绿色，而非灰色。

  • 您当前运行的 Siemens Industrial Edge Management 版本可能不包含 Secure Storage 功能。请升级您的 Siemens 操作系统版本。有关更多信息，请参阅 Siemens Secure Storage和 Amazon IoT SiteWise Edge 应用程序。

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

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

我在 Edge 网关配置中看到 “不同步” 错误消息

部署完成后，如果您在Siemens Industrial Edge网关上看到Out of sync错误消息，则表示物联网 SiteWise 发布者组件与您的网关不同步。物联网 SiteWise 发布者组件在Siemens Industrial Edge网关的后台运行，以提供 MQTT 主题功能。我们将Siemens Industrial Edge网关升级为使用功能命名空间，iotsitewise:publisher:3而不是iotsitewise:publisher:2。您可以更新到最新版本的发布者来解决此问题。

升级到最新版本的 IoT SiteWise 发行商

  1. 导航至 Amazon IoT SiteWise 控制台。

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

  3. 选择要编辑的Siemens Industrial Edge网关。

  4. 在 Edge 功能部分中，选择 View 软件版本。

  5. 在 “发布者” 下拉菜单下选择最新版本的 IoT SiteWise 发行商。

  6. 选择完成。

疑难解答 Amazon IoT Greengrass 问题

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