Solução de problemas do Amazon SageMaker Studio Classic

Importante

Em 30 de novembro de 2023, a experiência anterior do Amazon SageMaker Studio agora se chama Amazon SageMaker Studio Classic. A seção a seguir é específica para usar o aplicativo Studio Classic. Para obter informações sobre como usar a experiência atualizada do Studio, consulte SageMaker Estúdio Amazon.

Este tópico descreve como solucionar problemas comuns do Amazon SageMaker Studio Classic durante a configuração e o uso. A seguir estão os erros comuns que podem ocorrer ao usar o Amazon SageMaker Studio Classic. Cada erro é seguido por sua solução.

Problemas com o aplicativo Studio Classic

Os problemas a seguir ocorrem ao iniciar e usar o aplicativo Studio Classic.

• A tela não carrega: limpar o espaço de trabalho e esperar não ajuda

  Ao iniciar o aplicativo Studio Classic, um pop-up exibe a seguinte mensagem. Independentemente da opção selecionada, o Studio Classic não carrega.

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

  O aplicativo Studio Classic pode ter um atraso na inicialização se várias guias estiverem abertas na área de trabalho do Studio Classic ou se vários arquivos estiverem no Amazon EFS. Esse pop-up deve desaparecer em alguns segundos depois que a área de trabalho do Studio Classic estiver pronta.

  Se você continuar vendo uma tela de carregamento com um botão giratório após selecionar qualquer uma das opções, pode haver problemas de conectividade com a Amazon Virtual Private Cloud usada pelo Studio Classic. 

  Para resolver problemas de conectividade com a Amazon Virtual Private Cloud (Amazon VPC) usada pelo Studio Classic, verifique as seguintes configurações de rede:

  • Se o seu domínio estiver configurado no modo VpcOnly: verifique se há um endpoint da Amazon VPC ou um gateway NAT para AWS STS tráfego de saída, incluindo tráfego pela Internet. Para isso, siga as etapas em Conecte os notebooks Connect SageMaker Studio Classic em uma VPC a recursos externos.

  • Se sua Amazon VPC estiver configurada com um DNS personalizado em vez do DNS fornecido pela Amazon: verifique se as rotas estão configuradas usando o Dynamic Host Configuration Protocol (DHCP) para cada endpoint do Amazon VPC adicionado ao Amazon VPC usado pelo Studio Classic. Para obter mais informações sobre como definir conjuntos de opções de DHCP padrão e personalizados, consulte Conjuntos de opções de DHCP na Amazon VPC.

• Falha interna ao iniciar o Studio Classic

  Ao iniciar o Studio Classic, você não consegue visualizar a interface do usuário do Studio Classic. Você também vê um erro semelhante ao seguinte, com Falha interna como detalhe do erro.

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

  Esse erro pode ser causado por vários fatores. Se a conclusão dessas etapas não resolver seu problema, crie um problema com https://aws.amazon.com/premiumsupport/. 

  • Alvo de montagem ausente do Amazon EFS: o Studio Classic usa o Amazon EFS para armazenamento. O volume do Amazon EFS precisa de um destino de montagem para cada sub-rede na qual o SageMaker domínio da Amazon é criado. Se esse destino de montagem do Amazon EFS for excluído acidentalmente, o aplicativo Studio Classic não poderá ser carregado porque não poderá montar o diretório de arquivos do usuário. Para resolver esse problema, siga as etapas a seguir.

    Para verificar ou criar destinos de montagem.

    1. Encontre o volume do Amazon EFS associado ao domínio usando a chamada de DescribeDomainAPI. 

    2. Faça login no AWS Management Console e abra o console do Amazon EFS em https://console.aws.amazon.com/ses/.

    3. Na lista de volumes do Amazon EFS, selecione o volume do Amazon EFS associado ao domínio.

    4. Na página de detalhes do Amazon EFS, selecione a guia Rede. Verifique se há destinos de montagem para todas as sub-redes nas quais o domínio está configurado.

    5. Se os destinos de montagem estiverem ausentes, adicione os alvos de montagem ausentes do Amazon EFS. Para obter instruções, consulte Criar e gerenciar destinos de montagem e grupos de segurança.

    6. Depois que os alvos de montagem ausentes forem criados, inicie o aplicativo Studio Classic.

  • Arquivos conflitantes na .local pasta do usuário: se você estiver usando a JupyterLab versão 1 no Studio Classic, bibliotecas conflitantes na sua .local pasta podem causar problemas ao iniciar o aplicativo Studio Classic. Para resolver isso, atualize a JupyterLab versão padrão do seu perfil de usuário para JupyterLab 3.0. Para obter mais informações sobre como visualizar e atualizar a JupyterLab versão, consulteJupyterLab Controle de versão.

• ConfigurationError: LifecycleConfig ao iniciar o Studio Classic

  Você não pode ver a interface do usuário do Studio Classic ao iniciar o Studio Classic. Isso é causado por problemas com o script de configuração do ciclo de vida padrão anexado ao domínio.

  Para resolver problemas de configuração do ciclo de vida

  1. Veja os Amazon CloudWatch Logs da configuração do ciclo de vida para rastrear o comando que causou a falha. Para ver o registro, siga as etapas em Verifique o processo de configuração do ciclo de vida a partir do Logs CloudWatch .

  2. Desassocie o script padrão do perfil ou domínio do usuário. Para ter mais informações, consulte Atualize e separe as configurações do ciclo de vida.

  3. Inicie o aplicativo Studio Classic.

  4. Depure seu script de configuração do ciclo de vida. Você pode executar o script de configuração do ciclo de vida no terminal do sistema para solucionar problemas. Quando o script é executado com êxito no terminal, você pode anexar o script ao perfil do usuário ou ao domínio.

