翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon SageMaker Studio Classic のトラブルシューティング
<a name="studio-troubleshooting"></a>

**重要**  
2023 年 11 月 30 日以降、従来の Amazon SageMaker Studio のエクスペリエンスは Amazon SageMaker Studio Classic と名前が変更されました。以下のセクションは、Studio Classic アプリケーションの使用を前提とした内容です。更新後の Studio エクスペリエンスを使用する場合は、「[Amazon SageMaker Studio](studio-updated.md)」を参照してください。  
Studio Classic は既存のワークロードでも維持されていますが、オンボーディングに利用できなくなりました。既存の Studio Classic アプリケーションのみを停止または削除でき、新しいアプリケーションを作成することはできません。[ワークロードを新しい Studio エクスペリエンスに移行](studio-updated-migrate.md)することをお勧めします。

**重要**  
Amazon SageMaker Studio または Amazon SageMaker Studio Classic に Amazon SageMaker リソースの作成を許可するカスタム IAM ポリシーでは、これらのリソースにタグを追加するアクセス許可も付与する必要があります。Studio と Studio Classic は、作成したリソースに自動的にタグ付けするため、リソースにタグを追加するアクセス許可が必要になります。IAM ポリシーで Studio と Studio Classic によるリソースの作成が許可されていても、タグ付けが許可されていない場合は、リソースを作成しようとしたときに「AccessDenied」エラーが発生する可能性があります。詳細については、「[SageMaker AI リソースにタグ付けのアクセス許可を付与する](security_iam_id-based-policy-examples.md#grant-tagging-permissions)」を参照してください。  
SageMaker リソースを作成するためのアクセス許可を付与する [AWS Amazon SageMaker AI の マネージドポリシー](security-iam-awsmanpol.md) には、それらのリソースの作成中にタグを追加するためのアクセス許可もあらかじめ含まれています。

このトピックでは、設定中および使用中の Amazon SageMaker Studio Classic で発生する一般的な問題のトラブルシューティング方法について説明します。以下に、Amazon SageMaker Studio Classic を使用する際に発生する可能性がある一般的なエラーを示します。各エラーの後に、エラーの解決策を示します。

## Studio Classic アプリケーションの問題
<a name="studio-troubleshooting-ui"></a>

 Studio Classic アプリケーションを起動して使用する際、以下の問題が発生する可能性があります。
+ **画面が読み込まれない: ワークスペースをクリアして待機しても問題が解消されない**

  Studio Classic アプリケーションを起動すると、ポップアップに次のメッセージが表示されます。どのオプションを選択しても Studio Classic は読み込まれません。

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

  Studio Classic ワークスペースで複数のタブが開いている場合や、Amazon EFS に複数のファイルがある場合、Studio Classic アプリケーションの起動に時間がかかることがあります。Studio Classic ワークスペースの準備が整うと、数秒後にこのポップアップは表示されなくなります。

  いずれかのオプションを選択しても、スピナーを含む読み込み画面が引き続き表示される場合は、Studio Classic が使用する Amazon Virtual Private Cloud との接続に問題がある可能性があります。  

  Studio Classic が使用する Amazon Virtual Private Cloud (Amazon VPC) との接続の問題を解決するには、次のネットワーク設定を確認してください。
  + ドメインが `VpcOnly` モードで設定されている場合: インターネット経由のトラフィックを含むアウトバウンドトラフィック用の Amazon VPC エンドポイント AWS STSまたは NAT Gateway があることを確認します。確認するには、「[VPC 内の Studio ノートブックを外部リソースに接続する](studio-notebooks-and-internet-access.md)」の手順に従います。
  + Amazon が提供する DNS ではなくカスタム DNS で Amazon VPC が設定されている場合: Studio Classic が使用する Amazon VPC に追加された各 Amazon VPC エンドポイントについて、Dynamic Host Configuration Protocol (DHCP) を使用してルートが設定されていることを確認します。DHCP のデフォルトおよびカスタムオプションセットの設定の詳細については、「[DHCP option sets in Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html)」を参照してください。
+ **Studio Classic の起動時の**内部障害****

  Studio Classic の起動時に、Studio Classic UI が表示されません。また、次のようなエラーが表示され、エラーの詳細が**内部障害**になっています。

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

  このエラーは複数の要因によって発生する可能性があります。これらの手順を実行しても問題が解決しない場合は、https://aws.amazon.com/premiumsupport/ でサポートを依頼してください。  
  + **Amazon EFS マウントターゲットが見つからない**: Studio Classic は Amazon EFS をストレージとして使用します。Amazon EFS ボリュームには、Amazon SageMaker AI ドメインが作成されるサブネットごとにマウントターゲットが必要です。この Amazon EFS マウントターゲットを誤って削除した場合、Studio Classic アプリケーションはユーザーのファイルディレクトリをマウントできないため、読み込むことができません。この問題を解決するには、次の手順に従います。

**マウントターゲットを検証または作成するには**

    1. [DescribeDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeDomain.html) API コールを使用して、ドメインに関連付けられている Amazon EFS ボリュームを検索します。  

    1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/efs/](https://console.aws.amazon.com/efs/) で Amazon EFS コンソールを開きます。

    1. Amazon EFS ボリュームのリストから、ドメインに関連付けられている Amazon EFS ボリュームを選択します。

    1. Amazon EFS の詳細ページで、**[ネットワーク]** タブを選択します。ドメインが設定されているすべてのサブネットにマウントターゲットがあることを確認します。

    1. マウントターゲットがない場合は、Amazon EFS マウントターゲットを追加します。手順については、「[Creating and managing mount targets and security groups](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)」を参照してください。

    1. 不足しているマウントターゲットを作成したら、Studio Classic アプリケーションを起動します。
  + **ユーザーの `.local` フォルダ内の競合ファイル**: Studio Classic で JupyterLab バージョン 1 を使用している場合、`.local` フォルダ内の競合するライブラリによって Studio Classic アプリケーションの起動時に問題が発生する可能性があります。これを解決するには、ユーザープロファイルのデフォルトの JupyterLab バージョンを JupyterLab 3.0 に更新してください。JupyterLab バージョンの表示と更新の詳細については、「[Amazon SageMaker Studio Classic での JupyterLab のバージョニング](studio-jl.md)」を参照してください。
+ ****設定エラー: Studio Classic 起動時の LifecycleConfig****

  Studio Classic の起動時に Studio Classic UI が表示されません。これは、ドメインにアタッチされているデフォルトのライフサイクル設定スクリプトに問題があることが原因です。

**ライフサイクル設定の問題を解決するには**

  1. ライフサイクル設定の Amazon CloudWatch Logs を表示して、障害の原因となったコマンドを追跡します。ログを表示するには、「[CloudWatch Logs でライフサイクル設定プロセスを検証する](studio-lcc-debug.md#studio-lcc-debug-logs)」の手順に従います。

  1. デフォルトのスクリプトをユーザープロファイルまたはドメインからデタッチします。詳細については、「[Amazon SageMaker Studio Classic でライフサイクル設定を更新してデタッチする](studio-lcc-delete.md)」を参照してください。

  1. Studio Classic アプリケーションを起動します。

  1. ライフサイクル設定スクリプトをデバッグします。システムターミナルからライフサイクル設定スクリプトを実行することで、トラブルシューティングできます。スクリプトがターミナルから正常に実行されたら、ユーザープロファイルまたはドメインにスクリプトをアタッチできます。
+ **SageMaker Studio Classic のコア機能を使用できません。**

  Studio Classic を開いたときにこのエラーメッセージが表示される場合、Python のパッケージバージョンの競合が原因である可能性があります。これは、ノートブックまたはターミナルで次のコマンドを使用して、SageMaker AI パッケージの依存関係とバージョンが競合する Python パッケージをインストールした場合に発生します。

  ```
  !pip install
  ```

  ```
  pip install --user
  ```

  この問題を解決するには、次の手順に従います。

  1. 最近インストールした Python パッケージをアンインストールします。どのパッケージをアンインストールすればよいかわからない場合は、https://aws.amazon.com/premiumsupport/ でサポートを依頼してください。 

  1. Studio Classic を再起動します。

     1. **[ファイル]** メニューから Studio Classic をシャットダウンします。

     1. 1 分間待ちます。

     1. Studio Classic を再度開くには、ページを更新するか、Studio Classic を AWS マネジメントコンソールから開きます。

  競合の原因となったパッケージをアンインストールすると、問題は解決します。この問題を再度発生させないようにパッケージをインストールするには、`--user` フラグを付けずに `%pip install` を実行します。

  問題が解決しない場合、新しいユーザープロファイルを作成し、そのユーザープロファイルを使って環境を設定します。

  これらの解決策で問題が解決しない場合は、https://aws.amazon.com/premiumsupport/ でサポートを依頼してください。 
+ ** AWS マネジメントコンソールから Studio Classic を開くことができません。**

  Studio Classic を開くことができず、すべてのデフォルト設定で実行中のインスタンスを新たに作成できない場合は、https://aws.amazon.com/premiumsupport/ でサポートを依頼してください。 

## KernelGateway アプリケーションの問題
<a name="studio-troubleshooting-kg"></a>

 以下の問題は、Studio Classic で起動される KernelGateway アプリケーションに固有の問題です。
+ **カーネルセッションにアクセスできない**

  ユーザーが新しいノートブックを起動しても、ノートブックセッションに接続できません。KernelGateway アプリケーションのステータスが `In Service` の場合、以下を確認することで問題を解決できます。
  + **セキュリティグループの設定を確認する**

    ドメインが `VPCOnly` モードで設定されている場合、ドメインに関連付けられたセキュリティグループは、JupyterServer アプリと KernelGateway アプリ間の接続のために、`8192-65535` の範囲内のポート間のトラフィックを許可する必要があります。

**セキュリティグループのルールを確認するには**

    1. [DescribeDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeDomain.html) API コールを使用して、ドメインに関連付けられているセキュリティグループを取得します。

    1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) で Amazon VPC コンソールを開きます。

    1. 左側のナビゲーションの **[セキュリティ]** で、**[セキュリティグループ]** を選択します。

    1. ドメインに関連付けられているセキュリティグループの ID でフィルタリングします。

    1. 各セキュリティグループで次を実行します。

       1. セキュリティグループを選択します。

       1. セキュリティグループの詳細ページで、**[インバウンドルール]** を表示します。`8192-65535` の範囲内のポート間で、トラフィックが許可されていることを確認します。

    セキュリティグループのルールの詳細については、「[Control traffic to resources using security groups](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#working-with-security-group-rules)」を参照してください。Studio Classic を `VPCOnly` モードで使用するための要件の詳細については、「[VPC 内の Studio ノートブックを外部リソースに接続する](studio-notebooks-and-internet-access.md)」を参照してください。
  + **ファイアウォールと WebSocket 接続を確認する**

    KernelGateway アプリのステータスが `InService` で、ユーザーが Studio Classic ノートブックセッションに接続できない場合は、ファイアウォールと WebSocket の設定を確認します。

    1. Studio Classic アプリケーションを起動します。詳細については、「[Amazon SageMaker Studio Classic を起動する](studio-launch.md)」を参照してください。

    1. ウェブブラウザの開発者ツールを開きます。

    1. **[ネットワーク]** タブを選択します。

    1. 次の形式に一致するエントリを検索します。

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

       エントリのステータスコードまたはレスポンスコードが `101` 以外の場合、ネットワーク設定により Studio Classic アプリケーションと KernelGateway アプリ間の接続が妨げられています。

       この問題を解決するには、ネットワーク設定を管理するチームに連絡して Studio Classic URL を許可し、WebSocket 接続を有効にしてください。  
+ **リソースクォータの超過によりアプリを起動できない**

  ユーザーが新しいノートブックを起動しようとすると、ノートブックの作成が以下のいずれかのエラーで失敗します。これはリソースクォータの超過が原因です。
  + 

    ```
    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 は、同じインスタンス上で実行される KernelGateway アプリを最大 4 つまでサポートしています。この問題を解決するには、次のいずれかを実行します。
    + インスタンスで実行されている既存の KernelGateway アプリケーションを削除し、新しいノートブックを再起動します。
    + 新しいノートブックを別のインスタンスタイプで起動します。

     詳細については、「[Amazon SageMaker Studio Classic ノートブックのインスタンスタイプを変更する](notebooks-run-and-manage-switch-instance-type.md)」を参照してください。
  + 

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

    このケースでは、指定されたインスタンスタイプで Studio Classic アプリケーションを作成するための十分な制限がアカウントにありません。これを解決するには、[https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/) で サービスクォータ コンソールに移動します。コンソールで、`Studio KernelGateway Apps running on {{instance-type}} instance` 制限の引き上げをリクエストします。詳細については、「[AWS サービスクォータ](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)」を参照してください。