AWS IoT Greengrass Version 1 は 2023 年 6 月 30 日に延長ライフフェーズに参加しました。詳細については、「AWS IoT Greengrass V1 メンテナンスポリシー」を参照してください。この日以降、 AWS IoT Greengrass V1 は機能、機能強化、バグ修正、またはセキュリティパッチを提供する更新をリリースしません。で実行されるデバイスは中断 AWS IoT Greengrass V1 されず、引き続き動作し、クラウドに接続します。に移行 AWS IoT Greengrass Version 2することを強くお勧めします。これにより、重要な新機能が追加され、プラットフォームのサポートが追加されます。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
結果とログを理解する
このセクションでは、IDT の結果レポートとログを表示し、解釈する方法について説明します。
結果の表示
実行中、IDT はコンソール、ログファイル、テストレポートにエラーを書き込みます。IDT で適格性テストスイートを実行すると、2 つのレポートが生成されます。これらのレポートは <device-tester-extract-location>/results/<execution-id>/
awsiotdevicetester_report.xml は、AWS Partner Device Catalog にデバイスを出品する際に AWS に提出する認定テストレポートです。レポートには、次の要素が含まれます。
-
IDT バージョン。
-
テストされた AWS IoT Greengrass のバージョン。
-
device.jsonファイルで指定されている SKU とデバイスプール。 -
device.jsonファイルで指定されているデバイスプールの機能。 -
テスト結果の概要の集計。
-
デバイスの機能 (ローカルリソースアクセス、シャドウ、MQTT など) に基づいてテストしたライブラリごとのテスト結果の内訳。
GGQ_Result.xml レポートは JUnit XML 形式
-
テスト結果の概要を集計したもの。
-
テストされた AWS IoT Greengrass 機能別のテスト結果の内訳。
IDT レポートの解釈
awsiotdevicetester_report.xml または awsiotdevicetester_report.xml のレポートセクションには、実行されたテストとその結果が一覧表示されます。
最初の XML タグ <testsuites> には、テストの実行の概要が含まれています。例:
<testsuites name="GGQ results" time="2299" tests="28" failures="0" errors="0" disabled="0"><testsuites> タグで使用される属性
name-
テストスイートの名前。
time-
適格性確認スイートの実行所要時間 (秒)。
tests-
実行されたテストの数。
failures-
実行されたテストのうち、合格しなかったものの数。
errors-
IDT で実行できなかったテストの数。
disabled-
この属性は使用されていないため無視できます。
awsiotdevicetester_report.xml ファイルには、テスト対象の製品および一連のテストの実行後に検証された製品機能に関する情報を含む <awsproduct> タグが含まれています。
<awsproduct> タグで使用される属性
name-
テスト対象の製品の名前。
version-
テスト対象の製品のバージョン。
features-
検証された機能です。
requiredとしてマークされている機能については、資格を得るためにボードを提出するために必要です。次のスニペットは、この情報がawsiotdevicetester_report.xmlファイルで表示される方法を示します。<feature name="aws-iot-greengrass-no-container" value="supported" type="required"></feature>optionalとしてマークされている機能は、資格を得るために必要ありません。次のスニペットは、オプションの機能を示しています。<feature name="aws-iot-greengrass-container" value="supported" type="optional"></feature> <feature name="aws-iot-greengrass-hsi" value="not-supported" type="optional"></feature>
必要な機能に対してテストに障害やエラーがない場合、そのデバイスは AWS IoT Greengrass を実行するための技術的要件を満たしており、AWS IoT サービスとの相互運用が可能です。AWS Partner Device Catalog にデバイスを記載する場合、認定の証拠としてこのレポートを使用できます。
テストに障害やエラーが発生した場合は、<testsuites> XML タグを確認することで、障害の生じたテストを特定できます。<testsuites> タグ内の <testsuite> XML タグは、テストグループのテスト結果の要約を示します。例:
<testsuite name="combination" package="" tests="1" failures="0" time="161" disabled="0" errors="0" skipped="0">形式は <testsuites> タグと似ていますが、使用されていないため無視できる skipped という属性があります。各 <testsuite> XML タグ内には、テストグループの実行されたテスト別の <testcase> タグがあります。例:
<testcase classname="Security Combination (IPD + DCM) Test Context" name="Security Combination IP Change Tests sec4_test_1: Should rotate server cert when IPD disabled and following changes are made:Add CIS conn info and Add another CIS conn info" attempts="1"></testcase>><testcase> タグで使用される属性
name-
テストの名前。
attempts-
IDT でテストケースを実行した回数。
テストに障害やエラーが発生した場合、<failure> タグまたは <error> タグがトラブルシューティングのための情報とともに <testcase> タグに追加されます。例:
<testcase classname="mcu.Full_MQTT" name="AFQP_MQTT_Connect_HappyCase" attempts="1">
<failure type="Failure">Reason for the test failure</failure>
<error>Reason for the test execution error</error>
</testcase>ログの表示
IDT は、<devicetester-extract-location>/results/<execution-id>/logs
test_manager.log-
AWS IoT Device Tester の Test Manager コンポーネントから生成されたログ (たとえば、設定、テストの順序付け、およびレポート生成に関連したログ)。
<test_case_id>.log (for example, ota.log)-
テストされているデバイスからのログを含む、テストグループのログ。テストが失敗すると、テストのテスト対象デバイスのログを含む tar.gz ファイルが作成されます (例:
ota_prod_test_1_ggc_logs.tar.gz)。
詳細については、「IDT for AWS IoT Greengrass トラブルシューティング」を参照してください。