• SageMaker As funcionalidades principais do Studio Classic não estão disponíveis.

  Se você receber essa mensagem de erro ao abrir o Studio Classic, pode ser devido a conflitos de versão do pacote Python. Isso ocorre se você usou os seguintes comandos em um notebook ou terminal para instalar pacotes Python que têm conflitos de versão com SageMaker dependências de pacotes.

  !pip install

  pip install --user

  Para resolver esse problema, siga as etapas a seguir:

  1. Desinstale os pacotes Python instalados recentemente. Se você não tiver certeza de qual pacote desinstalar, crie um problema com https://aws.amazon.com/premiumsupport/. 

  2. Reinicie o Studio Classic:

     1. Desligue o Studio Classic no menu Arquivo.

     2. Aguarde um minuto.

     3. Reabra o Studio Classic atualizando a página ou abrindo-a a partir do. AWS Management Console

  O problema deve ser resolvido se você tiver desinstalado o pacote que causou o conflito. Para instalar pacotes sem causar esse problema novamente, use %pip install sem o sinalizador --user.

  Se o problema persistir, crie um novo perfil de usuário e configure seu ambiente com esse perfil de usuário.

  Se essas soluções não resolverem o problema, crie um problema com https://aws.amazon.com/premiumsupport/. 

• Não é possível abrir o Studio Classic a partir doAWS Management Console.

  Se você não conseguir abrir o Studio Classic e não conseguir criar uma nova instância em execução com todas as configurações padrão, crie um problema com https://aws.amazon.com/premiumsupport/. 

KernelGateway problemas de aplicação

Os problemas a seguir são específicos KernelGateway dos aplicativos lançados no Studio Classic.

• Não é possível acessar a sessão do Kernel

  Quando o usuário inicia um novo caderno, ele não consegue se conectar à sessão do notebook. Se o status do KernelGateway aplicativo forIn Service, você poderá verificar o seguinte para resolver o problema.

  • Verifique as configurações do grupo de segurança

    Se o domínio estiver configurado no VPCOnly modo, o grupo de segurança associado ao domínio deverá permitir o tráfego entre as portas no intervalo 8192-65535 para conectividade entre os KernelGateway aplicativos JupyterServer e.

    Para verificar as regras de grupos de segurança

    1. Obtenha os grupos de segurança associados ao domínio usando a chamada de DescribeDomainAPI.

    2. Faça login no AWS Management Console e abra o console do Amazon VPC em https://console.aws.amazon.com/vpc/.

    3. No painel de navegação esquerdo, em Segurança, escolha Grupos de Segurança.

    4. Filtre por IDs de grupos de segurança que são associados ao domínio.

    5. Para cada grupo de segurança:

       1. Selecione o grupo de segurança .

       2. Na página de detalhes do grupo de segurança, veja as regras de entrada. Verifique se o tráfego é permitido entre as portas no intervalo 8192-65535.

    Para mais informações sobre regras de grupos de segurança, consulte Controle o tráfego para recursos usando grupos de segurança. Para obter mais informações sobre os requisitos para usar o Studio Classic no VPCOnly modo, consulteConecte os notebooks Connect SageMaker Studio Classic em uma VPC a recursos externos.

  • Verifique o firewall e WebSocket as conexões

    Se os KernelGateway aplicativos tiverem um InService status e o usuário não conseguir se conectar à sessão do notebook Studio Classic, verifique o firewall e WebSocket as configurações.

    1. Inicie o aplicativo Studio Classic. Para ter mais informações, consulte Inicie o Amazon SageMaker Studio Classic.

    2. Abra as ferramentas de desenvolvedor do seu navegador da Web.

    3. Escolha a guia Redes.

    4. Procure uma entrada que corresponda ao formato a seguir.

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

       Se o status ou o código de resposta da entrada for diferente de101, suas configurações de rede estão impedindo a conexão entre o aplicativo Studio Classic e os KernelGateway aplicativos.

       Para resolver esse problema, entre em contato com a equipe que gerencia suas configurações de rede para permitir listar o URL do Studio Classic e habilitar WebSocket conexões. 

• Não é possível iniciar um aplicativo devido ao excesso de cotas de recursos

  Quando um usuário tenta iniciar um novo caderno, a criação do caderno falha com um dos seguintes erros. Isso é causado pela superação das cotas de recursos.

  • 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

    O Studio Classic suporta até quatro KernelGateway aplicativos em execução na mesma instância. Para resolver esse problema, você pode realizar um dos seguintes procedimentos:

    • Exclua um KernelGateway aplicativo existente em execução na instância e reinicie o novo notebook.

    • Inicie o novo caderno em um tipo de instância diferente

    Para ter mais informações, consulte Alterar um tipo de instância.

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

    Nesse caso, a conta não tem limites suficientes para criar um aplicativo Studio Classic no tipo de instância especificado. Para resolver isso, navegue até o console do Service Quotas em https://console.aws.amazon.com/servicequotas/. Nesse console, solicite o aumento do limite do Studio KernelGateway Apps running on instance-type instance. Para obter mais informações, consulte as Service Quotas do AWS.