AWS IoT Greengrass Version 1 entrou na fase de vida útil prolongada em 30 de junho de 2023. Para obter mais informações, consulte política de manutenção do AWS IoT Greengrass V1. Após essa data, AWS IoT Greengrass V1 não lançaremos atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam AWS IoT Greengrass V1 não serão interrompidos e continuarão operando e se conectando à nuvem. É altamente recomendável que você migre para AWS IoT Greengrass Version 2, o que adiciona novos recursos significativos e suporte para plataformas adicionais.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Noções básicas de resultados e logs
Esta seção descreve como visualizar e interpretar os resultados de relatórios e logs do IDT.
Visualização de resultados
Enquanto em execução, o IDT grava erros no console, arquivos de log e relatórios de teste. Depois de concluir o conjunto de testes de qualificação, o IDT gera dois relatórios de teste. Esses relatórios podem ser encontrados em <device-tester-extract-location>/results/<execution-id>/
O awsiotdevicetester_report.xml é o relatório de teste de qualificação que você envia para a AWS para listar o dispositivo no Device Catalog da AWS Partner. O relatório contém os seguintes elementos:
-
A versão IDT.
-
A versão do AWS IoT Greengrass que foi testada.
-
A SKU e o nome de grupo do dispositivo especificados no arquivo
device.json. -
Os atributos do grupo do dispositivo especificados no arquivo
device.json. -
O resumo agregado dos resultados de teste.
-
Um detalhamento dos resultados de teste pelas bibliotecas que foram testadas, com base nos atributos do dispositivo (por exemplo, acesso de recurso local, shadow, MQTT e assim por diante).
O relatório GGQ_Result.xml está no formato JUnit XML
-
Um resumo agregado dos resultados de teste.
-
Detalhamento dos resultados do teste pela funcionalidade do AWS IoT Greengrass que foi testada.
Interpretando os relatórios do IDT
A seção de relatório em awsiotdevicetester_report.xml ou awsiotdevicetester_report.xml lista os testes que foram executados e os resultados.
A primeira tag XML <testsuites> contém o resumo da execução do teste. Por exemplo:
<testsuites name="GGQ results" time="2299" tests="28" failures="0" errors="0" disabled="0">recursos usados na tag <testsuites>
name-
O nome do conjunto de testes.
time-
O tempo, em segundos, necessário para executar o conjunto de qualificação.
tests-
O número de testes executados.
failures-
O número de testes que foram executados, mas não foram aprovados.
errors-
O número de testes que não puderam ser executados pelo IDT.
disabled-
Esse recurso não é usado e pode ser ignorado.
O arquivo awsiotdevicetester_report.xml contém uma tag <awsproduct> com informações sobre o produto que está sendo testado e os atributos do produto que foram validados após a execução de um pacote de testes.
recursos usados na tag <awsproduct>
name-
O nome do produto testado.
version-
A versão do produto testado.
features-
Os atributos validados. Atributos marcados como
requiredsão necessários para enviar sua placa para qualificação. O trecho a seguir mostra como essas informações aparecem no arquivoawsiotdevicetester_report.xml.<feature name="aws-iot-greengrass-no-container" value="supported" type="required"></feature>Os atributos marcados como
optionalnão são necessários para qualificação. Os seguintes trechos mostram atributos opcionais.<feature name="aws-iot-greengrass-container" value="supported" type="optional"></feature> <feature name="aws-iot-greengrass-hsi" value="not-supported" type="optional"></feature>
Se não há falhas de teste ou erros nos atributos exigidos, isso significa que o dispositivo atende aos requisitos técnicos para executar o AWS IoT Greengrass e pode interoperar com serviços do AWS IoT. Se você quiser listar o dispositivo no Device Catalog da AWS Partner, poderá usar esse relatório como evidência de qualificação.
Se houver falhas de teste ou erros, você poderá identificar o teste com falha analisando as tags XML <testsuites>. As tags XML <testsuite> dentro da tag <testsuites> mostram o resumo do resultado do teste para um grupo de testes. Por exemplo:
<testsuite name="combination" package="" tests="1" failures="0" time="161" disabled="0" errors="0" skipped="0">O formato é semelhante à tag <testsuites>, mas com um recurso skipped que não é usado e pode ser ignorado. Dentro de cada tag XML <testsuite>, há tags <testcase> para cada teste executado para um grupo de testes. Por exemplo:
<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>>recursos usados na tag <testcase>
name-
O nome do teste.
attempts-
O número de vezes que o IDT executou o caso de teste.
Quando um teste falha ou ocorre um erro, as tags <failure> ou <error> são adicionadas à tag <testcase> com informações para a solução de problemas. Por exemplo:
<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>Visualizar logs
O IDT gera logs de teste em execução em <devicetester-extract-location>/results/<execution-id>/logs
test_manager.log-
Logs gerados a partir do componente Test Manager do AWS IoT Device Tester (por exemplo, logs relacionados à configuração, sequenciamento de teste e geração de relatórios).
<test_case_id>.log (for example, ota.log)-
Os logs do grupo de testes, incluindo logs do dispositivo em teste. Quando um teste falhar, um arquivo tar.gz com os logs do dispositivo em teste para o teste será criado (por exemplo,
ota_prod_test_1_ggc_logs.tar.gz).
Para ter mais informações, consulte Solução de problemas do IDT para AWS IoT Greengrass.
