Quantum - Résolution des problèmes
Découvrez comment déboguer vos notebooks
Objectif
Ce tutoriel vous donne quelques pistes pour déboguer vos notebooks en cas de problème.
Prérequis
- Un notebook que vous souhaitez démarrer avec les Quantum Notebooks
- Un conteneur Object Storage dans votre compte OVHcloud
- Un utilisateur Public Cloud disposant du rôle Administrator ou Quantum Operator
En pratique
Qu'est-ce qu'un émulateur de notebook Quantum et comment en lancer un ?
Toutes les étapes permettant de démarrer et de travailler sur les Quantum Notebooks sont décrites dans le guide « Quantum Notebooks - Premiers pas ».
Je ne parviens pas à me connecter à mon notebook
Si vous ne parvenez pas à vous connecter aux Quantum Notebooks, vérifiez les points suivants :
- Votre notebook est démarré et en cours d'exécution : pour vous connecter à votre notebook, celui-ci doit être en statut
RUNNINGouIN SERVICE(couleur verte dans l'espace client OVHcloud). Si votre notebook est en cours de démarrage, patientez quelques instants, le temps que vos données se synchronisent, puis vous pourrez vous y connecter. Le temps de démarrage peut varier selon certains paramètres. Plus vous synchronisez de données, plus l'opération prend de temps. - Vous disposez d'un utilisateur autorisé ou d'un token autorisé : pour pouvoir vous connecter à votre notebook, vous devez avoir créé un utilisateur ou un token. Pour créer un nouvel utilisateur, connectez-vous à l'espace client OVHcloud et ouvrez votre projet Public Cloud. Dans le menu de gauche, cliquez sur la section
Quantum. Cela vous permet de gérer et de créer des utilisateurs Quantum. Pour un simple accès à l'informatique quantique, utilisez le rôleQuantum reader. Pour un usage plus avancé, incluant la gestion, sélectionnez le rôleQuantum operator.
Pour suivre toutes les étapes en détail, reportez-vous à cette documentation.
Je ne parviens pas à installer de paquets via une commande APT
Les Quantum Notebooks ne permettent pas d'utiliser apt-get install, car vous n'êtes pas root. Vous pouvez installer vos différents paquets à l'aide de ces commandes :
1. La commande pip :
2. La commande conda :
- Installer des paquets dans un terminal : ouvrez tout d'abord un nouveau terminal.
Si vous avez choisi l'éditeur Jupyterlab, ouvrez un nouveau terminal : File > New > Terminal.
Si vous avez choisi l'éditeur VScode, ouvrez un nouveau terminal en cliquant sur l'icône de menu > Terminal > New Terminal.
Vous pouvez ensuite exécuter directement dans votre terminal l'une des deux commandes suivantes :
ou
- Installer des paquets directement dans une cellule de notebook : si vous souhaitez installer un paquet directement dans une cellule de notebook, n'oubliez pas de faire précéder votre commande d'un point d'exclamation. Vous pourrez alors installer un paquet avec :
ou
Il reste préférable d'installer ou de désinstaller les paquets dans un terminal, en particulier pour les autorisations. Vous pouvez y autoriser (ou non) l'installation ou la désinstallation des paquets par un oui ou un non. Cela est impossible dans une cellule de notebook.
Je rencontre des problèmes de compatibilité entre les paquets que j'ai installés
Vérifiez la compatibilité entre le framework que vous avez choisi lors du lancement de votre notebook et le paquet que vous avez installé.
Si votre framework n'est pas compatible avec la version du paquet :
- Vous pouvez désinstaller le paquet à l'aide d'une commande
pip uninstall <package_name>ouconda remove <package_name>. Réinstallez ensuite le paquet dans une version compatible avec votre framework. - Sinon, plusieurs versions sont disponibles pour certains frameworks. Choisissez celle qui correspond le mieux à votre projet.
Comment utiliser ma propre image Docker avec les Quantum Notebooks ?
Les Quantum Notebooks ne permettent pas d'utiliser des images Docker personnalisées.
J'ai des doutes sur la facturation des notebooks
Vous ne payez que les ressources que vous utilisez et, le cas échéant, le stockage local. Consultez cette documentation pour des exemples détaillés.
Je ne vois pas mes données synchronisées dans l'Object Storage
Lorsque vous créez un Quantum Notebook, nous copions vos données dans les conteneurs Object Storage attachés, au plus près de vos ressources de calcul (CPU et GPU), afin d'améliorer les performances et de réduire la latence.
Lorsque vous écrivez des données dans un volume attaché, nous attendons l'arrêt du Quantum Notebook pour resynchroniser vos données.
Si vous ne parvenez pas à voir vos données synchronisées, vérifiez les points suivants :
- Votre notebook est arrêté : pour voir vos données synchronisées dans l'Object Storage, votre notebook doit être arrêté au préalable. Le statut de votre notebook doit être « stopped » (de couleur rouge). Si votre notebook est en statut
STOPPING, patientez un peu et vous pourrez voir vos données synchronisées. - Votre conteneur object n'est pas vide : si votre conteneur object est vide, il est possible que vous n'ayez pas enregistré vos données au bon endroit lors de leur utilisation dans votre notebook. Vérifiez la manière dont le volume a été monté au démarrage de votre notebook.
J'ai peut-être atteint les limites de ressources
Chaque service Quantum Notebooks est fourni avec un tableau de bord de monitoring, qui vous permet de suivre de près vos consommations de calcul, de stockage et de réseau.
Pour vérifier vos métriques d'utilisation, accédez à la section Public Cloud de l' et sélectionnez Quantum Notebooks. Tous vos notebooks sont alors listés. Cliquez sur votre notebook pour consulter ses informations. Dans Ressources, vous pouvez ensuite accéder au monitoring de vos ressources via le Graph Dashboard.
Notez que chaque Quantum Notebook est limité à un nombre maximal de CPU et de GPU. Vous pouvez vous reporter au guide Capacités et limites des Quantum Notebooks.
Je constate des lenteurs
Des lenteurs peuvent être constatées dans deux cas principaux : vous exécutez des tâches intensives qui consomment toutes vos ressources, ou il s'agit d'un incident côté OVHcloud.
Dans le premier cas, vous pouvez vous reporter à la question « J'ai peut-être atteint les limites de ressources ».
Dans le second cas, vous pouvez vérifier sur la page OVHcloud status si une opération affecte notre infrastructure.
Si ce n'est pas le cas, contactez notre support.
Puis-je installer un nouvel éditeur de notebook ?
Actuellement, vous pouvez choisir entre trois éditeurs de code en direct pour lancer et modifier votre notebook :
- VSCode
- JupyterLab
- JupyterLab Real Time (environnement collaboratif)
Vous pouvez obtenir la liste des éditeurs disponibles à l'aide de la CLI ovhai, avec la commande suivante : ovhai capabilities editor list
Vous ne pouvez pas installer votre propre éditeur de code sur les Quantum Notebooks.
Quels sont les ports accessibles depuis le réseau public ?
Chaque notebook dispose d'une URL publique. Par défaut, cette URL accède au port 8080 du notebook. Le port par défaut ne peut pas être modifié.
Vous pouvez toutefois accéder à d'autres ports en les ajoutant à l'URL. Par exemple, l'URL du notebook (commençant par l'identifiant du notebook, ici rempli de 0) permettant d'accéder au port 8501 est https://00000000-0000-0000-0000-000000000000-8501.job.gra.ai.cloud.ovh.net/
CLI : mon notebook est en statut "failed"
- Vérifiez que vous disposez de la permission de vous connecter au Public Cloud Object Storage (PCS) : si vous supprimez la permission de connexion au PCS, la synchronisation des données échouera, et le notebook également.
- Vérifiez que vous avez accès aux données du volume que vous tentez de connecter à votre notebook : si vous tentez de vous connecter à un volume (depuis le PCS) sans disposer des droits d'accès, votre notebook passera en statut
failed.
Pour le déboguer vous-même, exécutez la commande suivante dans la CLI :
Vous saurez ainsi si le statut failed est lié à la synchronisation des données et quel volume n'a pas pu être synchronisé.
Pendant combien de temps puis-je utiliser mon notebook Quantum ?
Un notebook Quantum fonctionne en continu jusqu'à son interruption manuelle par l'utilisateur, sauf s'il dépasse 7 jours d'exécution. Il est alors automatiquement arrêté. Vous pouvez choisir de le redémarrer automatiquement grâce à l'option auto-restart (définissez ce paramètre sur True). Le notebook redémarre alors en l'état. Pour augmenter cette limite de 7 jours, vous devez contacter le support afin de demander une augmentation de ce quota pour votre projet Public Cloud.
Mon notebook s'est arrêté de manière inattendue
Bien que nous fassions notre possible pour éviter cette situation, des interruptions de service peuvent survenir, comme pour tout service.
Veuillez ouvrir un ticket auprès de notre support.
Si votre notebook s'est arrêté de manière inattendue, cela peut être dû à un incident sur notre backend. En général, vos données distantes sont en sécurité et seront synchronisées dans le Public Cloud Object Storage.
Votre stockage local éphémère sera perdu.
Aller plus loin
- Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.
Votre avis nous intéresse !
Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.
N’hésitez pas à nous faire part de vos questions, retours et suggestions concernant les Quantum Notebooks :
- Dans le canal #quantum-computing du serveur Discord OVHcloud.