Fehlerbehebung bei Amazon SageMaker Studio Classic

Wichtig

Ab dem 30. November 2023 heißt die vorherige Amazon SageMaker Studio-Erfahrung jetzt Amazon SageMaker Studio Classic. Der folgende Abschnitt bezieht sich speziell auf die Verwendung der Studio Classic-Anwendung. Informationen zur Verwendung der aktualisierten Studio-Umgebung finden Sie unter Amazon SageMaker Studio.

In diesem Thema wird beschrieben, wie Sie häufig auftretende Probleme mit Amazon SageMaker Studio Classic während der Einrichtung und Verwendung beheben. Im Folgenden sind häufige Fehler aufgeführt, die bei der Verwendung von Amazon SageMaker Studio Classic auftreten können. Auf jeden Fehler folgt eine Lösung.

Probleme mit Studio Classic-Anwendungen

Die folgenden Probleme treten beim Starten und Verwenden der Studio Classic-Anwendung auf.

• Der Bildschirm wird nicht geladen: Den Workspace löschen und warten hilft nicht

  Beim Starten der Studio Classic-Anwendung wird in einem Popup-Fenster die folgende Meldung angezeigt. Unabhängig davon, welche Option ausgewählt ist, wird Studio Classic nicht geladen.

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

  Die Studio-Classic-Anwendung kann eine Startverzögerung haben, wenn mehrere Registerkarten im Studio-Classic-Workspace geöffnet sind oder sich mehrere Dateien in Amazon EFS befinden. Dieses Popup-Fenster sollte innerhalb weniger Sekunden, nachdem der Studio Classic Workspace fertig ist, verschwinden.

  Wenn Sie nach Auswahl einer der Optionen weiterhin einen Ladebildschirm mit einem Sprenner sehen, kann es zu Verbindungsproblemen mit der von Studio Classic verwendeten Amazon Virtual Private Cloud kommen. 

  Um Verbindungsprobleme mit der von Studio Classic verwendeten Amazon Virtual Private Cloud (Amazon VPC) zu beheben, überprüfen Sie die folgenden Netzwerkkonfigurationen:

  • Wenn Ihre Domain im VpcOnly Modus eingerichtet ist: Stellen Sie sicher, dass ein Amazon VPC-Endpunkt für AWS STS oder ein NAT-Gateway für ausgehenden Datenverkehr, einschließlich Verkehr über das Internet, vorhanden ist. Befolgen Sie dafür die unter Studio SageMaker Classic Notebooks in einer VPC mit externen Ressourcen verbinden beschriebenen Schritte.

  • Wenn Ihre Amazon VPC mit einem benutzerdefinierten DNS statt mit dem von Amazon bereitgestellten DNS eingerichtet ist: Stellen Sie sicher, dass die Routen mit Dynamic Host Configuration Protocol (DHCP) für jeden Amazon-VPC-Endpunkt konfiguriert sind, der der von Studio Classic verwendeten Amazon VPC hinzugefügt wird. Weitere Informationen zur Einstellung standardmäßiger und benutzerdefinierter DHCP-Optionssätze finden Sie unter DHCP-Optionssätze in Amazon VPC.

• Interner Fehler beim Starten von Studio Classic

  Beim Starten von Studio Classic können Sie die Studio Classic-Benutzeroberfläche nicht anzeigen. Außerdem wird ein Fehler ähnlich dem folgenden angezeigt, wobei Interner Fehler das Fehlerdetail ist.

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

  Dieser Fehler kann durch mehrere Faktoren verursacht werden. Wenn das Problem durch Abschluss dieser Schritte nicht behoben wird, erstellen Sie ein Problem mit https://aws.amazon.com/premiumsupport/. 

  • Fehlendes Amazon-EFS-Mounting-Ziel: Studio Classic verwendet Amazon EFS für die Speicherung. Das Amazon-EFS-Volume benötigt ein Mount-Ziel für jedes Subnetz, in dem die Amazon SageMaker-Domäne erstellt wird. Wenn dieses Amazon-EFS-Mountingziel versehentlich gelöscht wird, kann die Studio-Classic-Anwendung nicht geladen werden, da sie das Dateiverzeichnis des Benutzers nicht mounten kann. Führen Sie die folgenden Schritte aus, um dieses Problem zu beheben.

    Um Mount-Ziele zu überprüfen oder zu erstellen.

    1. Suchen Sie das Amazon-EFS-Volume, das der Domain zugeordnet ist, mithilfe desDescribeDomain API-Aufrufs. 

    2. Melden Sie sich bei AWS Management Console an und öffnen Sie die Amazon-SES-Konsole unter https://console.aws.amazon.com/efs/.

    3. Wählen Sie aus der Liste der Amazon EFS-Volumes das Amazon EFS-Volume aus, das der Domain zugeordnet ist.

    4. Wählen Sie auf der Amazon EFS-Detailseite die Registerkarte Netzwerk aus. Stellen Sie sicher, dass Mount-Ziele für alle Subnetze vorhanden sind, in denen die Domain eingerichtet ist.

    5. Wenn Mount-Ziele fehlen, fügen Sie die fehlenden Amazon EFS-Mount-Ziele hinzu. Anweisungen finden Sie unter Mount-Ziele und Sicherheitsgruppen erstellen und verwalten.

    6. Nachdem die fehlenden Mount-Ziele erstellt wurden, starten Sie die Studio Classic-Anwendung.

  • widersprüchliche Dateien im .localOrdner des Benutzers: Wenn Sie Version 1 in Studio Classic verwenden JupyterLab, können widersprüchliche Bibliotheken in Ihrem .localOrdner Probleme beim Starten der Studio Classic-Anwendung verursachen. Um dies zu beheben, aktualisieren Sie die JupyterLab Standardversion Ihres Benutzerprofils auf JupyterLab 3.0. Weitere Informationen zum Anzeigen und Aktualisieren der JupyterLab Version finden Sie unter JupyterLab Versioning.

