Résolution des problèmes liés à Amazon SageMaker Studio Classic

Important

Depuis le 30 novembre 2023, l'expérience Amazon SageMaker Studio précédente s'appelle désormais Amazon SageMaker Studio Classic. La section suivante est spécifique à l'utilisation de l'application Studio Classic. Pour plus d'informations sur l'utilisation de l'expérience Studio mise à jour, consultezAmazon SageMaker Studio.

Important

Les IAM politiques personnalisées qui autorisent Amazon SageMaker Studio ou Amazon SageMaker Studio Classic à créer des SageMaker ressources Amazon doivent également accorder des autorisations pour ajouter des balises à ces ressources. L'autorisation d'ajouter des balises aux ressources est requise car Studio et Studio Classic balisent automatiquement toutes les ressources qu'ils créent. Si une IAM politique autorise Studio et Studio Classic à créer des ressources mais n'autorise pas le balisage, des erreurs « AccessDenied » peuvent se produire lors de la tentative de création de ressources. Pour de plus amples informations, veuillez consulter Fournir des autorisations pour le balisage des ressources SageMaker.

AWS Politiques gérées pour Amazon SageMakerqui donnent des autorisations pour créer des SageMaker ressources incluent déjà des autorisations pour ajouter des balises lors de la création de ces ressources.

Cette rubrique explique comment résoudre les problèmes courants liés à Amazon SageMaker Studio Classic lors de la configuration et de l'utilisation. Les erreurs suivantes peuvent se produire fréquemment lors de l'utilisation d'Amazon SageMaker Studio Classic. Chaque erreur est suivie de sa solution.

Problèmes liés à l'application Studio Classic

Les problèmes suivants se produisent lors du lancement et de l'utilisation de l'application Studio Classic.

• L'écran ne se charge pas : vider l'espace de travail et attendre n'aide pas

  Lors du lancement de l'application Studio Classic, une fenêtre contextuelle affiche le message suivant. Quelle que soit l'option sélectionnée, Studio Classic ne se charge pas.

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

  Le lancement de l'application Studio Classic peut être retardé si plusieurs onglets sont ouverts dans l'espace de travail Studio Classic ou si plusieurs fichiers se trouvent sur AmazonEFS. Cette fenêtre contextuelle devrait disparaître quelques secondes après que l'espace de travail de Studio Classic soit prêt.

  Si vous continuez à voir un écran de chargement avec un spinner après avoir sélectionné l'une des options, des problèmes de connectivité peuvent survenir avec l'Amazon Virtual Private Cloud utilisé par Studio Classic. 

  Pour résoudre les problèmes de connectivité liés à l'Amazon Virtual Private Cloud (AmazonVPC) utilisé par Studio Classic, vérifiez les configurations réseau suivantes :

  • Si votre domaine est configuré en VpcOnly mode : vérifiez qu'il existe un point de VPC terminaison Amazon ou une NAT passerelle pour le trafic sortant, y compris le trafic sur Internet. AWS STS Pour cela, suivez les étapes de Connectez les blocs-notes Studio dans un VPC à des ressources externes.

  • Si votre Amazon VPC est configuré avec une configuration personnalisée DNS au lieu de celle DNS fournie par Amazon : vérifiez que les itinéraires sont configurés à l'aide du protocole Dynamic Host Configuration Protocol (DHCP) pour chaque point de VPC terminaison Amazon ajouté à l'Amazon VPC utilisé par Studio Classic. Pour plus d'informations sur la définition des ensembles d'DHCPoptions par défaut et personnalisés, consultez les ensembles d'DHCPoptions sur Amazon VPC.

