Risoluzione dei problemi di Amazon SageMaker Studio Classic

Importante

A partire dal 30 novembre 2023, la precedente esperienza Amazon SageMaker Studio è ora denominata Amazon SageMaker Studio Classic. La sezione seguente è specifica per l'utilizzo dell'applicazione Studio Classic. Per informazioni sull'utilizzo dell'esperienza Studio aggiornata, consultaAmazon SageMaker Studio.

Importante

IAMLe politiche personalizzate che consentono ad Amazon SageMaker Studio o Amazon SageMaker Studio Classic di creare SageMaker risorse Amazon devono inoltre concedere le autorizzazioni per aggiungere tag a tali risorse. L'autorizzazione per aggiungere tag alle risorse è necessaria perché Studio e Studio Classic taggano automaticamente tutte le risorse che creano. Se una IAM politica consente a Studio e Studio Classic di creare risorse ma non consente l'aggiunta di tag, si possono verificare errori AccessDenied "" durante il tentativo di creare risorse. Per ulteriori informazioni, consulta Fornisci le autorizzazioni per etichettare le risorse SageMaker.

AWS Policy gestite per Amazon SageMakerche concedono le autorizzazioni per creare SageMaker risorse includono già le autorizzazioni per aggiungere tag durante la creazione di tali risorse.

Questo argomento descrive come risolvere i problemi più comuni di Amazon SageMaker Studio Classic durante la configurazione e l'uso. Di seguito sono riportati gli errori più comuni che potrebbero verificarsi durante l'utilizzo di Amazon SageMaker Studio Classic. Ogni errore è seguito dalla relativa soluzione.

Problemi relativi all'applicazione Studio Classic

I seguenti problemi si verificano durante l'avvio e l'utilizzo dell'applicazione Studio Classic.

• La schermata non si carica: cancellare l'area di lavoro e attendere non aiuta

  All'avvio dell'applicazione Studio Classic, un pop-up visualizza il seguente messaggio. Indipendentemente dall'opzione selezionata, Studio Classic non viene caricato.

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

  L'applicazione Studio Classic può avere un ritardo di avvio se nell'area di lavoro di Studio Classic sono aperte più schede o se diversi file sono su Amazon. EFS Questo pop-up dovrebbe scomparire in pochi secondi dopo che l'area di lavoro di Studio Classic sarà pronta.

  Se continui a visualizzare una schermata di caricamento con uno spinner dopo aver selezionato una delle opzioni, potrebbero esserci problemi di connettività con Amazon Virtual Private Cloud utilizzato da Studio Classic. 

  Per risolvere i problemi di connettività con Amazon Virtual Private Cloud (AmazonVPC) utilizzato da Studio Classic, verifica le seguenti configurazioni di rete:

  • Se il tuo dominio è configurato in VpcOnly modalità: verifica che esista un VPC endpoint Amazon o un NAT gateway per il traffico in uscita, incluso il traffico su Internet. AWS STS A tale scopo, segui le fasi descritte in Collega i notebook Connect Studio in un a a risorse esterne VPC.

  • Se il tuo Amazon VPC è configurato con uno personalizzato DNS anziché quello DNS fornito da Amazon: verifica che i percorsi siano configurati utilizzando Dynamic Host Configuration Protocol (DHCP) per ogni VPC endpoint Amazon aggiunto all'Amazon VPC utilizzato da Studio Classic. Per ulteriori informazioni sull'impostazione di set di DHCP opzioni predefiniti e personalizzati, consulta i set di DHCP opzioni in Amazon VPC.

