

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memecahkan Masalah Amazon Studio Classic SageMaker
<a name="studio-troubleshooting"></a>

**penting**  
Pada 30 November 2023, pengalaman Amazon SageMaker Studio sebelumnya sekarang bernama Amazon SageMaker Studio Classic. Bagian berikut khusus untuk menggunakan aplikasi Studio Classic. Untuk informasi tentang menggunakan pengalaman Studio yang diperbarui, lihat[SageMaker Studio Amazon](studio-updated.md).  
Studio Classic masih dipertahankan untuk beban kerja yang ada tetapi tidak lagi tersedia untuk orientasi. Anda hanya dapat menghentikan atau menghapus aplikasi Studio Classic yang ada dan tidak dapat membuat yang baru. Kami menyarankan Anda [memigrasikan beban kerja Anda ke pengalaman Studio baru](studio-updated-migrate.md).

**penting**  
Kebijakan IAM khusus yang memungkinkan Amazon SageMaker Studio atau Amazon SageMaker Studio Classic membuat SageMaker sumber daya Amazon juga harus memberikan izin untuk menambahkan tag ke sumber daya tersebut. Izin untuk menambahkan tag ke sumber daya diperlukan karena Studio dan Studio Classic secara otomatis menandai sumber daya apa pun yang mereka buat. Jika kebijakan IAM memungkinkan Studio dan Studio Classic membuat sumber daya tetapi tidak mengizinkan penandaan, kesalahan "AccessDenied" dapat terjadi saat mencoba membuat sumber daya. Untuk informasi selengkapnya, lihat [Berikan izin untuk menandai sumber daya AI SageMaker](security_iam_id-based-policy-examples.md#grant-tagging-permissions).  
[AWS kebijakan terkelola untuk Amazon SageMaker AI](security-iam-awsmanpol.md)yang memberikan izin untuk membuat SageMaker sumber daya sudah menyertakan izin untuk menambahkan tag saat membuat sumber daya tersebut.

Topik ini menjelaskan cara memecahkan masalah umum Amazon SageMaker Studio Classic selama penyiapan dan penggunaan. Berikut ini adalah kesalahan umum yang mungkin terjadi saat menggunakan Amazon SageMaker Studio Classic. Setiap kesalahan diikuti oleh solusinya.

## Masalah aplikasi Studio Classic
<a name="studio-troubleshooting-ui"></a>

 Masalah berikut terjadi saat meluncurkan dan menggunakan aplikasi Studio Classic.
+ **Layar tidak dimuat: Membersihkan ruang kerja dan menunggu tidak membantu**

  Saat meluncurkan aplikasi Studio Classic, pop-up menampilkan pesan berikut. Tidak peduli opsi mana yang dipilih, Studio Classic tidak memuat. 

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

  Aplikasi Studio Classic dapat mengalami penundaan peluncuran jika beberapa tab terbuka di ruang kerja Studio Classic atau beberapa file ada di Amazon EFS. Pop-up ini akan hilang dalam beberapa detik setelah ruang kerja Studio Classic siap. 

  Jika Anda terus melihat layar pemuatan dengan pemintal setelah memilih salah satu opsi, mungkin ada masalah konektivitas dengan Amazon Virtual Private Cloud yang digunakan oleh Studio Classic.  

  Untuk mengatasi masalah konektivitas dengan Amazon Virtual Private Cloud (Amazon VPC) yang digunakan oleh Studio Classic, verifikasi konfigurasi jaringan berikut:
  + Jika domain Anda diatur dalam `VpcOnly` mode: Verifikasi bahwa ada titik akhir VPC Amazon untuk AWS STS, atau NAT Gateway untuk lalu lintas keluar, termasuk lalu lintas melalui internet. Untuk melakukannya, ikuti langkah-langkah di [Hubungkan notebook Studio di VPC ke sumber daya eksternal](studio-notebooks-and-internet-access.md). 
  + Jika VPC Amazon Anda diatur dengan DNS khusus, bukan DNS yang disediakan oleh Amazon: Verifikasi bahwa rute dikonfigurasi menggunakan Dynamic Host Configuration Protocol (DHCP) untuk setiap titik akhir VPC Amazon yang ditambahkan ke VPC Amazon yang digunakan oleh Studio Classic. Untuk informasi selengkapnya tentang menyetel set opsi DHCP default dan kustom, lihat [set opsi DHCP di Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_DHCP_Options.html). 
+ ****Kegagalan Internal** saat meluncurkan Studio Classic**

  Saat meluncurkan Studio Classic, Anda tidak dapat melihat UI Studio Classic. Anda juga melihat kesalahan yang mirip dengan berikut ini, dengan **Kegagalan Internal** sebagai detail kesalahan. 

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

  Kesalahan ini dapat disebabkan oleh banyak faktor. Jika penyelesaian langkah-langkah ini tidak menyelesaikan masalah Anda, buat masalah dengan https://aws.amazon.com/premiumsupport/.  
  + **Target pemasangan Amazon EFS tidak ada**: Studio Classic menggunakan Amazon EFS untuk penyimpanan. Volume Amazon EFS membutuhkan target pemasangan untuk setiap subnet tempat domain Amazon SageMaker AI dibuat. Jika target pemasangan Amazon EFS ini dihapus secara tidak sengaja, aplikasi Studio Classic tidak dapat memuat karena tidak dapat memasang direktori file pengguna. Untuk mengatasi masalah ini, selesaikan langkah-langkah berikut. 

**Untuk memverifikasi atau membuat target mount.**

    1. Temukan volume Amazon EFS yang terkait dengan domain menggunakan panggilan [DescribeDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeDomain.html)API.  

    1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EFS di [ https://console.aws.amazon.com/efs/](https://console.aws.amazon.com/efs/).

    1. Dari daftar volume Amazon EFS, pilih volume Amazon EFS yang terkait dengan domain. 

    1. Di halaman detail Amazon EFS, pilih tab **Jaringan**. Verifikasi bahwa ada target mount untuk semua subnet tempat domain diatur. 

    1. Jika target pemasangan tidak ada, tambahkan target pemasangan Amazon EFS yang hilang. Untuk petunjuknya, lihat [Membuat dan mengelola target pemasangan dan grup keamanan](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html). 

    1. Setelah target mount yang hilang dibuat, luncurkan aplikasi Studio Classic. 
  + **File yang bertentangan di `.local` folder pengguna**: Jika Anda menggunakan JupyterLab versi 1 di Studio Classic, pustaka yang bertentangan di `.local` folder Anda dapat menyebabkan masalah saat meluncurkan aplikasi Studio Classic. Untuk mengatasinya, perbarui JupyterLab versi default profil pengguna Anda ke JupyterLab 3.0. Untuk informasi selengkapnya tentang melihat dan memperbarui JupyterLab versi, lihat[JupyterLab Pembuatan Versi di Amazon Studio Classic SageMaker](studio-jl.md). 
+ ****ConfigurationError: LifecycleConfig** saat meluncurkan Studio Classic**

  Anda tidak dapat melihat UI Studio Classic saat meluncurkan Studio Classic. Ini disebabkan oleh masalah dengan skrip konfigurasi siklus hidup default yang dilampirkan ke domain.

**Untuk mengatasi masalah konfigurasi siklus hidup**

  1. Lihat CloudWatch Log Amazon untuk konfigurasi siklus hidup untuk melacak perintah yang menyebabkan kegagalan. Untuk melihat log, ikuti langkah-langkahnya[Verifikasi proses konfigurasi siklus hidup dari Log CloudWatch](studio-lcc-debug.md#studio-lcc-debug-logs). 

  1. Lepaskan skrip default dari profil pengguna atau domain. Untuk informasi selengkapnya, lihat [Perbarui dan Lepaskan Konfigurasi Siklus Hidup di Amazon Studio Classic SageMaker](studio-lcc-delete.md). 

  1. Luncurkan aplikasi Studio Classic. 

  1. Debug skrip konfigurasi siklus hidup Anda. Anda dapat menjalankan skrip konfigurasi siklus hidup dari terminal sistem untuk memecahkan masalah. Ketika skrip berjalan dengan sukses dari terminal, Anda dapat melampirkan skrip ke profil pengguna atau domain. 
+ **SageMaker Fungsi inti Studio Classic tidak tersedia.**

  Jika Anda mendapatkan pesan kesalahan ini saat membuka Studio Classic, itu mungkin karena konflik versi paket Python. Ini terjadi jika Anda menggunakan perintah berikut di notebook atau terminal untuk menginstal paket Python yang memiliki konflik versi dengan dependensi paket SageMaker AI.

  ```
  !pip install
  ```

  ```
  pip install --user
  ```

  Untuk mengatasi masalah ini, selesaikan langkah-langkah berikut:

  1. Copot pemasangan paket Python yang baru saja diinstal. Jika Anda tidak yakin paket mana yang akan dihapus, buat masalah dengan https://aws.amazon.com/premiumsupport/. 

  1. Mulai ulang Studio Classic:

     1. Matikan Studio Classic dari menu **File**.

     1. Tunggu satu menit.

     1. Buka kembali Studio Classic dengan menyegarkan halaman atau membukanya dari. Konsol Manajemen AWS

  Masalahnya harus diselesaikan jika Anda telah menghapus paket yang menyebabkan konflik. Untuk menginstal paket tanpa menyebabkan masalah ini lagi, gunakan `%pip install` tanpa `--user` tanda.

  Jika masalah berlanjut, buat profil pengguna baru dan atur lingkungan Anda dengan profil pengguna tersebut.

  Jika solusi ini tidak memperbaiki masalah, buat masalah dengan https://aws.amazon.com/premiumsupport/. 
+ **Tidak dapat membuka Studio Classic dari file Konsol Manajemen AWS.**

  Jika Anda tidak dapat membuka Studio Classic dan tidak dapat membuat instance baru yang berjalan dengan semua pengaturan default, buat masalah dengan https://aws.amazon.com/premiumsupport/. 

## KernelGateway masalah aplikasi
<a name="studio-troubleshooting-kg"></a>

 Masalah berikut khusus untuk KernelGateway aplikasi yang diluncurkan di Studio Classic. 
+ **Tidak dapat mengakses sesi Kernel**

  Ketika pengguna meluncurkan notebook baru, mereka tidak dapat terhubung ke sesi notebook. Jika status KernelGateway aplikasi`In Service`, Anda dapat memverifikasi hal berikut untuk menyelesaikan masalah. 
  + **Periksa konfigurasi Grup Keamanan**

    Jika domain diatur dalam `VPCOnly` mode, grup keamanan yang terkait dengan domain harus mengizinkan lalu lintas antara port dalam rentang `8192-65535` untuk konektivitas antara KernelGateway aplikasi JupyterServer dan aplikasi.

**Untuk memverifikasi aturan grup keamanan**

    1. Dapatkan grup keamanan yang terkait dengan domain menggunakan panggilan [DescribeDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeDomain.html)API.

    1. Masuk ke Konsol Manajemen AWS dan buka konsol VPC Amazon di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)

    1. Dari navigasi kiri, di bawah **Keamanan**, pilih **Grup Keamanan**.

    1. Filter berdasarkan grup keamanan yang terkait dengan domain. IDs 

    1. Untuk setiap kelompok keamanan: 

       1. Pilih grup keamanan. 

       1. Dari halaman detail grup keamanan, lihat **aturan Masuk**. Verifikasi bahwa lalu lintas diizinkan antar port dalam jangkauan`8192-65535`. 

    Untuk informasi selengkapnya tentang aturan grup keamanan, lihat [Mengontrol lalu lintas ke sumber daya menggunakan grup keamanan](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#working-with-security-group-rules). Untuk informasi selengkapnya tentang persyaratan untuk menggunakan Studio Classic dalam `VPCOnly` mode, lihat[Hubungkan notebook Studio di VPC ke sumber daya eksternal](studio-notebooks-and-internet-access.md).
  + **Verifikasi firewall dan WebSocket koneksi**

    Jika KernelGateway aplikasi memiliki `InService` status dan pengguna tidak dapat terhubung ke sesi notebook Studio Classic, verifikasi firewall dan WebSocket setelannya. 

    1. Luncurkan aplikasi Studio Classic. Untuk informasi selengkapnya, lihat [Luncurkan Amazon SageMaker Studio Classic](studio-launch.md). 

    1. Buka alat pengembang browser web Anda. 

    1. Pilih tab **Jaringan**. 

    1. Cari entri yang cocok dengan format berikut.

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

       Jika status atau kode respons untuk entri adalah apa pun selain`101`, maka pengaturan jaringan Anda mencegah koneksi antara aplikasi Studio Classic dan KernelGateway aplikasi.

       Untuk mengatasi masalah ini, hubungi tim yang mengelola pengaturan jaringan Anda untuk mengizinkan daftar URL Studio Classic dan mengaktifkan WebSocket koneksi.  
+ **Tidak dapat meluncurkan aplikasi yang disebabkan oleh kuota sumber daya yang terlampaui**

  Saat pengguna mencoba meluncurkan buku catatan baru, pembuatan notebook gagal dengan salah satu kesalahan berikut. Ini disebabkan oleh melebihi kuota sumber daya. 
  + 

    ```
    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 mendukung hingga empat KernelGateway aplikasi yang berjalan pada instance yang sama. Untuk mengatasi masalah ini, Anda dapat melakukan salah satu hal berikut:
    + Hapus KernelGateway aplikasi yang ada yang berjalan pada instance, lalu restart notebook baru.
    + Mulai notebook baru pada jenis instans yang berbeda

     Untuk informasi selengkapnya, lihat [Mengubah Jenis Instance untuk Notebook Amazon SageMaker Studio Classic](notebooks-run-and-manage-switch-instance-type.md).
  + 

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

    Dalam hal ini, akun tidak memiliki batasan yang cukup untuk membuat aplikasi Studio Classic pada jenis instance yang ditentukan. Untuk mengatasi ini, navigasikan ke Service Quotas konsol di [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/). Di konsol itu, minta untuk menambah `Studio KernelGateway Apps running on instance-type instance` batas. Untuk informasi selengkapnya, lihat [AWS service quotas](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). 