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 trata específicamente sobre el uso de la aplicación Studio Classic. Para obtener información sobre el uso de la experiencia de Studio actualizada, consulteAmazon SageMaker Studio.

importante

IAMLas políticas personalizadas que permiten a Amazon SageMaker Studio o Amazon SageMaker Studio Classic crear SageMaker recursos de Amazon también deben conceder permisos para añadir etiquetas a esos recursos. El permiso para añadir etiquetas a los recursos es obligatorio porque Studio y Studio Classic etiquetan automáticamente los recursos que crean. Si una IAM política 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 Proporciona permisos para etiquetar SageMaker los recursos.

AWS Políticas gestionadas para Amazon SageMakerque otorgan permisos para crear SageMaker recursos 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. Los siguientes son errores comunes que pueden producirse al usar Amazon SageMaker Studio Classic. Cada error va seguido de una solución.

Problemas con la aplicación Studio Classic

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

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

  Al iniciar la aplicación 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 Studio Classic puede tener un retraso en el lanzamiento si hay varias pestañas abiertas en el espacio de trabajo de Studio Classic o si hay varios archivos en AmazonEFS. 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 utilizada por Studio Classic. 

  Para resolver los problemas de conectividad con la Amazon Virtual Private Cloud (AmazonVPC) utilizada por Studio Classic, compruebe las siguientes configuraciones de red:

  • Si tu dominio está configurado en VpcOnly modo: verifica que haya un VPC punto de enlace de Amazon para AWS STS, o una NAT puerta de enlace para el tráfico saliente, incluido el tráfico a través de Internet. Para ello, siga los pasos que se indican en Conecte los blocs de notas de Studio VPC a recursos externos.

  • Si su Amazon VPC está configurado con un Amazon personalizado DNS 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 VPC punto de conexión de Amazon añadido al Amazon VPC utilizado por Studio Classic. Para obtener más información sobre la configuración de conjuntos de DHCP opciones predeterminados y personalizados, consulta los conjuntos de DHCP opciones 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 un problema con https://aws.amazon.com/premiumsupport/. 

  • Falta el objetivo de EFS montaje de Amazon: Studio Classic usa Amazon EFS como almacenamiento. El EFS volumen de Amazon necesita un objetivo de montaje para cada subred en la que se cree el SageMaker dominio de Amazon. Si este destino de EFS montaje de Amazon se elimina accidentalmente, la aplicación 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. Busca el EFS volumen de Amazon asociado al dominio mediante la DescribeDomainAPIllamada. 

    2. Inicia sesión en el AWS Management Console y abre la EFS consola de Amazon en https://console.aws.amazon.com/efs/.

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

    4. En la página de EFS detalles de Amazon, selecciona 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 montura, añade los objetivos de EFS montura de Amazon que faltan. 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 faltan, inicie la aplicación Studio Classic.

  • Archivos conflictivos en la .local carpeta del usuario: si utilizas la JupyterLab versión 1 de Studio Classic, las bibliotecas conflictivas de tu .local carpeta pueden provocar problemas al iniciar la aplicación Studio Classic. Para solucionar este problema, actualiza la JupyterLab versión predeterminada de tu perfil de usuario a JupyterLab la 3.0. Para obtener más información sobre cómo ver y actualizar la JupyterLab versión, consulteJupyterLab Control de versiones.

• ConfigurationError: LifecycleConfig al iniciar Studio Classic

  No puedes 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 CloudWatch registros de Amazon para ver la configuración del ciclo de vida para rastrear el comando que provocó el error. Para ver el registro, siga los pasos que se indican en Verifique el proceso de configuración del ciclo de vida desde CloudWatch los registros.

  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 configuraciones del ciclo de vida.

  3. Inicie la aplicación 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.

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

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

  !pip install

  pip install --user

  Para resolver este problema, siga estos pasos:

  1. Desinstale los paquetes de Python instalados recientemente. Si no estás seguro de qué paquete desinstalar, crea un problema con https://aws.amazon.com/premiumsupport/ él. 

  2. Reinicie Studio Classic:

     1. Cierre Studio Classic desde el menú Archivo.

     2. Espere un minuto.

     3. Vuelva a abrir Studio Classic refrescando la página o abriéndola desde AWS Management Console.

  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 solucionan el problema, cree un problema con https://aws.amazon.com/premiumsupport/. 

• No se puede abrir Studio Classic desde AWS Management Console.

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

KernelGateway problemas de aplicación

Los siguientes problemas son específicos de las KernelGateway aplicaciones que se inician 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 KernelGateway aplicación esIn Service, puede comprobar lo siguiente para resolver el problema.

  • Compruebe las configuraciones de los grupos de seguridad

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

    Para verificar las reglas del grupo de seguridad

    1. Obtenga los grupos de seguridad asociados al dominio mediante la DescribeDomainAPIllamada.

    2. Inicie sesión en AWS Management Console y abre la VPC consola de Amazon en https://console.aws.amazon.com/vpc/.

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

    4. Filtra por IDs los grupos de seguridad que están 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 VPCOnly el modo, consulteConecte los blocs de notas de Studio VPC a recursos externos.

  • Compruebe el firewall y WebSocket las conexiones

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

    1. Inicie la aplicación Studio Classic. Para obtener más información, consulte Inicie 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 estado o el código de respuesta de la entrada no es el 101 siguiente: la configuración de la red impide la conexión entre la aplicación Studio Classic y las KernelGateway aplicaciones.

       Para resolver este problema, ponte en contacto con el equipo que gestiona la configuración de red para permitir la lista de Studio Classic URL y habilitar WebSocket las conexiones. 

• 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 KernelGateway aplicaciones en ejecución en la misma instancia. Para resolver este problema, puede optar por una de las siguientes medidas:

    • Elimine una KernelGateway aplicación existente que se esté ejecutando en la instancia y, a continuación, reinicie el nuevo bloc de notas.

    • Iniciar el nuevo cuaderno en un tipo de instancia diferente

    Para obtener más información, consulte Cambiar un tipo de instancia.

  • 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, navegue hasta la Service Quotas consola 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 obtener más información, consulte AWS cuotas de servicio.