• ConfigurationError: LifecycleConfig beim Starten von Studio Classic

  Sie können die Studio Classic-Benutzeroberfläche nicht anzeigen, wenn Sie Studio Classic starten. Dies wird durch Probleme mit dem standardmäßigen Lifecycle-Konfigurationsskript verursacht, das an die Domain angehängt ist.

  Um Probleme mit der Lebenszykluskonfiguration zu lösen

  1. Zeigen Sie die Amazon CloudWatch Logs für die Lebenszykluskonfiguration an, um den Befehl zu verfolgen, der den Fehler verursacht hat. Um das Protokoll einzusehen, folgen Sie den Schritten unter Überprüfen des Lebenszykluskonfigurationsprozesses von - CloudWatch Protokollen.

  2. Trennen Sie das Standardskript vom Benutzerprofil oder der Domäne. Weitere Informationen finden Sie unter Lebenszykluskonfigurationen aktualisieren und trennen.

  3. Starten Sie die Studio Classic-Anwendung.

  4. Debuggen Sie Ihr Lifecycle-Konfigurationsskript. Sie können das Lebenszyklus-Konfigurationsskript vom Systemterminal aus ausführen, um Fehler zu beheben. Wenn das Skript erfolgreich vom Terminal aus ausgeführt wird, können Sie das Skript an das Benutzerprofil oder die Domäne anhängen.

• SageMaker Die Kernfunktionen von Studio Classic sind nicht verfügbar.

  Wenn Sie diese Fehlermeldung beim Öffnen von Studio Classic erhalten, kann dies auf Python-Paketversionskonflikte zurückzuführen sein. Dies tritt auf, wenn Sie die folgenden Befehle in einem Notebook oder Terminal verwendet haben, um Python-Pakete zu installieren, bei denen Versionskonflikte mit SageMaker Paketabhängigkeiten auftreten.

  !pip install

  pip install --user

  Führen Sie die folgenden Schritte aus, um dieses Problem zu beheben:

  1. Deinstallieren Sie kürzlich installierte Python-Pakete. Wenn Sie sich nicht sicher sind, welches Paket Sie deinstallieren sollen, erstellen Sie ein Problem mit https://aws.amazon.com/premiumsupport/. 

  2. Studio Classic neu starten:

     1. Fahren Sie Studio Classic über das Menü Datei herunter.

     2. Warten Sie eine Minute.

     3. Öffnen Sie Studio Classic erneut, indem Sie die Seite aktualisieren oder über die öffnenAWS Management Console.

  Das Problem sollte behoben sein, wenn Sie das Paket deinstalliert haben, das den Konflikt verursacht hat. Um Pakete zu installieren, ohne dieses Problem erneut zu verursachen, verwenden Sie %pip install ohne die --user Flagge.

  Wenn das Problem weiterhin besteht, erstellen Sie ein neues Benutzerprofil und richten Sie Ihre Umgebung mit diesem Benutzerprofil ein.

  Wenn diese Lösungen das Problem nicht beheben, erstellen Sie ein Problem mit https://aws.amazon.com/premiumsupport/. 

• Studio Classic kann nicht über die geöffnet werdenAWS Management Console.

  Wenn Sie Studio Classic nicht öffnen können und keine neue laufende Instance mit allen Standardeinstellungen erstellen können, erstellen Sie ein Problem mit https://aws.amazon.com/premiumsupport/. 

KernelGateway Anwendungsprobleme

