Solución de problemas de Amazon SageMaker Studio Classic - Amazon SageMaker AI
Problemas de aplicaciones de Studio ClassicProblemas de aplicaciones de KernelGateway

Solución de problemas de Amazon SageMaker Studio Classic

importante

A partir del 30 de noviembre de 2023, la experiencia anterior de Amazon SageMaker Studio pasa a denominarse Amazon SageMaker Studio Classic. La siguiente sección es específica del uso de la aplicación de Studio Classic. Para obtener información sobre el uso de la experiencia de Studio actualizada, consulte Amazon SageMaker Studio.

importante

Las políticas de IAM personalizadas que permiten a Amazon SageMaker Studio o Amazon SageMaker Studio Classic crear recursos de Amazon SageMaker también deben conceder permisos para añadir etiquetas a dichos recursos. El permiso para añadir etiquetas a los recursos es necesario porque Studio y Studio Classic etiquetan automáticamente todos los recursos que crean. Si una política de IAM permite a Studio y Studio Classic crear recursos, pero no permite el etiquetado, se pueden producir errores AccessDenied al intentar crear recursos. Para obtener más información, consulte Concesión de permisos para etiquetar recursos de SageMaker AI.

Las Políticas administradas por AWS para Amazon SageMaker AI que conceden permisos para crear recursos de SageMaker ya incluyen permisos para añadir etiquetas al crear esos recursos.

En este tema se describe cómo solucionar problemas comunes de Amazon SageMaker Studio Classic durante la configuración y el uso. A continuación aparecen errores comunes que pueden producirse al utilizar Amazon SageMaker Studio Classic. Cada error va seguido de una solución.

Problemas de aplicaciones de Studio Classic

Se producen los siguientes problemas al iniciar y utilizar la aplicación de Studio Classic.

  • La pantalla no se carga: limpiar el espacio de trabajo y esperar no ayuda

    Al iniciar la aplicación de Studio Classic, aparece el siguiente mensaje en una ventana emergente. No importa qué opción esté seleccionada, Studio Classic no se carga. 

    Loading...
The loading screen is taking a long time. Would you like to clear the workspace or keep waiting?

    La aplicación de Studio Classic puede iniciarse con retraso si hay varias pestañas abiertas en el espacio de trabajo de Studio Classic o si hay varios archivos en Amazon EFS. Esta ventana emergente debería desaparecer unos segundos después de que el espacio de trabajo de Studio Classic esté listo.

    Si sigue viendo una pantalla de carga con una rueda giratoria después de seleccionar cualquiera de las opciones, es posible que haya problemas de conectividad con la Amazon Virtual Private Cloud que utiliza Studio Classic. 

    Para resolver problemas de conectividad con la Amazon Virtual Private Cloud (Amazon VPC) que utiliza Studio Classic, compruebe las siguientes configuraciones de red:

    • Si su dominio está configurado en el modo VpcOnly: compruebe que haya un punto de conexión de Amazon VPC para AWS STS, o una puerta de enlace NAT para el tráfico saliente, incluido el tráfico a través de Internet. Para ello, siga los pasos que se indican en Conexión de cuadernos de Studio en una VPC a recursos externos.

    • Si su Amazon VPC está configurada con un DNS personalizado en lugar del DNS proporcionado por Amazon: compruebe que las rutas estén configuradas mediante el protocolo de configuración dinámica de host (DHCP) para cada punto de conexión de Amazon VPC añadido a la Amazon VPC utilizada por Studio Classic. Para obtener más información sobre la configuración de conjuntos de opciones de DHCP predeterminados y personalizados, consulte Conjuntos de opciones de DHCP en Amazon VPC.

  • Fallo interno al iniciar Studio Classic

    Al iniciar Studio Classic, no puede ver la interfaz de usuario de Studio Classic. También aparece un error similar al siguiente, con un fallo interno como detalle del error. 

    Amazon SageMaker Studio
