Memecahkan Masalah Amazon Studio Classic SageMaker

penting

Per 30 November 2023, pengalaman Amazon SageMaker Studio sebelumnya sekarang bernama Amazon SageMaker Studio Classic. Bagian berikut ini khusus untuk menggunakan aplikasi Studio Classic. Untuk informasi tentang menggunakan pengalaman Studio yang diperbarui, lihat SageMaker Studio Amazon.

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 .

AWS kebijakan terkelola untuk Amazon SageMaker AIyang 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

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.

  • 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.

• 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 DescribeDomainAPI. 

    2. Masuk ke AWS Management Console dan buka konsol Amazon EFS di https://console.aws.amazon.com/efs/.

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

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

    5. Jika target pemasangan tidak ada, tambahkan target pemasangan Amazon EFS yang hilang. Untuk petunjuknya, lihat Membuat dan mengelola target pemasangan dan grup keamanan.

    6. 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 mengatasi hal ini, perbarui JupyterLab versi default profil pengguna Anda ke JupyterLab 3.0. Untuk informasi selengkapnya tentang melihat dan memperbarui JupyterLab versi, lihatJupyterLab Pembuatan Versi.

• ConfigurationError: LifecycleConfig saat meluncurkan Studio Classic

  Anda tidak dapat melihat UI Studio Classic saat meluncurkan Studio Classic. Hal 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-langkahnyaVerifikasi proses konfigurasi siklus hidup dari Log CloudWatch .

  2. Lepaskan skrip default dari profil pengguna atau domain. Untuk informasi selengkapnya, lihat Perbarui dan lepaskan konfigurasi siklus hidup.

  3. Luncurkan aplikasi Studio Classic.

  4. 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/. 

  2. Mulai ulang Studio Classic:

     1. Matikan Studio Classic dari menu File.

     2. Tunggu satu menit.

     3. Buka kembali Studio Classic dengan menyegarkan halaman atau membukanya dari. AWS Management Console

  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 AWS Management Console.

  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

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 aplikasiIn 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 DescribeDomainAPI.

    2. Masuk ke AWS Management Console dan buka konsol VPC Amazon di. https://console.aws.amazon.com/vpc/

    3. Dari navigasi kiri, di bawah Keamanan, pilih Grup Keamanan.

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

    5. Untuk setiap kelompok keamanan:

       1. Pilih grup keamanan.

       2. Dari halaman detail grup keamanan, lihat aturan Masuk. Verifikasi bahwa lalu lintas diizinkan antar port dalam jangkauan8192-65535.

    Untuk informasi selengkapnya tentang aturan grup keamanan, lihat Mengontrol lalu lintas ke sumber daya menggunakan grup keamanan. Untuk informasi selengkapnya tentang persyaratan untuk menggunakan Studio Classic dalam VPCOnly mode, lihatHubungkan notebook Studio di VPC ke sumber daya eksternal.

  • 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 pengaturan.

    1. Luncurkan aplikasi Studio Classic. Untuk informasi selengkapnya, lihat Luncurkan Amazon SageMaker Studio Classic.

    2. Buka alat pengembang browser web Anda.

    3. Pilih tab Jaringan.

    4. 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 selain101, 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 Tipe Instance.

  • 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/. Di konsol itu, minta untuk menambah Studio KernelGateway Apps running on instance-type instance batas. Untuk informasi selengkapnya, lihat AWS service quotas.