이 가이드는 Looker 웹페이지 또는 Looker API 요청에서 404 오류를 해결하는 데 도움이 됩니다. 404 오류는 일반적으로 요청된 리소스가 존재하지 않거나 사용자에게 액세스 권한이 없음을 의미합니다.
디버깅 트리
다음 의사 결정 트리를 사용하여 404 오류 문제 해결을 시작하세요.
다음 섹션에서는 트리에서 시나리오를 자세히 설명합니다.
브라우저에서 404 오류 문제 해결
브라우저의 웹페이지에 404 오류가 표시되면 이 섹션의 단계를 따르세요. 그렇지 않은 경우 API 오류 섹션을 확인하세요.
JavaScript 콘솔 확인
먼저 브라우저의 JavaScript 콘솔에서 오류에 관한 자세한 정보를 확인하세요. Google Chrome에서 JavaScript 콘솔을 열려면 다음 단계를 따르세요.
- 점 3개로 된 더보기 메뉴를 클릭합니다.
- 도구 더보기를 선택합니다.
- 개발자 도구를 클릭합니다.
- 콘솔 탭을 클릭합니다.
오류 목록에서 404 오류를 찾아 해당 URL을 찾습니다.
404를 반환하는 URL이 Looker URL이 아닌 경우 오류는 외부 리소스에서 발생합니다. 요청 URL이 Looker에 연결되는 맞춤 애플리케이션에 속하는 경우 애플리케이션의 코드와 로그를 검사하여 오류를 해결하세요. 외부 리소스 문제에 대한 Looker 지원은 제한적입니다.
URL이 Looker URL인 경우 다음 섹션으로 계속 진행합니다.
URL에 오타가 있는지 확인
URL에 흔한 오타가 있는지 확인합니다. 예를 들면 다음과 같습니다.
- Look 페이지의 일반적인 오타는
/look/123입니다. 올바른 구문은/looks/123입니다. - 대시보드 페이지의 일반적인 오타는
/dashboard/123입니다. 올바른 구문은/dashboards/123입니다.
LookML에 Explore, Look 또는 대시보드 링크를 포함하는 경우 항상 먼저 링크를 테스트하여 구문이 올바른지 확인하세요.
LookML에서 생성된 링크에 오타가 있는 경우 LookML에서 오타를 수정하세요. Looker에서 생성된 URL (예: UI 탐색 요소)에 오타가 있는 경우 지원팀에 문의하여 제품에서 URL을 수정해 달라고 요청하세요.
API의 404 오류 문제 해결
오류가 Looker API 호출에 대한 응답으로 표시되면 이 섹션의 단계를 따르세요.
API 엔드포인트 문서 검토
404 오류를 반환하는 API 엔드포인트의 문서를 찾아봅니다. 예를 들어 create_sso_embed_url 엔드포인트의 문서 페이지는 서명된 삽입 URL 만들기입니다. 매개변수를 확인하고 API 호출에 올바른 매개변수를 제공하고 있는지 확인합니다.
요청 동사와 경로가 올바른지 확인합니다. 예를 들어 /api/4.0/embed/sso_url 엔드포인트는 POST 동사와 함께 사용해야 합니다.
API 탐색기를 사용하여 인스턴스에서 직접 API 엔드포인트를 테스트할 수도 있습니다.
필수 엔드포인트 조건 확인
일부 엔드포인트는 특정 조건에서만 사용할 수 있습니다.
- 일부 LookML 프로젝트 엔드포인트 (예:
create_project,deploy_to_production,reset_project_to_production)는 개발 모드에서만 사용할 수 있습니다.- 필요한 경우 요청 본문
{"workspace_id": "dev"}와 함께update_session엔드포인트를 사용하여 API 세션을 개발 모드로 전환합니다.
- 필요한 경우 요청 본문
reset_project_to_production엔드포인트는 공유 브랜치에서 사용할 수 없습니다.deploy_ref_to_production엔드포인트는 고급 배포 모드가 사용 설정된 경우에만 사용할 수 있습니다.
웹훅 설정 확인
요청 URL이 배포 웹훅인 경우 웹훅 설정을 확인하세요.
웹훅을 사용하여 특정 브랜치 또는 참조를 배포하는 경우 프로젝트에서 고급 배포 모드를 사용 설정합니다.
프로젝트에서 웹훅 배포 보안 비밀이 사용 설정된 경우 요청에 보안 비밀을 포함해야 합니다.
요청된 리소스가 있는지 확인
요청에서 참조되는 모든 리소스가 Looker 인스턴스에 실제로 있는지 확인합니다.
요청 URL 및 본문의 모든 값 (예: 폴더 ID 또는 대시보드 ID)이 유효한 기존 리소스를 참조하는지 확인합니다. 예를 들어 대시보드가 있는지 확인하려면 관리자 사용자로 /dashboards/[id]로 이동합니다. 리소스가 누락되었거나 잘못된 경우 누락된 리소스를 만들거나 기존 리소스를 지정합니다.
리소스가 있지만 404 오류가 계속 표시되면 개발 모드에 리소스가 있는지 확인합니다. Looker 사용자에게 develop 권한이 있는 경우 개발 모드를 입력할 때 리소스에 액세스할 수 있는지 확인합니다. API 호출의 경우 요청 본문 {"workspace_id": "dev"}과 함께 update_session 엔드포인트를 사용하여 API 세션을 개발 모드로 전환합니다.
사용자에게 develop 권한이 없는 경우 LookML 프로젝트를 프로덕션에 배포한 후 액세스할 수 있는지 확인해 보세요.
사용자 권한 및 콘텐츠 액세스 설정 확인
리소스가 있지만 사용자에게 404 오류가 계속 표시되면 사용자의 권한과 콘텐츠 액세스를 확인하세요.
사용자로 가장하여 오류 확인
관리자인 경우 관리 > 사용자 패널로 이동하여 404 오류가 발생하는 사용자를 가장 (sudo)합니다.
- 사용자가 삽입 사용자인 경우 관리 > 사용자 페이지의 삽입 사용자 인증 정보가 삽입 로그인 URL의
external_user_id와 일치하는지 확인합니다. - 사용자가 API 호출을 하는 경우
login_user엔드포인트를 사용하여 사용자를 가장합니다.
사용자로 가장하는 동안 404 오류가 표시되지만 관리자로 리소스를 볼 때는 표시되지 않는 경우 사용자에게 권한 또는 콘텐츠 액세스 설정이 부족할 수 있습니다.
필수 권한 확인
관리 > 사용자 패널에서 사용자의 역할과 Looker의 권한 목록을 확인하여 사용자에게 역할 중 하나에 필요한 권한이 있는지 확인합니다. 예를 들어 대시보드를 보려면 사용자에게 최소한 access data, see_looks, see_user_dashboards 권한이 있어야 합니다. 사용자에게 필요한 권한이 없는 경우 해당 사용자에게 할당된 역할의 권한 세트에 해당 권한을 추가합니다.
필요한 권한이 모델별로 있는 경우 필요한 권한이 있는 사용자 역할 중 하나의 모델 세트에 LookML 모델이 포함되어 있는지 확인합니다. 그렇지 않으면 사용자에게 할당된 역할 중 하나의 모델 세트에 모델을 추가합니다.
유효한 삽입 권한 확인
사용자가 서명된 삽입 사용자라면 필요한 권한이 유효한 삽입 권한인지 확인합니다. 그렇지 않으면 삽입된 사용자가 요청을 성공적으로 수행할 수 없습니다. 예를 들어 삽입 사용자에게는 see_lookml 권한을 할당할 수 없습니다.
액세스 권한 확인
콘텐츠가 required_access_grants이 정의된 Explore를 기반으로 하는 경우 LookML 프로젝트에서 access_grant 정의를 확인하세요. 지정된 사용자 속성의 사용자의 사용자 속성 값을 액세스 권한 부여에 필요한 값 중 하나로 수정합니다.
콘텐츠 액세스 확인
요청된 리소스가 폴더에 저장되어 있는 경우 해당 폴더의 콘텐츠 액세스 설정을 확인합니다. Look, 대시보드, Looker Studio 보고서는 모두 폴더에 저장됩니다.
최종 검토 및 지원
404 오류가 계속 발생하면 이 페이지의 문제 해결 단계를 검토하세요. 그래도 404 오류를 해결할 수 없는 경우 지원팀에 문의하세요.