The JupyterServer app default encountered a problem and was stopped.

    Este error puede deberse a varios factores. Si al completar estos pasos no se resuelve el problema, cree una incidencia en https://aws.amazon.com/premiumsupport/. 

    • Falta el objetivo de montaje de Amazon EFS: Studio Classic utiliza Amazon EFS como almacenamiento. El volumen de Amazon EFS necesita un destino de montaje para cada subred en la que se cree el dominio de Amazon SageMaker AI. Si este destino de montaje de Amazon EFS se elimina accidentalmente, la aplicación de Studio Classic no se puede cargar porque no puede montar el directorio de archivos del usuario. Para resolver este problema, siga estos pasos.

      Para verificar o crear objetivos de montaje.

      1. Busque el volumen de Amazon EFS asociado al dominio mediante la llamada a la API DescribeDomain. 

      2. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon EFS en https://console.aws.amazon.com/efs/.

      3. En la lista de volúmenes de Amazon EFS, seleccione el volumen de Amazon EFS asociado al dominio.

      4. En la página de detalles de Amazon EFS, seleccione la pestaña Red. Compruebe que haya destinos de montaje para todas las subredes en las que está configurado el dominio.

      5. Si faltan objetivos de montaje, agregue los objetivos de montaje de Amazon EFS que falten. Para obtener instrucciones, consulte Creación y administración de objetivos de montaje y grupos de seguridad.

      6. Una vez creados los objetivos de montaje que falten, inicie la aplicación de Studio Classic.

    • Archivos conflictivos en la carpeta .local del usuario: si utiliza la versión 1 de JupyterLab en Studio Classic, las bibliotecas conflictivas de su carpeta .local pueden provocar problemas al iniciar la aplicación de Studio Classic. Para solucionarlo, actualice la versión de JupyterLab predeterminada de su perfil de usuario a JupyterLab 3.0. Para obtener más información acerca de cómo ver y actualizar la versión de JupyterLab, consulte Control de versiones de JupyterLab en Amazon SageMaker Studio Classic.

  • Error de configuración: LifecycleConfig al iniciar Studio Classic

    No puede ver la interfaz de usuario de Studio Classic al iniciar Studio Classic. Esto se debe a problemas con el script de configuración del ciclo de vida predeterminado asociado al dominio.

    Para resolver problemas de configuración del ciclo de vida

    1. Consulte los registros de Amazon CloudWatch para ver la configuración del ciclo de vida y rastrear el comando que provocó el error. Para ver el registro, siga los pasos que se indican en Verificación del proceso de configuración del ciclo de vida desde los registros de CloudWatch.

    2. Desasocie el script predeterminado del perfil de usuario o del dominio. Para obtener más información, consulte Actualización y desasociación de las configuraciones del ciclo de vida en Amazon SageMaker Studio Classic.

    3. Inicialice la aplicación de Studio Classic.

    4. Depure el script de configuración del ciclo de vida. Puede ejecutar el script de configuración del ciclo de vida desde el terminal del sistema para solucionar el problema. Cuando el script se ejecute correctamente desde el terminal, puede asociarlo al perfil de usuario o al dominio.

  • Las funcionalidades principales de SageMaker Studio Classic no están disponibles.

    Si aparece este mensaje de error al abrir Studio Classic, puede deberse a conflictos de versión del paquete de Python. Esto ocurre si ha utilizado los siguientes comandos en un cuaderno o terminal para instalar paquetes de Python que tienen conflictos de versión con las dependencias de paquetes de SageMaker AI.

    !pip install
    pip install --user

    Para resolver este problema, siga estos pasos:

    1. Desinstale los paquetes de Python instalados recientemente. Si no tiene claro qué paquete desinstalar, cree una incidencia en https://aws.amazon.com/premiumsupport/. 

    2. Reinicie Studio Classic:

      1. Cierre Studio Classic desde el menú Archivo.

      2. Espere un minuto.

      3. Vuelva a abrir Studio Classic actualizando la página o abriéndola desde la Consola de administración de AWS.

    El problema debería resolverse si ha desinstalado el paquete que causó el conflicto. Para instalar paquetes sin volver a causar este problema, utilice %pip install sin el marcado --user.

    Si el problema persiste, cree un nuevo perfil de usuario y configure su entorno con ese perfil de usuario.

    Si estas soluciones no arreglan el problema, cree una incidencia en https://aws.amazon.com/premiumsupport/. 

  • No se puede abrir Studio Classic desde la Consola de administración de AWS.

    Si no puede abrir Studio Classic y no puede crear una nueva instancia en ejecución con todos los ajustes predeterminados, cree una incidencia en https://aws.amazon.com/premiumsupport/. 

