的 IDT 问题排查Amazon IoT GreengrassV2 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

的 IDT 问题排查Amazon IoT GreengrassV2

适用于的 IDTAmazon IoT GreengrassV2 根据错误类型将错误写入各种位置。IDT 会将错误写入控制台、日志文件和测试报告中。

在哪里查找错误

测试运行时,控制台上会显示高级错误,所有测试完成后,将显示失败测试的摘要。awsiotdevicetester_report.xml包含导致测试失败的所有错误的摘要。IDT 将每次测试运行的日志文件都存储在一个以 UUUUID 命名的目录中,用于在测试运行期间在控制台上显示的测试执行。

IDT 测试日志目录是<device-tester-extract-location>/results/<execution-id>/logs/. 此目录包含以下对调试有用的文件。

文件 描述
test_manager.log

测试运行期间写入控制台的日志。该文件末尾的结果的摘要包含失败的测试的列表。

此文件中的警告和错误日志可以为您提供有关失败的一些信息。

test-group-id/test-case-id/test-name.log 测试组中特定测试的详细日志。对于部署 Greengrass 组件的测试,测试用例日志文件被称为greengrass-test-run.log.
test-group-id/test-case-id/greengrass.log 的详细日志Amazon IoT Greengrass核心软件。IDT 在运行安装的测试时从受测设备复制此文件Amazon IoT Greengrass设备上的核心软件。有关此日志文件中消息的更多信息,请参阅排除 Amazon IoT Greengrass V2 的故障.
test-group-id/test-case-id/component-name.log 测试运行期间部署的 Greengrass 组件的详细日志。IDT 在运行部署特定组件的测试时,会从被测设备复制组件日志文件。每个组件日志文件的名称对应于已部署组件的名称。有关此日志文件中消息的更多信息,请参阅排除 Amazon IoT Greengrass V2 的故障.

解决适用于的 IDTAmazon IoT GreengrassV2 错误

在运行 IDT 之前Amazon IoT Greengrass,获取正确的配置文件。如果收到解析和配置错误,第一步应找到并使用适合您环境的配置模板。

如果仍有问题,请参阅以下调试过程。

别名解析错误

运行自定义测试套件时,可能会在控制台和test_manager.log.

Couldn't resolve placeholders: couldn't do a json lookup: index out of range

当 IDT 测试管弦乐队中配置的别名无法正确解析或配置文件中没有解析值时,可能会发生此错误。要解决此错误,请确保device.jsonuserdata.json 包含测试套件所需的正确信息。有关所需配置的信息Amazon IoT Greengrass资格,请参阅配置 IDT 设置以运行Amazon IoT Greengrass资格认证套.

冲突错误

运行时,您可能会看到以下错误消息。Amazon IoT Greengrass在多个设备上同时运行资格认证套件。

ConflictException: Component [com.example.IDTHelloWorld : 1.0.0] for account [account-id] already exists with state: [DEPLOYABLE] { RespMetadata: { StatusCode: 409, RequestID: “id” }, Message_: “Component [com.example.IDTHelloWorld : 1.0.0] for account [account-id] already exists with state: [DEPLOYABLE]” }

尚不支持并发测试执行Amazon IoT Greengrass资格认证套件。按顺序运行每个设备的资格认证套件。

无法启动测试错误

在测试启动期间,您可能遇到指示失败的错误。有几种可能的原因,因此,请执行以下操作:

  • 确保执行命令中的池名称实际存在。IDT 直接从你的池名称device.json文件。

  • 确保池中的设备具有正确的配置参数。

Docker 资格映像存在错误

Docker 应用程序管理员资格测试使用amazon/amazon-ec2-metadata-mock在 Amazon ECR 中使用容器映像,以符合所测试设备的要求。

如果映像已存在于受测设备上的 Docker 容器中,则可能会收到以下错误消息。

The Docker image amazon/amazon-ec2-metadata-mock:version already exists on the device.

如果您之前下载了此图片并运行amazon/amazon-ec2-metadata-mock在设备上的容器中,请确保在运行资格测试之前从受测设备中删除此映像。

无法读取凭据

在测试 Windows 设备时,您可能会遇到Failed to read credential中出现错误greengrass.log文件,如果用于连接到受测设备的用户未在该设备的凭据管理器中设置。

要解决此错误,请在被测设备的凭据管理器中为 IDT 用户配置用户和密码。这与在中指定的用户和密码相同。device.json文件.

有关更多信息,请参阅 为 Windows 设备配置用户凭据

无效的签名例外

当运行 Lambda 资格认证测试时,您可能会遇到invalidsignatureexception如果您的 IDT 主机遇到网络访问问题,则错误。重置路由器然后再次运行测试。

机器学习认证错误

运行机器学习 (ML) 资格测试时,如果设备不符合要求部署Amazon-提供了机器学习组件。要排查 ML 资格认证错误,请执行以下操作:

  • 在组件日志中查找测试运行期间部署的组件的错误详细信息。组件日志位于<device-tester-extract-location>/results/<execution-id>/logs/<test-group-id>目录。

  • 添加-Dgg.persist=installed.software参数test.json为失败的测试用例提交文件。这些区域有:test.json文件位于<device-tester-extract-location>/tests/GGV2Q_version directory.

解析错误