• Errore interno all'avvio di Studio Classic

  All'avvio di Studio Classic, non è possibile visualizzare l'interfaccia utente di Studio Classic. Viene inoltre visualizzato un errore simile al seguente, con Guasto interno come dettaglio dell'errore.

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

  Questo errore può essere causato da diversi fattori. Se il completamento di questi passaggi non risolve il problema, crea un problema con https://aws.amazon.com/premiumsupport/. 

  • Obiettivo di EFS montaggio Amazon mancante: Studio Classic utilizza Amazon EFS per lo storage. Il EFS volume Amazon necessita di una destinazione di montaggio per ogni sottorete in cui viene creato il SageMaker dominio Amazon. Se questa destinazione di EFS montaggio Amazon viene eliminata accidentalmente, l'applicazione Studio Classic non può essere caricata perché non può montare la directory dei file dell'utente. Per risolvere il problema, completa la seguente procedura.

    Per verificare o creare target di montaggio

    1. Trova il EFS volume Amazon associato al dominio utilizzando la DescribeDomainAPIchiamata. 

    2. Accedi a AWS Management Console e apri la EFS console Amazon all'indirizzo https://console.aws.amazon.com/efs/.

    3. Dall'elenco dei EFS volumi Amazon, seleziona il EFS volume Amazon associato al dominio.

    4. Nella pagina dei EFS dettagli di Amazon, seleziona la scheda Rete. Verifica che esistano target di montaggio per tutte le sottoreti in cui è configurato il dominio.

    5. Se mancano le destinazioni di montaggio, aggiungi le destinazioni di EFS montaggio Amazon mancanti. Per istruzioni, consulta Creating and managing mount targets and security groups.

    6. Dopo aver creato i target di montaggio mancanti, avvia l'applicazione Studio Classic.

  • File in conflitto nella .local cartella dell'utente: se utilizzate la JupyterLab versione 1 su Studio Classic, le librerie in conflitto .local nella cartella possono causare problemi all'avvio dell'applicazione Studio Classic. Per risolvere questo problema, aggiorna la JupyterLab versione predefinita del profilo utente alla 3.0. JupyterLab Per ulteriori informazioni sulla visualizzazione e l'aggiornamento della JupyterLab versione, vedereJupyterLab Controllo delle versioni.

• ConfigurationError: all' LifecycleConfigavvio di Studio Classic

  Non è possibile visualizzare l'interfaccia utente di Studio Classic all'avvio di Studio Classic. Ciò è causato da problemi con lo script di configurazione del ciclo di vita predefinito collegato al dominio.

  Per risolvere i problemi di configurazione del ciclo di vita

  1. Visualizza Amazon CloudWatch Logs per la configurazione del ciclo di vita per tracciare il comando che ha causato l'errore. Per visualizzare il log, segui le fasi descritte in Verifica il processo di configurazione del ciclo di vita da Logs CloudWatch .

  2. Scollega lo script predefinito dal profilo utente o dal dominio. Per ulteriori informazioni, consulta Aggiornamento e scollegamento delle configurazioni del ciclo di vita.

  3. Avvia l'applicazione Studio Classic.

  4. Esegui il debug dello script di configurazione del ciclo di vita. Puoi eseguire lo script di configurazione del ciclo di vita dal terminale di sistema per risolvere i problemi. Quando lo script viene eseguito correttamente dal terminale, puoi collegarlo al profilo utente o al dominio.

• SageMaker Le funzionalità principali di Studio Classic non sono disponibili.

  Se ricevi questo messaggio di errore all'apertura di Studio Classic, potrebbe essere dovuto a conflitti di versione del pacchetto Python. Ciò si verifica se hai usato i seguenti comandi in un notebook o in un terminale per installare pacchetti Python che presentano conflitti di versione con le dipendenze dei SageMaker pacchetti.

  !pip install

  pip install --user

  Per risolvere il problema, completala seguente procedura:

  1. Disinstalla i pacchetti Python installati di recente. Se non sei sicuro del pacchetto da disinstallare, crea un problema con. https://aws.amazon.com/premiumsupport/ 

  2. Riavvia Studio Classic:

     1. Chiudi Studio Classic dal menu File.

     2. Attendi un minuto.

     3. Riapri Studio Classic aggiornando la pagina o aprendola da. AWS Management Console

  Il problema dovrebbe essere risolto se è stato disinstallato il pacchetto che ha causato il conflitto. Per installare i pacchetti senza causare nuovamente questo problema, utilizza %pip install senza il flag --user.

  Se il problema persiste, crea un nuovo profilo utente e configura l'ambiente con quel profilo utente.

  Se queste soluzioni non risolvono il problema, crea un problema con. https://aws.amazon.com/premiumsupport/ 

