為什麼我無法啟動 Amazon SageMaker Studio？

解決方法

若要確定導致 SageMaker Studio 啟動失敗的問題，請使用 Amazon CloudWatch Logs 檢查應用程式中是否有錯誤。若要查看 CloudWatch 日誌，請完成以下步驟：

1. 開啟 CloudWatch console (CloudWatch 主控台)。
2. 在導覽窗格中的 Logs 下，選擇 Log Groups (日誌群組)。
3. 在 Log Groups (日誌群組) 頁面上，搜尋 /aws/sagemaker/studio。
4. 在出現的日誌串流中，選取啟動失敗的應用程式的日誌串流。
5. 根據啟動失敗的時間範圍來篩選日誌串流。
6. 查看包含錯誤或例外狀況訊息的日誌。

如果您的 SageMaker Studio 因網路設定問題而無法啟動，請產生 HAR 檔案以查看 HTTP 錯誤代碼。

完成您問題的解決方案。

生命週期組態指令碼錯誤

如果您將錯誤的生命週期組態附加到 SageMaker Studio 或使用者設定檔的網域層級，則應用程式可能無法啟動。

若要解決生命週期組態指令碼問題，請完成以下步驟：

1. 開啟 CloudWatch console (CloudWatch 主控台)。
2. 在導覽窗格中的 Logs 下，選擇 Log Groups (日誌群組)。
3. 在搜尋列中輸入 /aws/sagemaker/studio，然後選取結果。
4. 在出現的日誌串流中，選擇 [domain-id]/[user-profile-name]/[app-type]/[app-name]/LifecycleConfigOnStart。
5. 根據啟動失敗的時間範圍來篩選日誌串流。
6. 確定錯誤後，分離現有的生命週期指令碼。
7. 建立並附加新的生命週期指令碼。

載入畫面錯誤

如果載入畫面沒有回應，那麼您會收到以下訊息：

"The loading screen is taking too long. (載入畫面時間過長。Would you like to clear the workspace or keep waiting" (您想清理工作區還是繼續等待)

若要解決此錯誤，請完成以下步驟：

1. 清除目前瀏覽器中的快取和 Cookie。
2. 登出 AWS 管理主控台，然後重新登入。
3. 開啟您的 SageMaker Studio 應用程式。

如果您仍然收到載入畫面錯誤訊息，請使用其他瀏覽器開啟 SageMaker Studio。

對於僅限 VPC 模式下的 SageMaker Studio，請確保將所需的端點附加到網域的關聯子網路。如需詳細資訊，請參閱使用僅限 VPC 模式的要求。

如果 SageMaker Studio 啟動器未出現，請重設您的工作區。前往您嘗試啟動 SageMaker Studio 時看到的網址。如果網址末尾缺少 ?=reset，請新增該字元，然後按下 Enter。

JupyterServer 應用程式錯誤

如果 JupyterServer 應用程式遇到問題，您會收到以下訊息：

"The JupyterServer app default encountered a problem and was stopped.Restart Now" (JupyterServer 應用程式預設遇到問題並已停止。立即重新啟動)

若要解決此錯誤，請從 SageMaker Studio 中刪除使用者的所有應用程式。

請完成下列步驟：

1. 開啟 SageMaker AI console (SageMaker AI 主控台)。
2. 在導覽窗格中，選擇 Admin configurations (管理員組態)，然後選擇 Domains (網域)。
3. 選取您的網域。
4. 在 User profiles (使用者設定檔) 下，選取一個使用者。
5. 在 User Details (使用者詳細資料) 頁面上，為應用程式清單中每個未失敗的應用程式選擇 Action (動作)。
6. 從下拉式清單中選擇 Delete (刪除)。
7. 在 Delete app (刪除應用程式) 對話方塊中，選擇 Yes, delete app (是，刪除應用程式)。在確認欄位中，輸入刪除，然後選擇 Delete (刪除)。
8. 刪除使用者的所有應用程式後，選擇 Launch app (啟動應用程式)，然後選擇 Studio。
9. 對 User profiles (使用者設定檔) 下的每位使用者重複步驟 4-8。