• Défaillance interne lors du lancement de Studio Classic

  Lorsque vous lancez Studio Classic, vous ne pouvez pas afficher l'interface utilisateur de Studio Classic. Vous voyez également une erreur similaire à la suivante et Défaillance interne apparaît dans les détails de l'erreur.

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

  Cette erreur peut être due à plusieurs facteurs. Si l'exécution de ces étapes ne permet pas de résoudre votre problème, créez-en un avec https://aws.amazon.com/premiumsupport/. 

  • Cible de EFS montage Amazon manquante : Studio Classic utilise Amazon EFS pour le stockage. Le EFS volume Amazon a besoin d'une cible de montage pour chaque sous-réseau dans lequel le SageMaker domaine Amazon est créé. Si cette cible de EFS montage Amazon est supprimée accidentellement, l'application Studio Classic ne peut pas se charger car elle ne peut pas monter le répertoire de fichiers de l'utilisateur. Pour résoudre ce problème, procédez comme suit.

    Pour vérifier ou créer des cibles de montage.

    1. Trouvez le EFS volume Amazon associé au domaine à l'aide de l'DescribeDomainAPIappel. 

    2. Connectez-vous à la EFS console Amazon AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/efs/.

    3. Dans la liste des EFS volumes Amazon, sélectionnez le EFS volume Amazon associé au domaine.

    4. Sur la page de EFS détails d'Amazon, sélectionnez l'onglet Réseau. Vérifiez qu'il existe des cibles de montage pour tous les sous-réseaux dans lesquels le domaine est configuré.

    5. Si des cibles de montage sont manquantes, ajoutez les cibles de EFS montage Amazon manquantes. Pour obtenir des instructions, consultez Création et gestion de cibles de montage et de groupes de sécurité (langue française non garantie).

    6. Une fois les cibles de montage manquantes créées, lancez l'application Studio Classic.

  • Fichiers en conflit dans le .local dossier de l'utilisateur : si vous utilisez la JupyterLab version 1 sur Studio Classic, les bibliothèques conflictuelles de votre .local dossier peuvent entraîner des problèmes lors du lancement de l'application Studio Classic. Pour résoudre ce problème, mettez à jour la JupyterLab version par défaut de votre profil utilisateur vers la version JupyterLab 3.0. Pour plus d'informations sur l'affichage et la mise à jour de la JupyterLab version, consultezJupyterLab Versionnage.

• ConfigurationError: LifecycleConfig lors du lancement de Studio Classic

  Vous ne pouvez pas afficher l'interface utilisateur de Studio Classic lorsque vous lancez Studio Classic. Cette erreur est due à des problèmes liés au script de configuration de cycle de vie par défaut attaché au domaine.

  Pour résoudre les problèmes liés à la configuration de cycle de vie

  1. Consultez les Amazon CloudWatch Logs pour connaître la configuration du cycle de vie afin de retrouver la commande à l'origine de l'échec. Pour consulter le journal, suivez les étapes de la rubrique Vérifiez le processus de configuration du cycle de vie à partir CloudWatch des journaux.

  2. Détachez le script par défaut du profil utilisateur ou du domaine. Pour de plus amples informations, veuillez consulter Mise à jour et détachement de configurations de cycle de vie.

  3. Lancez l'application Studio Classic.

  4. Déboguez votre script de configuration de cycle de vie. Vous pouvez exécuter le script de configuration de cycle de vie à partir du terminal système pour résoudre les problèmes. Lorsque le script s'exécute correctement à partir du terminal, vous pouvez l'attacher au profil utilisateur ou au domaine.

• SageMaker Les fonctionnalités principales de Studio Classic ne sont pas disponibles.

  Si ce message d'erreur s'affiche lors de l'ouverture de Studio Classic, cela peut être dû à un conflit de version du package Python. Cela se produit si vous avez utilisé les commandes suivantes dans un bloc-notes ou un terminal pour installer des packages Python présentant des conflits de version avec des dépendances de SageMaker packages.

  !pip install

  pip install --user

  Pour résoudre ce problème, procédez comme suit :

  1. Désinstallez les packages Python récemment installés. Si vous ne savez pas quel package désinstaller, créez un problème avec https://aws.amazon.com/premiumsupport/. 

  2. Redémarrez Studio Classic :

     1. Arrêtez Studio Classic depuis le menu Fichier.

     2. Attendez une minute.

     3. Rouvrez Studio Classic en actualisant la page ou en l'ouvrant depuis le AWS Management Console.

  Le problème doit être résolu si vous avez désinstallé le package à l'origine du conflit. Pour installer des packages sans provoquer à nouveau ce problème, utilisez %pip install sans l'indicateur --user.

  Si le problème persiste, créez un profil utilisateur et configurez votre environnement avec ce profil utilisateur.

  Si ces solutions ne résolvent pas le problème, créez-en un avec https://aws.amazon.com/premiumsupport/. 

