Présentation des résultats et des journaux - AWS IoT Greengrass
Affichage des résultatsInterprétation AWS IoT Device Tester des résultatsAffichage des journaux

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Présentation des résultats et des journaux

Cette section explique comment afficher et interpréter les journaux et les rapports de résultats IDT.

Pour résoudre les erreurs, voirRésolution des problèmes liés à IDT pour V2 AWS IoT Greengrass.

Affichage des résultats

Lorsqu'il s'exécute, IDT écrit les erreurs sur la console, les fichiers journaux et les rapports de tests. Une fois que l'outil a terminé la suite de tests, il génère deux rapports de tests. Ces rapports se trouvent dans<device-tester-extract-location>/results/<execution-id>/. Les deux rapports capturent les résultats de l'exécution de la suite de tests de qualification.

awsiotdevicetester_report.xmlIl s'agit du rapport de test de qualification que vous soumettez AWS pour répertorier votre appareil dans le catalogue des AWS Partner appareils. Ce rapport contient les éléments suivants :

  • La version IDT.

  • AWS IoT Greengrass Version testée.

  • La référence et le nom du groupe d'appareils spécifié dans le fichier device.json.

  • Les caractéristiques du groupe d'appareils spécifié dans le fichier device.json.

  • Le récapitulatif des résultats des tests.

  • Répartition des résultats des tests par bibliothèques testées en fonction des fonctionnalités de l'appareil, telles que l'accès aux ressources locales, le shadow et le MQTT.

Le GGV2Q_Result.xml rapport est au format JUnit XML. Vous pouvez intégrer des plateformes de déploiement/d'intégration continues tels que Jenkins, Bamboo, etc. Ce rapport contient les éléments suivants :

  • Un récapitulatif des résultats des tests.

  • Répartition des résultats des tests en AWS IoT Greengrass fonction de la fonctionnalité testée.

Interprétation AWS IoT Device Tester des résultats

La section de rapport dans les fichiers awsiotdevicetester_report.xml ou awsiotdevicetester_report.xml répertorie les tests qui ont été exécutés ainsi que leurs résultats.

La première balise XML <testsuites> contient le résumé du test. Par exemple :

<testsuites name="GGQ results" time="2299" tests="28" failures="0" errors="0" disabled="0">
Attributs utilisés dans la balise <testsuites>
name

Nom de la suite de tests.

time

Le temps, en secondes, nécessaire à l'exécution de la suite de qualification.

tests

Le nombre de tests exécutés.

failures

Nombre de tests exécutés mais dont le résultat n'est pas probant.

errors

Le nombre de tests qu'IDT n'a pas pu exécuter.

disabled

Ignorez cet attribut. Elle n'est pas utilisée.

Le fichier awsiotdevicetester_report.xml contient une balise <awsproduct> qui contient des informations relatives au produit testé et les caractéristiques du produit qui ont été validées par une suite de tests.

Attributs utilisés dans la balise <awsproduct>
name

Nom du produit testé.

version

Version du produit testé.

features

Caractéristiques validées. Les caractéristiques portant la mention required sont requises pour pouvoir envoyer votre carte en vue de sa certification. L'extrait de code suivant montre comment ces informations apparaissent dans le fichier awsiotdevicetester_report.xml.

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

En l'absence d'échec des tests ou d'erreurs pour les fonctionnalités requises, votre appareil répond aux exigences techniques requises pour fonctionner AWS IoT Greengrass et peut interagir avec les AWS IoT services. Si vous souhaitez répertorier votre appareil dans le catalogue des AWS Partner appareils, vous pouvez utiliser ce rapport comme preuve de qualification.

En cas d'erreurs ou d'échecs de tests, vous pouvez identifier les tests concernés à l'aide des balises XML <testsuites>. Les balises XML <testsuite> au sein de la balise <testsuites> montrent le récapitulatif des résultats d'un groupe de tests. Par exemple :

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

Le format est similaire à la balise <testsuites>, mais avec un attribut appelé skipped qui n'est pas utilisé et qui ne peut pas être ignoré. Chaque balise <testsuite> XML contient des <testcase> balises pour chaque test effectué pour un groupe de test. Par exemple :

<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>>
Attributs utilisés dans la balise <testcase>
name

Nom du test.

attempts

Le nombre de fois où IDT a exécuté le scénario de test.

Lorsqu'un test échoue ou qu'une erreur se produit, les balises <failure> ou <error> sont ajoutées à la balise <testcase> avec des informations relatives au dépannage. Par exemple :

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

Affichage des journaux

IDT génère des journaux à partir des tests effectués. <devicetester-extract-location>/results/<execution-id>/logs Deux ensembles de journaux sont générés :

test_manager.log

Journaux générés à partir du composant Test Manager de AWS IoT Device Tester (par exemple, journaux relatifs à la configuration, au séquençage des tests et à la génération de rapports).

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

Journaux du scénario de test au sein du groupe de test, y compris les journaux du périphérique testé. À partir de la version 4.2.0 d'IDT, IDT regroupe les journaux de test pour chaque cas de test dans un <test-case-id> dossier distinct au sein du répertoire. <devicetester-extract-location>/results/<execution-id>/logs/<test-group-id>/