AWS IoT Greengrass Version 1 entró en la fase de vida útil prolongada el 30 de junio de 2023. Para obtener más información, consulte la política de mantenimiento de AWS IoT Greengrass V1 Después de esta fecha, AWS IoT Greengrass V1 no se publicarán actualizaciones que proporcionen funciones, mejoras, correcciones de errores o parches de seguridad. Los dispositivos que se ejecuten AWS IoT Greengrass V1 no se verán afectados y seguirán funcionando y conectándose a la nube. Le recomendamos encarecidamente que migre a AWS IoT Greengrass Version 2, ya que añade importantes funciones nuevas y es compatible con plataformas adicionales.
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>/
El awsiotdevicetester_report.xml es el informe de prueba de cualificación que envía a AWS para mostrar su dispositivo en el AWS Partner de Device Catalog. El informe contiene los componentes siguientes:
-
La versión de IDT.
-
La versión AWS IoT Greengrass que se ha probado.
-
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 informe GGQ_Result.xml está en formato XML JUnit
-
Resumen de agregación de los resultados de pruebas.
-
Desglose de resultados de pruebas por funcionalidad de AWS IoT Greengrass probada.
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
requiredson necesarias para solicitar la cualificación de la placa. En el siguiente fragmento se muestra cómo aparece esta información en el archivoawsiotdevicetester_report.xml.<feature name="aws-iot-greengrass-no-container" value="supported" type="required"></feature>Las características marcadas como
optionalno 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 errores de pruebas para las características requeridas, el dispositivo cumple los requisitos técnicos para ejecutar AWS IoT Greengrass y puede interoperar con servicios de AWS IoT. Si quiere mostrar su dispositivo en el AWS Partner Device Catalog, puede utilizar este informe como prueba de cualificación.
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 añaden 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
test_manager.log-
Registros generados a partir del componente Test Manager de AWS IoT Device Tester (por ejemplo, registros relacionados con la configuración, secuenciación de pruebas y 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 Solución de problemas de IDT para AWS IoT Greengrass.
