Descripción de los resultados y de los registros - AWS IoT Greengrass

Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita Migrar desde AWS IoT Greengrass Version 1.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Descripción de los resultados y de los registros

En esta sección se describe cómo ver e interpretar registros e informes de resultados de IDT.

Ver los resultados

Mientras ejecuta, IDT escribe errores en la consola, en archivos de registro y en informes de prueba. Una vez que IDT completa el conjunto de pruebas de cualificación, genera dos informes de prueba. Estos informes se pueden encontrar en <device-tester-extract-location>/results/<execution-id>/. Ambos informes capturan los resultados de la ejecución del conjunto de pruebas de cualificación.

Este awsiotdevicetester_report.xml es el informe de la prueba de calificación que debe enviar AWS para incluir su dispositivo en el catálogo de AWS Partner dispositivos. El informe contiene los componentes siguientes:

  • La versión de IDT.

  • La AWS IoT Greengrass versión que se probó.

  • El SKU y el grupo de dispositivos especificado en el archivo device.json.

  • Las características del grupo de dispositivos especificado en el archivo device.json.

  • El resumen de agregación de los resultados de las pruebas.

  • Un desglose de los resultados de las pruebas por bibliotecas que se probaron en función de las características de los dispositivos (por ejemplo, acceso a recursos locales, shadow, MQTT, etc.).

El GGQ_Result.xml informe está en formato JUnit XML. Puede integrarlo en plataformas de integración/implementación continua como Jenkins, Bamboo, etc. El informe contiene los componentes siguientes:

  • Resumen de agregación de los resultados de pruebas.

  • Desglose de los resultados de las pruebas según la AWS IoT Greengrass funcionalidad que se probó.

Interpretación de los informes de IDT

La sección de informe en awsiotdevicetester_report.xml o awsiotdevicetester_report.xml enumera las pruebas que se ejecutaron y los resultados.

La primera etiqueta XML <testsuites> contiene el resumen de la ejecución de las pruebas. Por ejemplo:

<testsuites name="GGQ results" time="2299" tests="28" failures="0" errors="0" disabled="0">
Atributos que se utilizan en la etiqueta <testsuites>
name

El nombre del grupo de prueba.

time

El tiempo, en segundos, que se ha tardado en ejecutar el conjunto de cualificación.

tests

El número de pruebas ejecutadas.

failures

El número de pruebas que se ejecutaron, pero que no se superaron.

errors

El número de pruebas que IDT no ha podido ejecutar.

disabled

Este atributo no se utiliza y se puede omitir.

El archivo awsiotdevicetester_report.xml contiene una etiqueta <awsproduct> que tiene información sobre el producto que se está probando y las características del producto que se han validado después de ejecutar un conjunto de pruebas.

Atributos que se utilizan en la etiqueta <awsproduct>
name

El nombre del producto que se está probando.

version

La versión del producto que se está probando.

features

Las características validadas. Las características marcadas como required son necesarias para solicitar la cualificación de la placa. En el siguiente fragmento se muestra cómo aparece esta información en el archivo awsiotdevicetester_report.xml.

<feature name="aws-iot-greengrass-no-container" value="supported" type="required"></feature>

Las características marcadas como optional no son necesarias para la cualificación. Los siguientes fragmentos muestran características opcionales:

<feature name="aws-iot-greengrass-container" value="supported" type="optional"></feature>
 <feature name="aws-iot-greengrass-hsi" value="not-supported" type="optional"></feature>

Si no hay fallos en las pruebas ni errores en relación con las funciones requeridas, el dispositivo cumple los requisitos técnicos para funcionar AWS IoT Greengrass y puede interoperar con AWS IoT los servicios. Si quieres incluir tu dispositivo en el catálogo de AWS Partner dispositivos, puedes utilizar este informe como prueba de aptitud.

Si se producen errores en pruebas, puede identificar la prueba fallido revisando las etiquetas XML <testsuites>. Las etiquetas XML <testsuite> dentro de la etiqueta <testsuites> muestran el resumen del resultado de la prueba de un grupo de prueba. Por ejemplo:

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

El formato es similar a la etiqueta <testsuites>, pero con un atributo skipped que no se utiliza y que se puede pasar por alto. Dentro de cada etiqueta XML <testsuite>, hay etiquetas <testcase> para cada prueba ejecutada para un grupo de prueba. Por ejemplo:

<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>>
Atributos que se utilizan en la etiqueta <testcase>
name

El nombre de la prueba.

attempts

El número de veces que IDT ha ejecutado el caso de prueba.

Cuando una prueba genera un error o si se produce un error, las etiquetas <failure> o <error> se agregan a la etiqueta <testcase> con información para la resolución de problemas. Por ejemplo:

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

Visualización de registros

IDT genera registros a partir de la ejecución de pruebas en <devicetester-extract-location>/results/<execution-id>/logs. Se generan dos conjuntos de registros:

test_manager.log

Registros generados a partir del componente Test Manager de AWS IoT Device Tester (por ejemplo, registros relacionados con la configuración, la secuenciación de las pruebas y la generación de informes).

<test_case_id>.log (for example, ota.log)

Son los registros del grupo de pruebas, incluidos los registros del dispositivo bajo prueba. Cuando una prueba devuelve un error, se crea un archivo tar.gz que contiene los registros del dispositivo sometido a prueba para la prueba (por ejemplo, ota_prod_test_1_ggc_logs.tar.gz).

Para obtener más información, consulte IDT para la solución de problemas AWS IoT Greengrass.