Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). 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á. # IDT para AWS IoT Greengrass solução de problemas O IDT para AWS IoT Greengrass gravar esses erros em vários locais com base no tipo de erro. Os erros são gravados no console, arquivos de log e relatórios de teste. ## Códigos de erro A tabela a seguir lista os códigos de erro gerados pelo IDT para AWS IoT Greengrass. | Código de erro | Nome do código de erro | Possível causa raiz | Solução de problemas | | --- | --- | --- | --- | | 101 | InternalError | Ocorreu um erro interno. | Verifique os logs no diretório `{{}}/results`. Se você não conseguir depurar o problema, entre em contato com o [Suporte ao desenvolvedor da AWS](https://aws.amazon.com/premiumsupport/plans/developers/). | | 102 | TimeoutError | O teste não pode ser concluído em um período limitado. Isso poderá acontecer se:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) | | 103 | PlatformNotSupportError | OS/architecture Combinação incorreta especificada em`device.json`. | Alterar sua configuração para uma das combinações compatíveis:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html)
Para obter mais informações, consulte [Configurar device.json](set-config.md#device-config). | | 104 | VersionNotSupportError | A versão do software AWS IoT Greengrass Core não é compatível com a versão do IDT que você está usando. | Use o **device\_tester\_bin version** comando para encontrar a versão compatível do software AWS IoT Greengrass Core. Por exemplo, se você estiver usando macOS, use: **./devicetester\_mac\_x86\_64 version**.
Para encontrar a versão do software AWS IoT Greengrass Core que você está usando:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html)
Você pode testar uma versão diferente do software AWS IoT Greengrass Core. Para obter mais informações, consulte [Conceitos básicos de AWS IoT Greengrass](gg-gs.md). | | 105 | LanguageNotSupportError | O IDT oferece suporte a Python somente AWS IoT Greengrass para bibliotecas e SDKs. | Certifique-se de que:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) | | 106 | ValidationError | Alguns campos em `device.json` ou `config.json` são inválidos. | Verifique a mensagem de erro no lado direito do código de erro no relatório. [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) | | 107 | SSHConnectionFailed | O computador de teste não pode se conectar ao dispositivo configurado. | Verifique se os campos a seguir do arquivo `device.json` estão corretos:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html)
Para obter mais informações, consulte [Configurar device.json](set-config.md#device-config). | | 108 | RunCommandError | O teste não conseguiu executar um comando no dispositivo em teste. | Verifique se o acesso raiz ao usuário configurado em `device.json` é permitido.
Uma senha é exigida por alguns dispositivos ao executar comandos com acesso raiz. Verifique se o acesso raiz é permitido sem uma senha. Para obter mais informações, consulte a documentação do seu dispositivo.
Tente executar o comando com falha manualmente no dispositivo e verifique se ocorre um erro. | | 109 | PermissionDeniedError | Sem acesso raiz. | Defina o acesso raiz do usuário configurado no seu dispositivo. | | 110 | CreateFileError | Não é possível criar um arquivo. | Verifique o espaço em disco do dispositivo e as permissões do diretório. | | 111 | CreateDirError | Não é possível criar um diretório. | Verifique o espaço em disco do dispositivo e as permissões do diretório. | | 112 | InvalidPathError | O caminho para o software AWS IoT Greengrass principal está incorreto. | Verifique se o caminho na mensagem de erro é válido. Não edite os arquivos do diretório `devicetester_greengrass_{{}}`. | | 113 | InvalidFileError | Um arquivo é inválido. | Verifique se o arquivo na mensagem de erro é válido. | | 114 | ReadFileError | Não é possível ler o arquivo especificado. | Verifique o seguinte:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html)
Se você estiver testando em um macOS, aumente o limite de arquivos abertos. O limite padrão é 256, que é o suficiente para testes. | | 115 | FileNotFoundError | Um arquivo necessário não foi encontrado. | Verifique o seguinte:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) | | 116 | OpenFileFailed | Não foi possível abrir o arquivo especificado. | Verifique o seguinte:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html)
Se você estiver testando em um macOS, aumente o limite de arquivos abertos. O limite padrão é 256, que é o suficiente para testes. | | 117 | WriteFileFailed | Falha ao gravar arquivo (pode ser o DUT ou computador de teste). | Verifique se o diretório especificado na mensagem de erro existe e se você tem permissão de gravação. | | 118 | FileCleanUpError | O teste não conseguir remover o arquivo especificado ou diretório nem desmontar o arquivo especificado no dispositivo remoto. | Se o arquivo binário ainda estiver em execução, ele poderá ser bloqueado. Termine o processo e exclua o arquivo especificado. | | 119 | InvalidInputError | Configuração inválida. | Verifique se o arquivo `suite.json` é válido. | | 120 | InvalidCredentialError | AWS Credenciais inválidas. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) | | 121 | AWSSessionError | Falha ao criar uma AWS sessão. | Esse erro pode ocorrer se AWS as credenciais forem inválidas ou se a conexão com a Internet estiver instável. Tente usar o AWS CLI para chamar uma operação de AWS API. | | 122 | AWSApiCallError | Ocorreu um erro de AWS API. | Esse erro pode ser devido a um problema de rede. Verifique sua rede antes de repetir o grupo de testes. | | 123 | IpNotExistError | O endereço IP não está incluído nas informações de conectividade. | Verifique a conexão com a Internet. Você pode usar o AWS IoT Greengrass console para verificar as informações de conectividade do item AWS IoT Greengrass principal que está sendo usado pelo teste. Se houver 10 endpoints incluídos nas informações de conectividade, você poderá remover alguns ou todos e executar o teste novamente. Para obter mais informações, consulte [Informações de conectividade](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html). | | 124 | OTAJobNotCompleteError | Um OTA de trabalho não foi concluído. | Verifique sua conexão com a Internet e tente o grupo de testes OTA novamente. | | 125 | CreateGreengrassServiceRoleError | Houve um dos problemas a seguir:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) | Configure a função AWS IoT Greengrass de serviço. Para obter mais informações, consulte [Função de serviço do Greengrass](service-role.md). | | 126 | DependenciesNotPresentError | Uma ou mais dependências necessárias para o teste específico não estão presentes no dispositivo. | Verifique o log de teste para ver quais dependências estão ausentes no dispositivo: `{{}}/results/{{}}/logs/{{}}`. | | 127 | InvalidHSMConfiguration | A HSM/PKCS configuração fornecida está incorreta. | No arquivo `device.json`, forneça a configuração correta necessária para interagir com o HSM usando PKCS\#11. | | 128 | OTAJobNotSuccededError | A tarefa OTA não foi bem-sucedida. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) | | 129 | NoConnectivityError | O atendente de host não consegue se conectar à Internet. | Verifique suas configurações de conexão de rede e firewall. Tente novamente o grupo de testes depois que o problema de conectividade for resolvido. | | 130 | NoPermissionError | O usuário do IAM para o qual você está usando para executar o IDT AWS IoT Greengrass não tem permissão para criar os AWS recursos necessários para executar o IDT. | Consulte [Modelo de política de permissões](https://docs.aws.amazon.com/greengrass/latest/developerguide/policy-template.html) para obter o modelo de política que concede as permissões necessárias para executar o IDT para AWS IoT Greengrass. | | 131 | LeftoverAgentExistError | Seu dispositivo está executando AWS IoT Greengrass processos quando você tenta iniciar o IDT para AWS IoT Greengrass. | Verifique se não há nenhum daemon do Greengrass em execução no dispositivo.[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v1/developerguide/idt-troubleshooting.html) Se você estiver usando uma instalação existente ou AWS IoT Greengrass configurada para iniciar automaticamente após a reinicialização, deverá interromper o daemon após a reinicialização e antes de executar a suíte de testes. | | 132 | DeviceTimeOffsetError | O dispositivo tem o horário incorreto. | Defina o horário incorreto no seu dispositivo. | | 133 | InvalidMLConfiguration | A configuração de fornecida está incorreta. | No arquivo `device.json`, forneça a configuração correta necessária para executar testes de inferência de ML. Para obter mais informações, consulte [Opcional: configurar o dispositivo para qualificação de ML](idt-ml-qualification.md). | ## Resolvendo o IDT para AWS IoT Greengrass erros Ao usar o IDT, você deve instalar os arquivos de configuração corretos antes de executar o IDT for. AWS IoT Greengrass Se você estiver recebendo erros de análise e configuração, o primeiro passo é localizar e usar um modelo de configuração apropriado para seu ambiente. Se você ainda estiver com problemas, consulte o processo de depuração a seguir. **Topics** + [Onde eu procuro erros?](#where-to-look) + [Erros de análise](#parse-error) + [Erro de parâmetro necessário ausente](#param-missing) + [Erro: Não foi possível iniciar teste](#could-not-start-test) + [Erro de não autorização para acessar um recurso](#not-authorized-to-access-resource) + [Erros de permissão negada](#pwd-sudo) + [Erros de conexão SSH](#ssh-connect-errors) + [Erros de tempo limite](#test-timeout) + [Erros de comando não encontrados durante o teste](#cmd-not-found) + [Exceção de segurança no macOS](#macos-notarization-exception) ### Onde eu procuro erros? High-level os erros são exibidos no console durante a execução, e um resumo dos testes que falharam com o erro é exibido quando todos os testes são concluídos. `awsiotdevicetester_report.xml`contém um resumo de todos os erros que causaram a falha de um teste. Os arquivos de log para cada execução de teste são armazenados em um diretório nomeado com um UUID para a execução de teste que foi exibida no console durante a execução de teste. O diretório dos logs de teste está localizado em `{{}}/results/{{}}/logs/`. Esse diretório contém os seguintes arquivos que são úteis para depuração. | Arquivo | Description | | --- | --- | | test\_manager.log | Todos os logs que foram gravados no console durante a execução do teste. Um resumo dos resultados está localizado no final deste arquivo que inclui uma lista de quais testes falharam.
Os logs de aviso e de erro nesse arquivo podem fornecer algumas informações sobre as falhas. | | {{}}\_\_{{}}.log | Logs detalhados para o teste específico. | | {{}}\_ggc\_logs.tar.gz | Uma coleção compactada de todos os registros que o daemon AWS IoT Greengrass principal gerou durante o teste. Para obter mais informações, consulte [Solução de problemas AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-troubleshooting.html). | | {{}}\_ota\_logs.tar.gz | Uma coleção compactada de registros gerados pelo agente AWS IoT Greengrass OTA durante o teste. Somente para testes OTA. | | {{}}\_basic\_assertion\_publisher\_ggad\_logs.tar.gz | Um conjunto de logs gerados pelo dispositivo editor do AWS IoT durante o teste. | | {{}}\_basic\_assertion\_subscriber\_ggad\_logs.tar.gz | Um conjunto de logs gerados pelo dispositivo assinante do AWS IoT durante o teste. | ### Erros de análise Ocasionalmente, um erro ortográfico em uma configuração JSON pode resultar em erros de análise. Na maioria dos casos, o problema é resultado da omissão de um colchete, vírgula ou aspas de seu arquivo JSON. O IDT executa a validação do JSON e imprime as informações de depuração. Ele imprime a linha em que ocorreu o erro, o número da linha e o número da coluna do erro de sintaxe. Essas informações devem ser suficientes para ajudá-lo a corrigir o erro, mas se você ainda não conseguir localizar o erro, poderá executar a validação manualmente no IDE, em um editor de texto como o Atom ou o Sublime, ou por meio de uma ferramenta online, como a JSONLint. ### Erro de parâmetro necessário ausente Como novos atributos estão sendo adicionados ao IDT, os arquivos de configuração podem sofrer alterações. O uso de um arquivo de configuração antigo pode danificar sua configuração. Se isso acontecer, o arquivo `{{}}.log`, em `/results/{{}}/logs`, listará explicitamente todos os parâmetros ausentes. O IDT também valida os esquemas do arquivo de configuração JSON para garantir que a versão compatível mais recente tenha sido usada. ### Erro: Não foi possível iniciar teste Você pode encontrar erros que apontam para falhas ao iniciar o teste. Há várias causas possíveis e, portanto, faça o seguinte: + Verifique se o nome do grupo incluído no comando de execução realmente existe. O nome do grupo é referenciado diretamente em seu arquivo `device.json`. + Verifique se os dispositivos no grupo têm os parâmetros de configuração corretos. ### Erro de não autorização para acessar um recurso Você pode ver a mensagem de erro ` is not authorized to access this resource` na saída do terminal ou no arquivo `test_manager.log` em `/results/{{}}/logs`. Para resolver este problema, anexe a política gerenciada `AWSIoTDeviceTesterForGreengrassFullAccess` ao usuário de teste. Para obter mais informações, consulte [Crie e configure um Conta da AWS](dev-tst-prereqs.md#config-aws-account-for-idt). ### Erros de permissão negada O ITD executa operações em vários diretórios e arquivos em um dispositivo em teste. Algumas dessas operações exigem acesso raiz. Para automatizar essas operações, o IDT deverá ser capaz de executar comandos com sudo sem digitar uma senha. Siga estas etapas para permitir o acesso do sudo sem digitar uma senha. **nota** `user` e `username` se referem ao usuário SSH usado pelo IDT para acessar o dispositivo em teste. 1. Use **sudo usermod -aG sudo {{}}** para adicionar o usuário SSH ao grupo sudo. 1. Saia e faça login para que as alterações entrem em vigor. 1. Abra o arquivo `/etc/sudoers` e adicione a linha a seguir ao final do arquivo: `{{}} ALL=(ALL) NOPASSWD: ALL` **nota** Como prática recomendada, recomendamos que você use **sudo visudo** ao editar `/etc/sudoers`. ### Erros de conexão SSH Quando o IDT não puder se conectar a um dispositivo em teste, as falhas de conexão serão registradas em log em `/results/{{}}/logs/{{}}.log`. As mensagens de falha de SSH aparecem na parte superior desse arquivo de log, pois a conexão com um dispositivo em teste é uma das primeiras operações executadas pelo IDT. A maioria das configurações do Windows usa o aplicativo de terminal PuTTy para se conectar a hosts Linux. Esse aplicativo requer que os arquivos de chave privada PEM padrão sejam convertidos em um formato Windows proprietário chamado PPK. Quando IDT estiver configurado em seu arquivo `device.json`, use apenas os arquivos PEM. Se você usar um arquivo PPK, o IDT não poderá criar uma conexão SSH com o AWS IoT Greengrass dispositivo e não poderá executar testes. ### Erros de tempo limite Você pode aumentar o tempo limite para cada teste especificando um multiplicador de tempo limite, que será aplicado ao valor padrão de cada tempo limite do teste. Qualquer valor configurado para esse sinalizador deve ser maior que ou igual a 1.0. Para usar o multiplicador de tempo limite, use o sinalizador `--timeout-multiplier` ao executar os testes. Por exemplo: ``` ./devicetester_linux run-suite --suite-id GGQ_1.0.0 --pool-id DevicePool1 --timeout-multiplier 2.5 ``` Para obter mais informações, execute `run-suite --help`. ### Erros de comando não encontrados durante o teste Você precisa de uma versão mais antiga da biblioteca OpenSSL (libssl1.0.0) para executar testes em dispositivos. AWS IoT Greengrass A maioria das distribuições atuais do Linux usa o libssl versão 1.0.2 ou posterior (v1.1.0). Por exemplo, em um Raspberry Pi, execute os seguintes comandos para instalar a versão necessária do libssl: 1. ``` wget http://ftp.us.debian.org/debian/pool/main/o/openssl/libssl1.0.0_1.0.2l-1~bpo8+1_armhf.deb ``` 1. ``` sudo dpkg -i libssl1.0.0_1.0.2l-1~bpo8+1_armhf.deb ``` ### Exceção de segurança no macOS Quando você executa o IDT em uma máquina host que usa o macOS 10.15, o tíquete de reconhecimento de firma do IDT não é detectado corretamente e o IDT é impedido de ser executado. Para executar o IDT, você precisará conceder uma exceção de segurança ao executável `devicetester_mac_x86-64`. **Para conceder uma exceção de segurança ao executável do IDT** 1. Inicie as **Preferências do Sistema** no menu Apple. 1. Selecione **Segurança e privacidade** e, em seguida, na guia **Geral**, clique no ícone de cadeado para fazer alterações nas configurações de segurança. 1. Procure a mensagem `"devicetester_mac_x86-64" was blocked from use because it is not from an identified developer.` e, em seguida selecione **Permitir mesmo assim**. 1. Aceite o aviso de segurança. Se você tiver dúvidas sobre a política de suporte do IDT, entre em contato com o [Suporte ao cliente da AWS](https://aws.amazon.com/contact-us/).