Problemas de aplicaciones de KernelGateway

Los siguientes problemas son específicos de las aplicaciones de KernelGateway que se inicializan en Studio Classic.

  • No se puede acceder a la sesión del kernel

    Cuando el usuario inicia un nuevo cuaderno, no puede conectarse a la sesión del cuaderno. Si el estado de la aplicación de KernelGateway es In Service, puede comprobar lo siguiente para resolver el problema.

    • Compruebe las configuraciones de los grupos de seguridad

      Si el dominio está configurado en el modo VPCOnly, el grupo de seguridad asociado al dominio debe permitir el tráfico entre los puertos del rango 8192-65535 para la conectividad entre las aplicaciones de JupyterServer y KernelGateway.

      Para verificar las reglas del grupo de seguridad

      1. Obtenga los grupos de seguridad asociados al dominio mediante la llamada a la API DescribeDomain.

      2. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon VPC en https://console.aws.amazon.com/vpc/.

      3. En el panel de navegación izquierdo, en Seguridad, elija Grupos de seguridad.

      4. Filtre por los ID de los grupos de seguridad asociados al dominio.

      5. Para cada grupo de seguridad:

        1. Seleccione el grupo de seguridad .

        2. En la página de detalles del grupo de seguridad, consulte las Reglas de entrada. Compruebe que el tráfico esté permitido entre los puertos del rango 8192-65535.

      Para obtener más información sobre los grupos de seguridad, consulte Control del tráfico hacia los recursos mediante grupos de seguridad. Para obtener más información sobre los requisitos para usar Studio Classic en el modo VPCOnly, consulte Conexión de cuadernos de Studio en una VPC a recursos externos.

    • Verificación de las conexiones del firewall y WebSocket

      Si las aplicaciones de KernelGateway tienen un estado InService y el usuario no puede conectarse a la sesión del cuaderno de Studio Classic, compruebe la configuración del firewall y de WebSocket.

      1. Inicialice la aplicación de Studio Classic. Para obtener más información, consulte Iniciar Amazon SageMaker Studio Classic.

      2. Abra las herramientas para desarrolladores del navegador web.

      3. Seleccione la pestaña Red.

      4. Busque una entrada que coincida con el siguiente formato.

        wss://<domain-id>.studio.<region>.sagemaker.aws/jupyter/default/api/kernels/<unique-code>/channels?session_id=<unique-code>

        Si el código de estado o de respuesta de la entrada es distinto de 101, la configuración de la red impide la conexión entre la aplicación de Studio Classic y las aplicaciones de KernelGateway.

        Para resolver este problema, póngase en contacto con el equipo que administre su configuración de red para incluir como permitida la URL de Studio Classic y habilitar las conexiones de WebSocket. 

  • No se pudo iniciar una aplicación debido a que se superaron las cuotas de recursos

    Cuando un usuario intenta iniciar un nuevo cuaderno, la creación del cuaderno falla y se produce uno de los siguientes errores. Esto se debe a que se superan las cuotas de recursos. 

    • Unable to start more Apps of AppType [KernelGateway] and ResourceSpec(instanceType=[]) for UserProfile []. Please delete an App with a matching AppType and ResourceSpec, then try again

      Studio Classic admite hasta cuatro aplicaciones de KernelGateway en ejecución en la misma instancia. Para resolver este problema, puede optar por una de las siguientes medidas:

      • Eliminar una aplicación de KernelGateway existente que se esté ejecutando en la instancia y, a continuación, reiniciar el nuevo cuaderno.

      • Iniciar el nuevo cuaderno en un tipo de instancia diferente

      Para obtener más información, consulte Cambio del tipo de instancia para un cuaderno de Amazon SageMaker Studio Classic.

    • An error occurred (ResourceLimitExceeded) when calling the CreateApp operation

      En este caso, la cuenta no tiene límites suficientes para crear una aplicación de Studio Classic en el tipo de instancia especificado. Para resolver este problema, vaya a la consola de Service Quotas en https://console.aws.amazon.com/servicequotas/. En esa consola, solicite un aumento del límite Studio KernelGateway Apps running on instance-type instance. Para más información, consulte Service Quotas de AWS.