Verstehen von Ergebnissen und Protokollen - AWS IoT Greengrass
Anzeigen der ErgebnisseInterpretation der AWS IoT Device Tester ErgebnisseAnzeigen von -Protokollen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verstehen von Ergebnissen und Protokollen

In diesem Abschnitt wird beschrieben, wie Sie IDT-Ergebnisberichte und -Protokolle anzeigen und interpretieren können.

Informationen zur Behebung von Fehlern finden Sie unterProblembehandlung IDT für V2 AWS IoT Greengrass.

Anzeigen der Ergebnisse

Während der Ausführung schreibt IDT Fehler in die Konsole, Protokolldateien und Testberichte. Nachdem IDT die Qualifikations-Testsuite abgeschlossen hat, erstellt er zwei Testberichte. Diese Berichte befinden sich in<device-tester-extract-location>/results/<execution-id>/. Beide Berichte enthalten die Ergebnisse der Ausführung der Qualifizierungstestsuite.

Dies awsiotdevicetester_report.xml ist der Qualifizierungstestbericht, den Sie einreichen AWS , um Ihr Gerät im AWS Partner Gerätekatalog aufzulisten. Die Bericht enthält die folgenden Elemente:

  • Die IDT-Version.

  • Die AWS IoT Greengrass Version, die getestet wurde.

  • Die SKU- und der Gerätename, die in der device.json-Datei angegeben wurden.

  • Die Funktionen des Gerätepools, der in der device.json-Datei angegeben wurde.

  • Die aggregierte Zusammenfassung der Testergebnisse.

  • Eine Aufschlüsselung der Testergebnisse nach Bibliotheken, die auf der Grundlage der Gerätefunktionen wie lokaler Ressourcenzugriff, Shadow und MQTT getestet wurden.

Der GGV2Q_Result.xml Bericht ist im JUnit XML-Format. Sie können ihn in Continuous Integration and Deployment-Plattformen wie Jenkins, Bamboo usw. integrieren. Die Bericht enthält die folgenden Elemente:

  • Eine aggregierte Zusammenfassung der Testergebnisse.

  • Aufschlüsselung der Testergebnisse nach den getesteten AWS IoT Greengrass Funktionen.

Interpretation der AWS IoT Device Tester Ergebnisse

Der Bericht im Abschnitt awsiotdevicetester_report.xml oder awsiotdevicetester_report.xml listet die Tests und die Ergebnisse auf, die ausgeführt wurden.

Das erste XML-Tag <testsuites> enthält die Zusammenfassung des Testlaufs. Zum Beispiel:

<testsuites name="GGQ results" time="2299" tests="28" failures="0" errors="0" disabled="0">
Im <testsuites>-Tag verwendete Attribute
name

Name der Testsuite

time

Die Zeit in Sekunden, die für die Ausführung der Qualification Suite benötigt wurde.

tests

Die Anzahl der Tests, die ausgeführt wurden.

failures

Die Anzahl der ausgeführten Tests, die den Test nicht bestanden haben

errors

Die Anzahl der Tests, die IDT nicht ausführen konnte.

disabled

Ignoriere dieses Attribut. Sie wird nicht verwendet.

Die Datei awsiotdevicetester_report.xml enthält ein <awsproduct>-Tag mit Informationen zum getesteten Produkt und den Produktfunktionen, die nach einer Reihe von Tests validiert wurden.

Im <awsproduct>-Tag verwendete Attribute
name

Der Name des getesteten Produkts.

version

Die Version des getesteten Produkts.

features

Die validierten Funktionen Als required gekennzeichnete Funktionen sind für die Einreichung Ihres Boards für die Qualifizierung erforderlich. Der folgende Ausschnitt zeigt, wie diese Informationen in der Datei awsiotdevicetester_report.xml angezeigt werden.

<name="aws-iot-greengrass-v2-core" value="supported" type="required"></feature>

Wenn keine Testfehler oder Fehler bei den erforderlichen Funktionen vorliegen, erfüllt Ihr Gerät die technischen Voraussetzungen für den Betrieb AWS IoT Greengrass und kann mit AWS IoT Diensten zusammenarbeiten. Wenn Sie Ihr Gerät im AWS Partner Gerätekatalog auflisten möchten, können Sie diesen Bericht als Qualifikationsnachweis verwenden.

Falls bei Tests Fehler auftreten, können Sie den fehlgeschlagenen Test identifizieren, indem Sie die XML-Tags von <testsuites> überprüfen. Die XML-Tags von <testsuite> im <testsuites>-Tag zeigen die Ergebniszusammenfassung eines Tests für eine Testgruppe. Zum Beispiel:

<testsuite name="combination" package="" tests="1" failures="0" time="161" disabled="0" errors="0" skipped="0">

Das Format ähnelt dem <testsuites>-Tag, weist aber das Attribut skipped auf, das nicht verwendet wird und ignoriert werden kann. In jedem <testsuite> XML-Tag befinden sich <testcase> Tags für jeden Test, der für eine Testgruppe ausgeführt wurde. Zum Beispiel:

<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>>
Im <testcase>-Tag verwendete Attribute
name

Der Name des Tests

attempts

Gibt an, wie oft IDT den Testfall ausgeführt hat.

Wenn ein Testfall fehlschlägt oder ein Fehler auftritt, werden <failure>- oder <error>-Tags hinzugefügt, um das <testcase>-Tag mit Informationen für die Fehlerbehebung zu versehen. Zum Beispiel:

<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>

Anzeigen von -Protokollen

IDT generiert Protokolle von Testläufen in. <devicetester-extract-location>/results/<execution-id>/logs Es werden zwei Protokollgruppen generiert:

test_manager.log

Von der Test Manager-Komponente von generierte Protokolle AWS IoT Device Tester (z. B. Protokolle zur Konfiguration, Testsequenzierung und Berichtserstellung).

<test-case-id>.log (for example, lambdaDeploymentTest.log)

Protokolle des Testfalls innerhalb der Testgruppe, einschließlich der Protokolle des zu testenden Geräts. Ab IDT v4.2.0 gruppiert IDT die Testprotokolle für jeden Testfall in einem separaten <test-case-id> Ordner innerhalb des Verzeichnisses. <devicetester-extract-location>/results/<execution-id>/logs/<test-group-id>/