• Impossible d'ouvrir Studio Classic à partir du AWS Management Console.

  Si vous ne parvenez pas à ouvrir Studio Classic ni à créer une nouvelle instance en cours d'exécution avec tous les paramètres par défaut, créez un problème avec https://aws.amazon.com/premiumsupport/. 

KernelGateway problèmes liés à l'application

Les problèmes suivants sont spécifiques aux KernelGateway applications lancées dans Studio Classic.

• Impossible d'accéder à la session Kernel

  Lorsque l'utilisateur lance un nouveau bloc-notes, il ne parvient pas à se connecter à la session du bloc-notes. Si le statut de l' KernelGateway application est le In Service même, vous pouvez vérifier les points suivants pour résoudre le problème.

  • Vérifier les configurations de groupe de sécurité

    Si le domaine est configuré en VPCOnly mode, le groupe de sécurité associé au domaine doit autoriser le trafic entre les ports situés dans la plage 8192-65535 de connectivité entre les KernelGateway applications JupyterServer et.

    Pour vérifier les règles de groupe de sécurité

    1. Obtenez les groupes de sécurité associés au domaine à l'aide de l'DescribeDomainAPIappel.

    2. Connectez-vous à la VPC console Amazon AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/vpc/.

    3. Dans le panneau de navigation de gauche, sous Sécurité, choisissez Groupes de sécurité.

    4. Filtrez en fonction IDs des groupes de sécurité associés au domaine.

    5. Pour chaque groupe de sécurité :

       1. Sélectionnez le groupe de sécurité.

       2. Sur la page des détails du groupe de sécurité, consultez les règles entrantes. Vérifiez que le trafic est autorisé entre les ports compris dans la plage 8192-65535.

    Pour plus d'informations sur les règles de groupe de sécurité, consultez Contrôler le trafic vers vos ressources AWS à l'aide de groupes de sécurité. Pour plus d'informations sur les conditions requises pour utiliser Studio Classic en VPCOnly mode, consultezConnectez les blocs-notes Studio dans un VPC à des ressources externes.

  • Vérifiez le pare-feu et WebSocket les connexions

    Si les KernelGateway applications ont un InService statut et que l'utilisateur ne parvient pas à se connecter à la session du bloc-notes Studio Classic, vérifiez le pare-feu et WebSocket les paramètres.

    1. Lancez l'application Studio Classic. Pour de plus amples informations, veuillez consulter Lancez Amazon SageMaker Studio Classic.

    2. Ouvrez les outils de développement de votre navigateur Web.

    3. Choisissez l'onglet Network (Réseau).

    4. Recherchez une entrée correspondant au format suivant.

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

       Si le code d'état ou de réponse de l'entrée est autre que101, vos paramètres réseau empêchent la connexion entre l'application Studio Classic et les KernelGateway applications.

       Pour résoudre ce problème, contactez l'équipe qui gère vos paramètres réseau afin d'autoriser la mise en liste de Studio Classic URL et d'activer WebSocket les connexions. 

• Impossible de lancer une application en raison du dépassement des quotas de ressources

  Lorsqu'un utilisateur essaie de lancer un nouveau bloc-notes, la création du bloc-notes échoue avec l'une des erreurs suivantes. Cette erreur est due au dépassement des quotas de ressources.

  • 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 prend en charge jusqu'à quatre KernelGateway applications en cours d'exécution sur la même instance. Pour résoudre ce problème, vous pouvez procéder de l'une des manières suivantes :

    • Supprimez une KernelGateway application existante exécutée sur l'instance, puis redémarrez le nouveau bloc-notes.

    • Démarrez le nouveau bloc-notes sur un autre type d'instance.

    Pour de plus amples informations, veuillez consulter Modifier un type d'instance.

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

    Dans ce cas, le compte ne dispose pas de limites suffisantes pour créer une application Studio Classic sur le type d'instance spécifié. Pour résoudre ce problème, accédez à la Service Quotas console à l'adresse https://console.aws.amazon.com/servicequotas/. Dans cette console, demandez à augmenter la limite Studio KernelGateway Apps running on instance-type instance. Pour de plus amples informations, veuillez consulter les Service Quotas AWS.