Problembehebung bei Amazon SageMaker Studio Classic

Wichtig

Seit dem 30. November 2023 heißt das vorherige Amazon SageMaker Studio-Erlebnis jetzt Amazon SageMaker Studio Classic. Der folgende Abschnitt bezieht sich speziell auf die Verwendung der Studio Classic-Anwendung. Informationen zur Verwendung der aktualisierten Studio-Oberfläche finden Sie unterAmazon SageMaker Studio.

Wichtig

Benutzerdefinierte IAM Richtlinien, die es Amazon SageMaker Studio oder Amazon SageMaker Studio Classic ermöglichen, SageMaker Amazon-Ressourcen zu erstellen, müssen auch Berechtigungen zum Hinzufügen von Tags zu diesen Ressourcen gewähren. Die Berechtigung zum Hinzufügen von Tags zu Ressourcen ist erforderlich, da Studio und Studio Classic automatisch alle von ihnen erstellten Ressourcen taggen. Wenn eine IAM Richtlinie Studio und Studio Classic das Erstellen von Ressourcen, aber kein Taggen erlaubt, können "AccessDenied" Fehler auftreten, wenn versucht wird, Ressourcen zu erstellen. Weitere Informationen finden Sie unter Stellen Sie Berechtigungen für das Taggen von Ressourcen SageMaker bereit.

AWS Verwaltete Richtlinien für Amazon SageMakerdie Berechtigungen zum Erstellen von SageMaker Ressourcen gewähren, beinhalten bereits Berechtigungen zum Hinzufügen von Tags beim Erstellen dieser Ressourcen.

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

Probleme mit der Studio Classic-Anwendung

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, Studio Classic wird nicht geladen.

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

  Bei der Studio Classic-Anwendung kann es zu einer Verzögerung beim Start kommen, wenn mehrere Tabs im Studio Classic-Arbeitsbereich geöffnet sind oder sich mehrere Dateien auf Amazon befindenEFS. Dieses Pop-up sollte in wenigen Sekunden verschwinden, nachdem der Studio Classic-Arbeitsbereich bereit ist.

  Wenn Sie nach der Auswahl einer der Optionen weiterhin einen Ladebildschirm mit einem Drehfeld 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 (AmazonVPC) zu beheben, überprüfen Sie die folgenden Netzwerkkonfigurationen:

  • Wenn Ihre Domain im VpcOnly Modus eingerichtet ist: Stellen Sie sicher, dass es einen VPC Amazon-Endpunkt für gibt AWS STS, oder ein NAT Gateway für ausgehenden Verkehr, einschließlich Verkehr über das Internet. Befolgen Sie dafür die unter Studio-Notizbücher in a VPC mit externen Ressourcen Connect beschriebenen Schritte.

  • Wenn Ihr Amazon mit einem benutzerdefinierten DNS statt mit dem von Amazon DNS bereitgestellten eingerichtet VPC ist: Stellen Sie sicher, dass die Routen mithilfe des Dynamic Host Configuration Protocol (DHCP) für jeden VPC Amazon-Endpunkt konfiguriert sind, der dem von Studio Classic VPC verwendeten Amazon hinzugefügt wurde. Weitere Informationen zur Einstellung standardmäßiger und benutzerdefinierter DHCP Optionssätze finden Sie unter DHCPOptionssätze bei 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 der Abschluss dieser Schritte Ihr Problem nicht löst, erstellen Sie ein Problem mit https://aws.amazon.com/premiumsupport/. 

  • Fehlendes EFS Amazon-Mount-Ziel: Studio Classic EFS verwendet Amazon als Speicher. Das EFS Amazon-Volume benötigt ein Mount-Ziel für jedes Subnetz, in dem die SageMaker Amazon-Domain erstellt wird. Wenn dieses EFS Amazon-Mount-Ziel 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. Finden Sie mithilfe des DescribeDomainAPIAnrufs das EFS Amazon-Volume, das der Domain zugeordnet ist. 

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

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

    4. Wählen Sie auf der EFS Amazon-Detailseite den Tab 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 EFS Amazon-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 .local Benutzerordner: Wenn Sie JupyterLab Version 1 in Studio Classic verwenden, können widersprüchliche Bibliotheken in Ihrem .local Ordner zu Problemen beim Starten der Studio Classic-Anwendung führen. Um dieses Problem zu beheben, aktualisieren Sie die JupyterLab Standardversion Ihres Benutzerprofils auf JupyterLab 3.0. Weitere Informationen zum Anzeigen und Aktualisieren der JupyterLab Version finden Sie unterJupyterLab Versionierung.

• 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. Sehen Sie sich die CloudWatch Amazon-Protokolle für die Lebenszykluskonfiguration an, um den Befehl nachzuverfolgen, der den Fehler verursacht hat. Um das Protokoll einzusehen, folgen Sie den Schritten unter Überprüfen Sie den Lebenszykluskonfigurationsprozess anhand von CloudWatch Protokollen.

  2. Trennen Sie das Standardskript vom Benutzerprofil oder der Domain. 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 Domain anhängen.

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

  Wenn Sie diese Fehlermeldung beim Öffnen von Studio Classic erhalten, kann dies an Versionskonflikten des Python-Pakets liegen. 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. Starten Sie Studio Classic neu:

     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 sie über den AWS 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 den geöffnet werden AWS Management Console.

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

KernelGateway Probleme mit der Anwendung

Die folgenden Probleme betreffen speziell 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 VPCOnly Modus eingerichtet ist, muss die der Domäne zugeordnete Sicherheitsgruppe den Verkehr zwischen den Ports im Bereich 8192-65535 für die Konnektivität zwischen den JupyterServer und KernelGateway Apps zulassen.

    So überprüfen Sie die Sicherheitsgruppenregeln

    1. Rufen Sie mithilfe des DescribeDomainAPIAnrufs die Sicherheitsgruppen ab, die der Domäne zugeordnet sind.

    2. Melden Sie sich bei der an AWS Management Console und öffnen Sie die VPC Amazon-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 IDs den Sicherheitsgruppen, die der Domain zugeordnet 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 VPCOnly Modus finden Sie unterStudio-Notizbücher in a VPC mit externen Ressourcen Connect.

  • Überprüfen Sie die Firewall und die WebSocket Verbindungen

    Wenn die KernelGateway Apps einen 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 Sie 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 lautet101, 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 Studio Classic auf eine Zulassungsliste zu setzen URL und WebSocket Verbindungen herzustellen. 

• 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 Instanz. Um dieses Problem zu lösen, können Sie eine der folgenden Möglichkeiten nutzen:

    • Löschen Sie eine bestehende KernelGateway Anwendung, die auf der Instanz 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 Instanztyp zu erstellen. Um dieses Problem zu beheben, navigieren Sie zu 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 Dienstkontingente.