Die folgenden Probleme gelten speziell für KernelGateway Anwendungen, die in Studio Classic gestartet werden.

• Auf die Kernel-Sitzung kann nicht zugegriffen werden

  Wenn der Benutzer ein neues Notebook startet, kann er keine Verbindung zur Notebook-Sitzung herstellen. Wenn der Status der KernelGateway Anwendung lautetIn Service, können Sie Folgendes überprüfen, um das Problem zu beheben.

  • Überprüfen Sie die Konfigurationen der Sicherheitsgruppen

    Wenn die Domäne im -VPCOnlyModus eingerichtet ist, muss die mit der Domäne verknüpfte Sicherheitsgruppe Datenverkehr zwischen den Ports im -Bereich 8192-65535zulassen, um Verbindungen zwischen den KernelGateway Apps JupyterServer und herzustellen.

    So überprüfen Sie die Sicherheitsgruppenregeln

    1. Rufen Sie mithilfe des DescribeDomain API-Aufrufs die mit der Domain verknüpften Sicherheitsgruppen ab.

    2. Melden Sie sich an der AWS Management Console an und öffnen Sie die Amazon-VPC-Konsole unter https://console.aws.amazon.com/vpc/.

    3. Wählen Sie in der Navigationsleiste unter Sicherheit die Option Sicherheitsgruppen aus.

    4. Filtern Sie nach den IDs der Sicherheitsgruppen, die mit der Domäne verbunden sind.

    5. Für jede Sicherheitsgruppe:

       1. Wählen Sie die Sicherheitsgruppe aus.

       2. Sehen Sie sich auf der Seite mit den Sicherheitsgruppendetails die Regeln für eingehende Nachrichten an. Stellen Sie sicher, dass Datenverkehr zwischen den Ports im Bereich 8192-65535 zulässig ist.

    Weitere Informationen zu Sicherheitsgruppenregeln finden Sie unter Steuern des Datenverkehrs zu Ressourcen mithilfe von Sicherheitsgruppen. Weitere Informationen zu den Anforderungen für die Verwendung von Studio Classic im -VPCOnlyModus finden Sie unter Studio SageMaker Classic Notebooks in einer VPC mit externen Ressourcen verbinden.

  • Überprüfen der Firewall und WebSocket der Verbindungen

    Wenn die KernelGateway Apps den InService Status haben und der Benutzer keine Verbindung zur Studio Classic-Notebook-Sitzung herstellen kann, überprüfen Sie die Firewall und die WebSocket Einstellungen.

    1. Starten Sie die Studio Classic-Anwendung. Weitere Informationen finden Sie unter Starten von Amazon SageMaker Studio Classic.

    2. Öffnen Sie die Entwicklertools Ihres Web-Browsers.

    3. Wählen Sie die Registerkarte Network (Netzwerk) aus.

    4. Suchen Sie nach einem Eintrag, der dem folgenden Format entspricht.

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

       Wenn der Status- oder Antwortcode für den Eintrag etwas anderes als ist101, verhindern Ihre Netzwerkeinstellungen die Verbindung zwischen der Studio Classic-Anwendung und den KernelGateway Apps.

       Um dieses Problem zu beheben, wenden Sie sich an das Team, das Ihre Netzwerkeinstellungen verwaltet, um die Studio Classic-URL aufzulisten und WebSocket Verbindungen zu aktivieren. 

• Eine App konnte aufgrund einer Überschreitung der Ressourcenkontingente nicht gestartet werden

  Wenn ein Benutzer versucht, ein neues Notebook zu starten, schlägt die Erstellung des Notebooks mit einem der folgenden Fehler fehl. Dies wird durch die Überschreitung von Ressourcenkontingenten verursacht.

  • 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 unterstützt bis zu vier laufende KernelGateway Apps auf derselben Instance. Um dieses Problem zu lösen, können Sie eine der folgenden Möglichkeiten nutzen:

    • Löschen Sie eine vorhandene KernelGateway Anwendung, die auf der Instance ausgeführt wird, und starten Sie dann das neue Notebook neu.

    • Starten Sie das neue Notebook auf einem anderen Instance-Typ

    Weitere Informationen finden Sie unter Ändern eines Instance-Typs.

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

    In diesem Fall verfügt das Konto nicht über ausreichende Limits, um eine Studio Classic-Anwendung auf dem angegebenen Instance-Typ zu erstellen. Um dieses Problem zu beheben, navigieren Sie zur Service Quotas Konsole unter https://console.aws.amazon.com/servicequotas/. Fordern Sie in dieser Konsole an, das Studio KernelGateway Apps running on instance-type instance Limit zu erhöhen. Weitere Informationen finden Sie unter AWS-Servicekontingente.