Débogage des configurations de cycle de vie

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.

Les rubriques suivantes montrent comment obtenir des informations sur vos configurations de cycle de vie et comment les déboguer.

Vérifiez le processus de configuration du cycle de vie à partir CloudWatch des journaux

Les configurations de cycle de vie ne journalisent que STDOUT et STDERR.

STDOUT est la sortie par défaut pour les scripts bash. Vous pouvez écrire dans STDERR ajoutant >&2 à la fin d'une commande bash. Par exemple, echo 'hello'>&2.

Les journaux de vos configurations de cycle de vie vous sont publiés Compte AWS via Amazon CloudWatch. Ces journaux se trouvent dans le flux de /aws/sagemaker/studio journaux de la CloudWatch console.

1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Choisissez Journaux à gauche. Dans le menu déroulant, sélectionnez Groupes de journaux.

3. Sur la page Groupes de journaux, recherchez aws/sagemaker/studio.

4. Sélectionnez le groupe de journaux.

5. Sur la page Informations de groupe de journaux, cliquez sur l'onglet Flux de journaux.

6. Pour trouver les journaux d'une application spécifique, recherchez les flux de journaux en utilisant le format suivant :

   domain-id/user-profile-name/app-type/app-name

   Par exemple, pour trouver les journaux de configuration de cycle de vie pour le domaine d-m85lcu8vbqmz, le profil utilisateur i-sonic-js, le type d'application JupyterServer et le nom d'application test-lcc-echo, utilisez la chaîne de recherche suivante :

   d-m85lcu8vbqmz/i-sonic-js/JupyterServer/test-lcc-echo 

7. Sélectionnez le flux de journal auquel est ajouté LifecycleConfigOnStart pour afficher les journaux d'exécution du script.

JupyterServer échec de l'application

Si votre JupyterServer application se bloque en raison d'un problème lié à la configuration du cycle de vie jointe, Studio Classic affiche le message d'erreur suivant sur l'écran de démarrage de Studio Classic.

Failed to create SageMaker Studio due to start-up script failure

Sélectionnez le View script logs lien pour afficher les CloudWatch journaux de votre JupyterServer application.

Si la configuration du cycle de vie défectueuse est spécifiée dans votre domaine, votre profil utilisateur ou votre espace partagé, Studio Classic continue à utiliser la configuration du cycle de vie même après le redémarrage de Studio Classic. DefaultResourceSpec

Pour résoudre cette erreur, suivez les étapes de la rubrique Définition de configurations de cycle de vie par défaut afin de supprimer le script de configuration de cycle de vie du paramètre DefaultResourceSpec ou sélectionnez un autre script comme script par défaut. Lancez ensuite une nouvelle JupyterServer application.

KernelGateway échec de l'application

Si votre KernelGateway application se bloque en raison d'un problème lié à la configuration du cycle de vie jointe, Studio Classic affiche le message d'erreur dans votre bloc-notes Studio Classic.

Choisissez View script logs d'afficher les CloudWatch journaux de votre KernelGateway application.

Dans ce cas, la configuration de votre cycle de vie est spécifiée dans le lanceur Studio Classic lors du lancement d'un nouveau bloc-notes Studio Classic.

Pour résoudre cette erreur, utilisez le lanceur Studio Classic pour sélectionner une autre configuration de cycle de vie ou sélectionnezNo script.

Note

La configuration KernelGateway du cycle de vie par défaut spécifiée dans DefaultResourceSpec s'applique à toutes les KernelGateway images du domaine, du profil utilisateur ou de l'espace partagé, sauf si l'utilisateur sélectionne un script différent dans la liste présentée dans le lanceur Studio Classic. Le script par défaut s'exécute également si No Script est sélectionné par l'utilisateur. Pour plus d'informations sur la sélection d'un script, veuillez consulter Étape 3 : Lancer une application à l'aide de la configuration de cycle de vie.

Expiration de la configuration de cycle de vie

Le délai d'expiration de la configuration du cycle de vie est limité à 5 minutes. Si l'exécution d'un script de configuration du cycle de vie prend plus de 5 minutes, Studio Classic génère une erreur.

Pour résoudre cette erreur, assurez-vous que votre script de configuration de cycle de vie se termine en moins de 5 minutes.

Pour vous aider à diminuer la durée de l'exécution de scripts, essayez ce qui suit :

• Réduisez les étapes nécessaires. Par exemple, limitez quels environnements conda peuvent installer de grands packages.

• Exécutez les tâches en parallèle.

• Utilisez la commande nohup de votre script pour vous assurer que les signaux de blocage sont ignorés et n'empêchent pas l'exécution du script.