AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.
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.
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 à l'emplacement <device-tester-extract-location>/results/<execution-id>/
Leawsiotdevicetester_report.xmlest le rapport de test de qualification que vous soumettez àAWSpour répertorier votre appareil dans leAWS PartnerDispositif Catalog. Ce rapport contient les éléments suivants :
-
La version IDT.
-
La version AWS IoT Greengrass qui a été 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.
-
La répartition des résultats des tests pour les bibliothèques qui ont été testées en fonction des caractéristiques de l'appareil (par exemple, l'accès aux ressources locales, shadow, MQTT, etc).
Le rapport GGQ_Result.xml est au format JUnit XML
-
Un récapitulatif des résultats des tests.
-
Une répartition des résultats des tests en fonction de la fonctionnalité AWS IoT Greengrass testée.
Interprétation des rapports IDT
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é de l'exécution des tests. 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-
Durée, en secondes, nécessaire pour exécuter la suite de qualification.
tests-
Nombre de tests exécutés.
failures-
Nombre de tests exécutés mais dont le résultat n'est pas probant.
errors-
Nombre de tests qu'IDT n'a pas pu exécuter.
disabled-
Cet attribut n'est pas utilisé et peut être ignoré.
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
requiredsont requises pour pouvoir envoyer votre carte en vue de sa certification. L'extrait de code suivant montre comment ces informations apparaissent dans le fichierawsiotdevicetester_report.xml.<feature name="aws-iot-greengrass-no-container" value="supported" type="required"></feature>Les fonctionnalités marquées comme
optionalne sont pas requises pour l'éligibilité. Les extraits suivants illustrent des fonctions facultatives.<feature name="aws-iot-greengrass-container" value="supported" type="optional"></feature> <feature name="aws-iot-greengrass-hsi" value="not-supported" type="optional"></feature>
S'il n'y a pas d'erreurs ou d'échecs de tests pour les fonctionnalités requises, votre appareil répond aux exigences techniques requises pour exécuter AWS IoT Greengrass et peut interagir avec les services AWS IoT. Si vous souhaitez mettre en vente votre appareil dans leAWS PartnerDevice Catalog, 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 XML <testsuite> inclut des balises <testcase> pour chaque test exécuté pour un groupe de tests. 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-
Nombre de fois où IDT a exécuté le 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 de l'exécution du test dans <devicetester-extract-location>/results/<execution-id>/logs
test_manager.log-
Les journaux générés à partir du composant Gestionnaire de tests d'AWS IoT Device Tester (par exemple, les journaux liés à la configuration, au séquençage des tests et à la génération de rapports).
<test_case_id>.log (for example, ota.log)-
Journaux du groupe de tests, y compris les journaux liés à l'appareil qui est testé. Lorsqu'un test échoue, un fichier tar.gz qui contient les journaux de l'appareil testé pour le test correspondant est créé (par exemple,
ota_prod_test_1_ggc_logs.tar.gz).
Pour plus d'informations, consultez Résolution des problèmes liés à IDT pour AWS IoT Greengrass.