SageMaker Studio 會重新啟動 Jupyter 筆記本。如果問題仍未解決，請刪除使用者設定檔並重新建立設定檔。

**注意：**如果您刪除某個使用者，則該使用者將無法存取 Amazon Elastic File System (Amazon EFS) 磁碟區。但是，管理員仍然可以存取磁碟區資料。

刪除使用者後，新增具有適當 AWS Identity and Access Management (IAM) 角色的新使用者。然後，嘗試使用該使用者存取 SageMaker Studio。

當您啟動 JupyterServer 應用程式時，您可能會收到 "ERR_EMPTY_RESPONSE" 錯誤。如果您使用 Google Chrome 瀏覽器造訪網站且資料未傳輸，那麼您可能會收到此錯誤。

若要解決 "ERR_EMPTY_RESPONSE" 錯誤，請採取下列一項或多項動作：

• 檢查您的網路是否正常運作且穩定。
• 清除瀏覽器的 Cookie。
• 使用不同的瀏覽器。
• 重新建立應用程式。

Amazon VPC 錯誤

如果您啟動 SageMaker Studio 的 Amazon Virtual Private Cloud (Amazon VPC) 使用動態主機組態協定 (DHCP)，那麼您可能會收到下列錯誤：

"The JupyterServer app default encountered a problem and was stopped.If you continue to experience issues, please contact Customer Service.Details: InternalFailure」(JupyterServer 應用程式預設遇到問題並已停止。(JupyterServer 應用程式預設遇到問題並已停止。如果您持續遇到問題，請聯絡客戶服務。詳細資訊：InternalFailure)

若要確認您是否正確設定了 DHCP 選項集，請完成下列步驟：

1. 開啟 Amazon VPC console (Amazon VPC 主控台)。
2. 在導覽窗格，選擇 Your VPCs (您的 VPC)。
3. 選取您的 VPC，然後選擇 Actions (動作)。
4. 選擇 Edit DHCP option set (編輯 DHCP 選項集)。
5. 在 DHCP options set (DHCP 選項集)，選擇任意現有選項集，然後選擇 Save changes (儲存變更)。

IAM Identity Center 錯誤

如果您的 SageMaker Studio 與 AWS IAM Identity Center 位於不同的 AWS 區域，您會收到下列錯誤：

"You're attempting to set up Studio with SSO authentication in Europe (Frankfurt).Your AWS SSO is configured in Europe (Ireland).You must set up Studio in the same Region as AWS SSO or choose IAM authentication." (您正嘗試在歐洲 (法蘭克福) 使用 SSO 認證來設定 Studio。但您的 AWS SSO 是在歐洲 (愛爾蘭) 中設定的。您必須在與 AWS SSO 相同的區域中設定 Studio，或選擇 IAM 驗證。)

IAM Identity Center 必須與 SageMaker Studio 在相同區域設定。若要加入您的 SageMaker AI 網域，請使用自訂設定程序進行 IAM 驗證。

**注意：**請務必為您的 AWS Organizations 管理帳戶或會員帳戶啟動 IAM Identity Center。

AWS CloudTrail 事件歷史記錄

如果與啟動 SageMaker Studio 所使用的 API 呼叫相關的權限出現問題，則啟動將會失敗。

若要確定權限是否有問題，請完成以下步驟：

1. 開啟 AWS CloudTrail console (AWS CloudTrail 主控台)。
2. 在導覽窗格中，選擇 Event History (事件歷史記錄)。
3. 選擇 Lookup Attributes (尋找屬性)，然後從下拉式清單中選擇 Event Source (事件來源)。
4. 選取 sagemaker.amazonaws.com。
5. 事件載入後，尋找在您嘗試啟動 SageMaker Studio 時發生的失敗 CreateApp 事件，然後選擇該事件。
6. 查看錯誤訊息以確定缺少的權限。例如，您可能會看到類似以下的錯誤訊息 "PermissionError : User "XYZ" is not authorized to perform sagemaker:CreateApp on this resource resource_ARN"。
7. 為您的使用者身分新增所需的權限，然後啟動 Studio SageMaker。