As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# 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 ao uso da aplicação Studio Classic. Para obter informações sobre como usar a experiência atualizada do Studio, consulte [SageMaker Estúdio Amazon](studio-updated.md).
O Studio Classic ainda é mantido para cargas de trabalho existentes, mas não está mais disponível para integração. Você só pode parar ou excluir aplicativos do Studio Classic existentes e não pode criar novos. Recomendamos que você [migre sua carga de trabalho para a nova experiência do Studio](studio-updated-migrate.md).
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma política do IAM permitir que o Studio e o Studio Classic criem recursos, mas não permitisse a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte [Forneça permissões para marcar recursos de SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS políticas gerenciadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que dão permissões para criar SageMaker recursos já incluem permissões para adicionar tags ao criar esses recursos.
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 de aplicações do Studio Classic
Os problemas a seguir ocorrem ao iniciar e usar a aplicação Studio Classic.
+ **A tela não carrega: limpar o espaço de trabalho e esperar não ajuda**
Ao iniciar a aplicação 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?
```
A aplicação Studio Classic pode ter um atraso na inicialização se várias guias estiverem abertas no espaço de trabalho do Studio 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 depois de selecionar qualquer uma das opções, pode haver problemas de conectividade com a Nuvem privada virtual da Amazon 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 `VpcOnly` modo: verifique se há um endpoint 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 [Conectar os cadernos do Studio em uma VPC para recursos externos](studio-notebooks-and-internet-access.md).
+ 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 Protocolo de Configuração Dinâmica de Host (DHCP) para cada endpoint da Amazon VPC adicionado ao Amazon endpoint da 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](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html).
+ ****Falha interna** ao iniciar o Studio**
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 usa o Amazon EFS para armazenamento. O volume do Amazon EFS precisa de um destino de montagem para cada sub-rede na qual o domínio Amazon SageMaker AI é criado. Se esse destino de montagem do Amazon EFS for excluído acidentalmente, a aplicação 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 [DescribeDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeDomain.html)API.
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon EFS em [https://console.aws.amazon.com/efs/](https://console.aws.amazon.com/efs/).
1. Na lista de volumes do Amazon EFS, selecione o volume do Amazon EFS associado ao domínio.
1. 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.
1. 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](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html).
1. Depois que os destinos de montagem ausentes forem criados, inicie a aplicação do 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, consulte[JupyterLab Controle de versão no Amazon Studio Classic SageMaker](studio-jl.md).
+ ****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 log, siga as etapas em [Verifique o processo de configuração do ciclo de vida a partir do Logs CloudWatch](studio-lcc-debug.md#studio-lcc-debug-logs).
1. Desassocie o script padrão do perfil ou domínio do usuário. Para obter mais informações, consulte [Atualize e separe configurações de ciclo de vida no Amazon Studio Classic SageMaker](studio-lcc-delete.md).
1. Inicie a aplicação Studio Classic.
1. 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 dependências de pacotes de SageMaker IA.
```
!pip install
```
```
pip install --user
```
Para resolver esse problema, siga as seguintes etapas:
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/.
1. Reiniciar o Studio Classic:
1. Encerre o Studio Classic no menu **Arquivo**.
1. Aguarde um minuto.
1. Reabra o Studio Classic atualizando a página ou abrindo-a a partir do Console de gerenciamento da AWS.
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 do Console de gerenciamento da AWS.**
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 caderno. Se o status do KernelGateway aplicativo for`In 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 [DescribeDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeDomain.html)API.
1. Faça login no Console de gerenciamento da AWS e abra o console da Amazon VPC em. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. No painel de navegação esquerdo, em **Segurança**, escolha **Grupos de Segurança**.
1. Filtre por IDs de grupos de segurança que são associados ao domínio.
1. Para cada grupo de segurança:
1. Selecione o grupo de segurança .
1. 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](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#working-with-security-group-rules). Para obter mais informações sobre os requisitos para usar o Studio Classic no modo `VPCOnly`, consulte [Conectar os cadernos do Studio em uma VPC para recursos externos](studio-notebooks-and-internet-access.md).
+ **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 a aplicação Studio Classic. Para obter mais informações, consulte [Inicie o Amazon SageMaker Studio Classic](studio-launch.md).
1. Abra as ferramentas de desenvolvedor do seu navegador da Web.
1. Escolha a guia **Redes**.
1. Procure uma entrada que corresponda ao formato a seguir.
```
wss://.studio..sagemaker.aws/jupyter/default/api/kernels//channels?session_id=
```
Se o status ou o código de resposta da entrada for diferente de`101`, 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 uma aplicação 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 obter mais informações, consulte [Alterar o tipo de instância de um notebook Amazon SageMaker Studio Classic](notebooks-run-and-manage-switch-instance-type.md).
+
```
An error occurred (ResourceLimitExceeded) when calling the CreateApp operation
```
Nesse caso, a conta não tem limites suficientes para criar uma aplicação Studio Classic no tipo de instância especificado. Para resolver isso, navegue até o Service Quotas console em [https://console.aws.amazon.com/servicequotas/](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](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).