• Impossibile aprire Studio Classic da AWS Management Console.

  Se non riesci ad aprire Studio Classic e non riesci a creare una nuova istanza in esecuzione con tutte le impostazioni predefinite, crea un problema con https://aws.amazon.com/premiumsupport/. 

KernelGateway problemi relativi all'applicazione

I seguenti problemi sono specifici KernelGateway delle applicazioni avviate in Studio Classic.

• Impossibile accedere alla sessione Kernel

  Quando l'utente avvia un nuovo notebook, non è in grado di connettersi alla sessione del notebook. Se lo stato dell' KernelGateway applicazione èIn Service, puoi verificare quanto segue per risolvere il problema.

  • Controllo delle configurazioni dei gruppi di sicurezza

    Se il dominio è configurato in VPCOnly modalità, il gruppo di sicurezza associato al dominio deve consentire il traffico tra le porte nell'intervallo di 8192-65535 connettività tra le JupyterServer e KernelGateway le app.

    Per verificare le regole del gruppo di sicurezza

    1. Ottieni i gruppi di sicurezza associati al dominio utilizzando la DescribeDomainAPIchiamata.

    2. Accedi a AWS Management Console e apri la VPC console Amazon all'indirizzo https://console.aws.amazon.com/vpc/.

    3. Nel riquadro di navigazione a sinistra, in Sicurezza, scegli Gruppi di sicurezza.

    4. Filtra in base ai gruppi di sicurezza associati al dominio. IDs

    5. Per ogni gruppo di sicurezza:

       1. Seleziona il gruppo di sicurezza.

       2. Dalla pagina dei dettagli del gruppo di sicurezza, visualizza le Regole in entrata. Verifica che il traffico sia consentito tra le porte dell'intervallo 8192-65535.

    Per ulteriori informazioni sulle regole del gruppo di sicurezza, consulta Control traffic to resources using security groups. Per ulteriori informazioni sui requisiti per l'utilizzo di Studio Classic in VPCOnly modalità, vedereCollega i notebook Connect Studio in un a a risorse esterne VPC.

  • Verifica il firewall e WebSocket le connessioni

    Se le KernelGateway app hanno uno InService stato e l'utente non è in grado di connettersi alla sessione del notebook Studio Classic, verifica il firewall e WebSocket le impostazioni.

    1. Avvia l'applicazione Studio Classic. Per ulteriori informazioni, consulta Avvia Amazon SageMaker Studio Classic.

    2. Apri gli strumenti per sviluppatori del tuo browser Web.

    3. Scegli la scheda Rete.

    4. Cerca una voce che corrisponda al formato seguente.

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

       Se lo stato o il codice di risposta per l'immissione è diverso101, le impostazioni di rete impediscono la connessione tra l'applicazione Studio Classic e le KernelGateway app.

       Per risolvere questo problema, contattate il team che gestisce le impostazioni di rete per consentire l'elenco di Studio Classic URL e abilitare WebSocket le connessioni. 

• Impossibile avviare un'app a causa del superamento delle quote delle risorse

  Quando un utente tenta di avviare un nuovo notebook, la creazione del notebook non riesce e causa uno dei seguenti errori. Ciò è causato dal superamento delle quote delle risorse.

  • 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 supporta fino a quattro KernelGateway app in esecuzione sulla stessa istanza. Per risolvere il problema, puoi procedere in uno dei seguenti modi:

    • Elimina un' KernelGateway applicazione esistente in esecuzione sull'istanza, quindi riavvia il nuovo notebook.

    • Avviare il nuovo notebook su un tipo di istanza diverso

    Per ulteriori informazioni, consulta Modifica di un tipo di istanza.

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

    In questo caso, l'account non ha limiti sufficienti per creare un'applicazione Studio Classic sul tipo di istanza specificato. Per risolvere il problema, accedi alla Service Quotas console all'indirizzo https://console.aws.amazon.com/servicequotas/. In quella console, richiedi di aumentare il limite Studio KernelGateway Apps running on instance-type instance. Per ulteriori informazioni, consulta AWS service quotas.