JSON 配置中的拼写错误会导致解析错误。大部分情况下,问题是因 JSON 文件中漏掉括号、逗号或引号所导致。IDT 执行 JSON 验证并输入调试信息。它输出发生错误的行、行号以及语法错误的列号。这些信息应足以帮助修复错误,但是如果仍不能定位错误,则可以通过您的 IDE、文本编辑器(例如 Atom 或 Sublime)或 JSONLint 等在线工具手动执行验证。

权限被拒绝错误

IDT 将对所测试设备中的各种目录和文件执行操作。其中一些操作需要根用户访问权限。要自动执行这些操作,IDT 必须能够在不键入密码的情况下使用 sudo 运行命令。

请按照以下步骤操作,以允许在不键入密码的情况下进行 sudo 访问。

注意

userusername 是指 IDT 用来访问所测试设备的 SSH 用户。

  1. 使用 sudo usermod -aG sudo <ssh-username> 将 SSH 用户添加到 sudo 组。

  2. 注销,然后重新登录,以使更改生效。

  3. 打开 /etc/sudoers 文件,并将以下行添加到文件末尾:<ssh-username> ALL=(ALL) NOPASSWD: ALL

    注意

    作为最佳实践,我们建议您在编辑 /etc/sudoers 时使用 sudo visudo

生成资格报告错误

IDT 支持最新的四个major.minor的版本Amazon IoT GreengrassV2 资格套件 (GGV2Q),用于生成资格报告,您可以提交给Amazon Partner Network将你的设备包含在Amazon Partner设备目录。资格套件的早期版本不会生成资格报告。

如果您对支持策略有疑问,请联系Amazon Web Services Support在http://www.amazonaws.cn/contact-us/.

缺少必需参数错误

当 IDT 添加新功能时,它可能会对配置文件进行更改。使用旧配置文件可能会破坏您的配置。如果出现这种情况,/results/<execution-id>/logs 下的 <test_case_id>.log 文件明确列出了所有缺少的参数。IDT 还将验证 JSON 配置文件架构,以验证您使用的支持版本。

macOS 上的安全例外

当您在使用 macOS 10.15 的主机上运行 IDT 时,未检测到 IDT 的公证票,这会阻止 IDT 运行。要运行 IDT,请向devicetester_mac_x86-64可执行的。请执行下列操作之一:

向 IDT 可执行文件授予安全例外

  1. 启动系统首选项从苹果菜单中查找。

  2. 选择安全与隐私,然后在普通的选项卡中,选择锁图标以更改安全设置。

  3. 寻找消息"devicetester_mac_x86-64" was blocked from use because it is not from an identified developer.然后选择无论如何,.

  4. 接受安全警告。

SSH 连接错误

当 IDT 无法连接到所测试设备时,会在中记录连接失败/results/<execution-id>/logs/<test-case-id>.log. SSH 消息将显示在此日志文件的顶部,因为连接到所测试设备是 IDT 最先执行的操作之一。

大多数 Windows 配置使用 PuTTy 终端应用程序连接到 Linux 主机。该应用程序要求将标准 PEM 私有密钥文件转换为称为 PPK 的专有 Windows 格式。如果你在你的device.json文件,请使用 PEM 文件。如果使用 PPK 文件,IDT 将无法与Amazon IoT Greengrass设备且无法运行测试。

从 IDT v4.4.0 开始,如果您尚未在受测设备上启用 SFTP,则可能会在日志文件中看到以下错误。

SSH connection failed with EOF

要纠正此错误,请在设备上启用 SFTP。

流管理器资格认证错

当您运行直播管理器资格测试时,您可能会看到以下错误。com.aws.StreamManagerExport.log文件。

Failed to upload data to S3

当流管理器使用Amazon中的凭证~/root/.aws/credentials而不是使用 IDT 导出到被测设备的环境凭据。要防止出现此问题,请删除credentials在设备上提交文件,然后重新运行资格测试。

超时错误

您可以通过指定应用于每个测试超时的默认值来增加每个测试的超时。为此标志配置的任何值都必须大于或等于 1.0。

要使用超时乘数,请在运行测试时使用标志 --timeout-multiplier。例如:

./devicetester_linux run-suite --suite-id GGV2Q_1.0.0 --pool-id DevicePool1 --timeout-multiplier 2.5

有关更多信息,请运行 run-suite --help

由于配置问题而无法完成 IDT 测试用例时,会出现一些超时错误。你无法通过增加超时乘数来解决这些错误。使用测试运行中的日志来解决底层配置问题。

  • 如果 MQTT 或 Lambda 组件日志包含Access denied错误,您的 Greengrass 安装文件夹可能没有正确的文件权限。为在安装路径中定义的每个文件夹运行以下命令userdata.json文件。

    sudo chmod 755 folder-name
  • 如果 Greengrass 日志表明 Greengrass CLI 部署尚未完成,请执行以下操作:

    • 确认 。bash已安装在所测试设备上。

    • 如果您的userdata.json文件中包含GreengrassCliVersion配置参数,请将其删除。在 IDT 版本 4.1.0 及更高版本中,不建议使用此参数。有关更多信息,请参阅 配置 userdata.json

版本检查错误

IDT 在AmazonIDT 用户的用户凭证没有所需的 IAM 权限。

Failed to check version compatibility

这些区域有:Amazon没有所需 IAM 权限的用户。