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](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
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.
# IDT para AWS IoT Greengrass solución de problemas
IDT for AWS IoT Greengrass escribe estos errores en varias ubicaciones según el tipo de error. Los errores se escriben en la consola, en los archivos de registro y en los informes de prueba.
## Códigos de error
En la siguiente tabla se muestran los códigos de error generados por IDT para AWS IoT Greengrass.
| Código de error | Nombre del código de error | Causa raíz posible | Resolución de problemas |
| --- | --- | --- | --- |
| 101 | InternalError | Se ha producido un error interno. | Compruebe los registros en el directorio `{{}}/results`. Si no puede solucionar el problema, póngase en contacto con [AWS Developer Support](https://aws.amazon.com/premiumsupport/plans/developers/). |
| 102 | TimeoutError | La prueba no se puede completar en un período de tiempo limitado. Esto puede ocurrir si:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 103 | PlatformNotSupportError | Se especificó OS/architecture una combinación incorrecta en`device.json`. | Cambie la configuración a una de las combinaciones admitidas:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html)
Para obtener más información, consulte [Configurar device.json](set-config.md#device-config). |
| 104 | VersionNotSupportError | La versión de software AWS IoT Greengrass principal no es compatible con la versión de IDT que está utilizando. | Utilice el **device\_tester\_bin version** comando para buscar la versión compatible del software AWS IoT Greengrass principal. Por ejemplo, si usa macOS, utilice: **./devicetester\_mac\_x86\_64 version**.
Para encontrar la versión del software AWS IoT Greengrass Core que está utilizando:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html)
Puede probar una versión diferente del software AWS IoT Greengrass Core. Para obtener más información, consulte [Introducción al AWS IoT Greengrass](gg-gs.md). |
| 105 | LanguageNotSupportError | IDT solo admite Python para AWS IoT Greengrass bibliotecas y SDK. | Asegúrese de que:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 106 | ValidationError | Algunos campos en `device.json` o `config.json` no son válidos. | Compruebe el mensaje de error en la parte derecha del código de error del informe. [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 107 | SSHConnectionFailed | La máquina de pruebas no puede conectarse al dispositivo configurado. | Compruebe que los siguientes campos de su archivo `device.json` son correctos:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html)
Para obtener más información, consulte [Configurar device.json](set-config.md#device-config). |
| 108 | RunCommandError | Una prueba no ha podido ejecutar un comando en el dispositivo que se está probando. | Compruebe que se permite el acceso raíz al usuario configurado en `device.json`.
Algunos dispositivos requieren una contraseña cuando se ejecutan comandos con acceso raíz. Asegúrese de que el acceso raíz se conceda sin contraseña. Para obtener más información, consulte la documentación de su dispositivo.
Intente ejecutar manualmente en su dispositivo el comando que ha generado el error y compruebe si también se produce un error. |
| 109 | PermissionDeniedError | No hay acceso raíz. | Establezca el acceso raíz para el usuario configurado en el dispositivo. |
| 110 | CreateFileError | No es posible crear un archivo. | Compruebe el espacio en disco del dispositivo y los permisos de directorio. |
| 111 | CreateDirError | No se puede crear un directorio. | Compruebe el espacio en disco del dispositivo y los permisos de directorio. |
| 112 | InvalidPathError | La ruta al software AWS IoT Greengrass principal es incorrecta. | Compruebe que la ruta del mensaje de error es válida. No edite ningún archivo del directorio `devicetester_greengrass_{{}}`. |
| 113 | InvalidFileError | Un archivo no es válido. | Compruebe que el archivo en el mensaje de error es válido. |
| 114 | ReadFileError | El archivo especificado no se puede leer. | Compruebe lo siguiente:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html)
Si está realizando las pruebas en macOS, aumente el límite de archivos abiertos. El límite predeterminado es 256, que es suficiente para las pruebas. |
| 115 | FileNotFoundError | No se ha encontrado un archivo necesario. | Compruebe lo siguiente:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 116 | OpenFileFailed | No se puede abrir el archivo especificado. | Compruebe lo siguiente:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html)
Si está realizando las pruebas en macOS, aumente el límite de archivos abiertos. El límite predeterminado es 256, que es suficiente para las pruebas. |
| 117 | WriteFileFailed | No se ha podido escribir el archivo (puede ser el DUT o la máquina de pruebas). | Compruebe que existe el directorio especificado en el mensaje de error y que tiene permiso de escritura. |
| 118 | FileCleanUpError | Una prueba no ha podido eliminar el archivo o el directorio especificado, o no pudo desmontar el archivo especificado en el dispositivo remoto. | Si el archivo binario se sigue ejecutando, puede que el archivo esté bloqueado. Detenga el proceso y elimine el archivo especificado. |
| 119 | InvalidInputError | Configuración no válida. | Compruebe que el archivo `suite.json` es válido. |
| 120 | InvalidCredentialError | AWS Credenciales no válidas. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 121 | AWSSessionError | No se pudo crear una AWS sesión. | Este error puede producirse si AWS las credenciales no son válidas o si la conexión a Internet es inestable. Intente utilizarla AWS CLI para llamar a una operación AWS de API. |
| 122 | AWSApiCallError | Se ha producido un error en la AWS API. | Esto puede deberse a un problema de red. Compruebe su red antes de volver a ejecutar el grupo de pruebas. |
| 123 | IpNotExistError | La dirección IP no está incluida en la información de conectividad. | Compruebe la conexión a Internet. Puede usar la AWS IoT Greengrass consola para comprobar la información de conectividad del AWS IoT Greengrass elemento principal que se utiliza en la prueba. Si hay 10 puntos de enlace incluidos en la información de conectividad, puede eliminar algunos o todos ellos y volver a ejecutar la prueba. Para obtener más información, consulte la sección sobre [información de conectividad](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html). |
| 124 | OTAJobNotCompleteError | No se completó un trabajo de OTA. | Compruebe la conexión a Internet y vuelva a ejecutar el grupo de pruebas de OTA. |
| 125 | CreateGreengrassServiceRoleError | Se ha producido alguno de los siguientes errores:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) | Configure el rol AWS IoT Greengrass de servicio. Para obtener más información, consulte [Rol de servicio de Greengrass](service-role.md). |
| 126 | DependenciesNotPresentError | Una o varias dependencias necesarias para la prueba específica no están presentes en el dispositivo. | Compruebe el registro de prueba para ver qué dependencias faltan en su dispositivo: `{{}}/results/{{}}/logs/{{}}` |
| 127 | InvalidHSMConfiguration | La HSM/PKCS configuración proporcionada es incorrecta. | Proporcione la configuración necesaria para interactuar con el HSM utilizando PKCS\#11 en su archivo `device.json`. |
| 128 | OTAJobNotSuccededError | El trabajo de OTA no se ha podido realizar correctamente. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) |
| 129 | NoConnectivityError | Se ha producido un error del agente host al conectar a Internet. | Compruebe la conexión de red y la configuración del firewall. Pruebe de nuevo el grupo de prueba después de que se resuelva el problema de conectividad. |
| 130 | NoPermissionError | El usuario de IAM para el que se ejecuta IDT AWS IoT Greengrass no tiene permiso para crear los AWS recursos necesarios para ejecutar IDT. | Consulte en [Plantilla de política de permisos](https://docs.aws.amazon.com/greengrass/latest/developerguide/policy-template.html) la plantilla que concede los permisos necesarios para ejecutar IDT para AWS IoT Greengrass. |
| 131 | LeftoverAgentExistError | Su dispositivo está ejecutando AWS IoT Greengrass procesos cuando intenta iniciar IDT for. AWS IoT Greengrass | Asegúrese de que no haya ningún demonio de Greengrass ejecutándose en su dispositivo.[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/greengrass/v1/developerguide/idt-troubleshooting.html) Si utiliza una instalación existente o AWS IoT Greengrass está configurada para que se inicie automáticamente tras el reinicio, debe detener el daemon tras el reinicio y antes de ejecutar el conjunto de pruebas. |
| 132 | DeviceTimeOffsetError | El dispositivo tiene la hora incorrecta. | Ajuste el dispositivo a la hora correcta. |
| 133 | InvalidMLConfiguration | La configuración de ML proporcionada es incorrecta. | En el archivo `device.json`, proporcione la configuración correcta necesaria para ejecutar las pruebas de inferencia de ML. Para obtener más información, consulte [Opcional: Configuración del dispositivo para la cualificación ML](idt-ml-qualification.md). |
## Resolver IDT para AWS IoT Greengrass errores
Cuando utilice IDT, debe disponer de los archivos de configuración correctos antes de ejecutar IDT para. AWS IoT Greengrass Si obtiene errores de análisis y de configuración, el primer paso es localizar y utilizar una plantilla de configuración adecuada para su entorno.
Si continúa teniendo problemas, consulte el siguiente proceso de depuración.
**Topics**
+ [¿Dónde puedo buscar los errores?](#where-to-look)
+ [Errores de procesamiento](#parse-error)
+ [Error por ausencia de un parámetro obligatorio](#param-missing)
+ [Error por la imposibilidad de iniciar una prueba](#could-not-start-test)
+ [Error por falta de autorización para acceder a un recurso](#not-authorized-to-access-resource)
+ [Errores de permiso denegado](#pwd-sudo)
+ [Errores de conexión SSH](#ssh-connect-errors)
+ [Errores de tiempo de espera](#test-timeout)
+ [Errores No se encuentra el comando al realizar las pruebas](#cmd-not-found)
+ [Excepción de seguridad en macOS](#macos-notarization-exception)
### ¿Dónde puedo buscar los errores?
High-level los errores se muestran en la consola durante la ejecución y, una vez finalizadas todas las pruebas, se muestra un resumen de las pruebas fallidas con el error. `awsiotdevicetester_report.xml`contiene un resumen de todos los errores que provocaron el error de una prueba. Los archivos de registro de cada ejecución de prueba se almacenan en un directorio determinado con un UUID para la ejecución de pruebas que se muestra en la consola durante la ejecución de la prueba.
El directorio de registros de prueba se encuentra en `{{}}/results/{{}}/logs/`. Este directorio contiene los siguientes archivos que son útiles para la depuración.
| Archivos | Description (Descripción) |
| --- | --- |
| test\_manager.log | Todos los registros escritos en la consola durante la ejecución de las pruebas. Al final de este archivo se encuentra un resumen de los resultados que incluye una lista de las pruebas con errores.
La advertencia y los registros de errores en este archivo pueden proporcionarle información acerca de los errores que se producen. |
| {{}}\_\_{{}}.log | Registros detallados para la prueba específica. |
| {{}}\_ggc\_logs.tar.gz | Una colección comprimida de todos los registros que el daemon AWS IoT Greengrass principal generó durante la prueba. Para más información, consulte [Solución de problemas AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-troubleshooting.html). |
| {{}}\_ota\_logs.tar.gz | Colección comprimida de registros generados por el agente AWS IoT Greengrass OTA durante la prueba. Solo para pruebas OTA. |
| {{}}\_basic\_assertion\_publisher\_ggad\_logs.tar.gz | Colección comprimida de registros generada por el dispositivo del editor de AWS IoT durante la prueba. |
| {{}}\_basic\_assertion\_subscriber\_ggad\_logs.tar.gz | Colección comprimida de registros generados por el dispositivo del suscriptor de AWS IoT durante la prueba. |
### Errores de procesamiento
Ocasionalmente, un error tipográfico en una configuración de JSON puede dar lugar a errores de análisis. En la mayoría de los casos, el problema es resultado de omitir un paréntesis, una coma o unas comillas en el archivo JSON. IDT realiza la validación JSON e imprime información de depuración. Imprime la línea en la que se produjo el error, el número de línea y el número de la columna del error de sintaxis. Esta información debe ser suficiente para ayudarle a solucionar el error, pero si no logra localizar el error, puede realizar una validación manual en su IDE, en un editor de texto como Atom o Sublime, o a través de una herramienta online como JSONLint.
### Error por ausencia de un parámetro obligatorio
Dado que se han añadido nuevas características a IDT, es posible que se hayan introducido cambios en los archivos de configuración. Utilizar un archivo de configuración antiguo podría romper la configuración. Si esto ocurre, el archivo `{{}}.log` en `/results/{{}}/logs` enumera explícitamente todos los parámetros que faltan. IDT también valida los esquemas del archivo de configuración JSON para asegurarse de que se ha utilizado la última versión compatible.
### Error por la imposibilidad de iniciar una prueba
Es posible que encuentre errores que apuntan a errores durante el inicio de la prueba. Existen varias causas posibles, por lo que debe hacer lo siguiente:
+ Asegúrese de que el nombre del grupo que ha incluido en el comando de ejecución existe realmente. Al nombre del grupo se hace referencia directamente desde el archivo `device.json`.
+ Asegúrese de que el dispositivo o dispositivos del grupo tienen parámetros de configuración correctos.
### Error por falta de autorización para acceder a un recurso
Es posible que vea el mensaje de error ` is not authorized to access this resource` en la salida del terminal o en el archivo `test_manager.log` en `/results/{{}}/logs`. Para resolver este problema, asocie la política administrada `AWSIoTDeviceTesterForGreengrassFullAccess` al usuario de prueba. Para obtener más información, consulte [Cree y configure un Cuenta de AWS](dev-tst-prereqs.md#config-aws-account-for-idt).
### Errores de permiso denegado
IDT realiza operaciones en diversos directorios y archivos en un dispositivo que se está probando. Algunas de estas operaciones requieren acceso raíz. Para automatizar estas operaciones, IDT debe ser capaz de ejecutar comandos con sudo sin escribir una contraseña.
Siga estos pasos para permitir acceso sudo sin escribir una contraseña.
**nota**
`user` y `username` hacen referencia al usuario SSH que utiliza IDT para acceder al dispositivo a prueba.
1. Use **sudo usermod -aG sudo {{}}** para añadir el usuario SSH al grupo sudo.
1. Cierre la sesión y, a continuación, vuelva a iniciar sesión para que los cambios surtan efecto.
1. Añada el archivo `/etc/sudoers` y, a continuación, agregue la siguiente línea al final del archivo: `{{}} ALL=(ALL) NOPASSWD: ALL`
**nota**
Le recomendamos que utilice **sudo visudo** al editar `/etc/sudoers`.
### Errores de conexión SSH
Cuando IDT no se puede conectar a un dispositivo a prueba, los errores de conexión se registran en `/results/{{}}/logs/{{}}.log`. Los mensajes de error de SSH aparecen en la parte superior de este archivo de registro ya que la conexión a un dispositivo bajo prueba es una de las primeras operaciones que realiza IDT.
La mayoría de configuraciones de Windows utilizan la aplicación de terminal PuTTy para conectarse a hosts Linux. Esta aplicación requiere que los archivos de clave privada PEM estándar se conviertan en un formato propio de Windows denominado PPK. Cuando IDT está configurado en su archivo `device.json`, utilice solo archivos PEM. Si utiliza un archivo PPK, IDT no puede crear una conexión SSH con el AWS IoT Greengrass dispositivo y no puede ejecutar pruebas.
### Errores de tiempo de espera
Puede aumentar el tiempo de espera de cada prueba especificando un multiplicador de tiempo de espera, que se aplicará al valor predeterminado de cada tiempo de espera de la prueba. Cualquier valor configurado para esta marca debe ser superior o igual a 1,0.
Para utilizar el multiplicador de tiempo de espera, utilice la marca `--timeout-multiplier` al ejecutar las pruebas. Por ejemplo:
```
./devicetester_linux run-suite --suite-id GGQ_1.0.0 --pool-id DevicePool1 --timeout-multiplier 2.5
```
Para obtener más información, ejecute `run-suite --help`.
### Errores No se encuentra el comando al realizar las pruebas
Necesitas una versión anterior de la biblioteca OpenSSL (libssl1.0.0) para ejecutar pruebas en los dispositivos. AWS IoT Greengrass La mayoría de distribuciones de Linux actuales utilizan libssl versión 1.0.2 o posterior (v1.1.0).
Por ejemplo, en una Raspberry Pi, ejecute los siguientes comandos para instalar la versión requerida de 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
```
### Excepción de seguridad en macOS
Cuando ejecuta IDT en una máquina host que usa macOS 10.15, el ticket de certificación notarial de IDT no se detecta correctamente y se bloquea la ejecución de IDT. Para ejecutar IDT, tendrá que conceder una excepción de seguridad al `devicetester_mac_x86-64` ejecutable.
**Para conceder una excepción de seguridad de IDT ejecutable**
1. Abra **Preferencias del sistema** desde el menú de Apple.
1. Seleccione **Seguridad y privacidad**, a continuación, en la pestaña **General**, haga clic en el icono del candado para realizar cambios en la configuración de seguridad.
1. Busque el mensaje `"devicetester_mac_x86-64" was blocked from use because it is not from an identified developer.` y seleccione **Permitir de todos modos** .
1. Acepte la advertencia de seguridad.
Si tiene alguna pregunta acerca de la política de compatibilidad con IDT, póngase en contacto con el [Servicio de atención al cliente de AWS](https://aws.amazon.com/contact-us/).