Amazon SageMaker Studio를 시작할 수 없는 이유는 무엇입니까?

해결 방법

SageMaker Studio 시작 실패의 원인이 되는 문제를 식별하려면 Amazon CloudWatch Logs를 사용하여 애플리케이션의 오류를 검토하십시오. CloudWatch Logs를 검토하려면 다음 단계를 완료하십시오.

1. CloudWatch 콘솔을 엽니다.
2. 탐색 창의 로그에서 로그 그룹을 선택합니다.
3. 로그 그룹 페이지에서 /aws/sagemaker/studio를 검색합니다.
4. 표시되는 로그 스트림에서 시작에 실패한 애플리케이션의 로그 스트림을 선택합니다.
5. 시작 실패 기간에 해당하는 로그 스트림을 필터링합니다.
6. 오류나 예외 메시지가 있는 로그를 검토합니다.

네트워크 구성 문제로 인해 SageMaker Studio가 시작되지 않는 경우 HAR 파일을 생성하여 HTTP 오류 코드를 검토하십시오.

문제 해결을 완료합니다.

수명 주기 구성 스크립트 오류

SageMaker Studio 또는 사용자 프로파일의 도메인 수준에 잘못된 수명 주기 구성을 연결하면 애플리케이션이 시작되지 않을 수 있습니다.

수명 주기 구성 스크립트 문제를 해결하려면 다음 단계를 완료하십시오.

1. CloudWatch 콘솔을 엽니다.
2. 탐색 창의 로그에서 로그 그룹을 선택합니다.
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. 현재 브라우저에서 캐시와 쿠키를 지웁니다.
2. AWS Management Console에서 로그아웃한 다음 다시 로그인합니다.
3. SageMaker Studio 애플리케이션을 엽니다.

여전히 로딩 화면 오류 메시지가 표시되면 다른 브라우저를 사용하여 SageMaker Studio를 여십시오.

VPC 전용 모드의 SageMaker Studio의 경우 필요한 엔드포인트를 도메인의 연결된 서브넷에 연결해야 합니다. 자세한 내용은 VPC 전용 모드 사용을 위한 요구 사항을 참조하십시오.

SageMaker Studio 실행 프로그램이 나타나지 않는 경우 작업 영역을 재설정하십시오. SageMaker Studio를 시작하려고 할 때 표시되는 URL로 이동합니다. URL 끝에 ?=reset이 누락된 경우 추가한 다음 Enter 키를 누릅니다.

JupyterServer 앱 오류

JupyterServer 앱에서 문제가 발생하면 다음과 같은 메시지가 나타납니다.

"The JupyterServer app default encountered a problem and was stopped. Restart Now"

이 오류를 해결하려면 사용자의 SageMaker Studio에서 모든 앱을 삭제하십시오.

다음 단계를 완료하십시오.

1. SageMaker AI 콘솔을 엽니다.
2. 탐색 창에서 관리자 구성을 선택한 다음 도메인을 선택합니다.
3. 도메인을 선택합니다.
4. 사용자 프로파일에서 사용자를 선택합니다.
5. 사용자 세부 정보 페이지의 앱 목록에 있는 실패하지 않은 각 앱에 대해 작업을 선택합니다.
6. 드롭다운 목록에서 삭제를 선택합니다.
7. 앱 삭제 대화 상자에서 예, 앱을 삭제합니다를 선택합니다. 확인 필드에 삭제를 입력한 다음 삭제를 선택합니다.
8. 사용자의 모든 앱을 삭제한 후 앱 시작을 선택한 다음 Studio를 선택합니다.
9. 사용자 프로파일에서 각 사용자에 대해 4~8단계를 반복합니다.

SageMaker Studio가 Jupyter Notebook을 재시작합니다. 문제가 해결되지 않으면 사용자 프로파일을 제거하고 프로파일을 재생성하십시오.

참고: 사용자를 삭제하면 해당 사용자는 Amazon Elastic File System(Amazon EFS) 볼륨에 액세스할 수 없습니다. 하지만 관리자는 여전히 볼륨 데이터에 액세스할 수 있습니다.

사용자를 삭제한 후 적절한 AWS Identity and Access Management(IAM) 역할을 가진 새 사용자를 추가합니다. 그런 다음 해당 사용자로 SageMaker Studio에 액세스해 보십시오.

JupyterServer 애플리케이션을 시작할 때 "ERR_EMPTY_RESPONSE" 오류가 나타날 수 있습니다. Google Chrome 브라우저를 사용하여 웹 사이트에 액세스할 때 데이터가 전송되지 않는 경우 이 오류가 발생할 수 있습니다.

"ERR_EMPTY_RESPONSE" 오류를 해결하려면 다음 작업 중 하나 이상을 수행하십시오.

• 네트워크가 작동 중이고 안정적인지 확인합니다.
• 브라우저의 쿠키를 삭제합니다.
• 다른 브라우저를 사용합니다.
• 애플리케이션을 재생성합니다.

Amazon VPC 오류

SageMaker Studio를 시작하는 Amazon Virtual Private Cloud(Amazon VPC)에서 DHCP(Dynamic Host Configuration Protocol)를 사용하는 경우 다음과 같은 오류가 나타날 수 있습니다.

"The JupyterServer app default encountered a problem and was stopped. If you continue to experience issues, please contact Customer Service.Details: InternalFailure"

DHCP 옵션 세트를 올바르게 구성했는지 확인하려면 다음 단계를 완료하십시오.

1. Amazon VPC 콘솔을 엽니다.
2. 탐색 창에서 내 VPC를 선택합니다.
3. VPC를 선택한 다음 작업을 선택합니다.
4. DHCP 옵션 세트 편집을 선택합니다.
5. DHCP 옵션 세트의 경우 기존 옵션 세트를 선택한 다음 변경 내용 저장을 선택합니다.

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

IAM Identity Center는 SageMaker Studio와 동일한 리전에 설정해야 합니다. SageMaker AI 도메인을 온보딩하려면 IAM 인증을 위한 사용자 지정 설정 프로세스를 사용하십시오.

참고: AWS Organizations 관리 계정 또는 멤버 계정에 대해 IAM Identity Center를 활성화해야 합니다.

AWS CloudTrail 이벤트 기록

SageMaker Studio를 시작하는 데 사용하는 API 직접 호출과 관련된 권한 문제가 있는 경우 시작이 실패합니다.

권한 문제가 있는지 확인하려면 다음 단계를 완료하십시오.

1. AWS CloudTrail 콘솔을 엽니다.
2. 탐색 창에서 이벤트 기록을 선택합니다.
3. 조회 속성을 선택한 다음 드롭다운 목록에서 이벤트 소스를 선택합니다.
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를 시작합니다.