Looker 모바일 애플리케이션 문제 해결

Looker 모바일 애플리케이션을 사용하면 Android 및 iOS 기기에서 Looker 및 데이터 스튜디오 Pro 콘텐츠에 액세스하고, Look 및 대시보드를 보고, 이동 중에 공동작업할 수 있습니다. 로그인 문제, 렌더링 오류, 애플리케이션 비정상 종료, 성능 지연, 표시 불일치 등 모바일 애플리케이션을 사용하는 중에 문제가 발생하면 이 가이드에서 문제를 해결하는 데 도움을 받을 수 있습니다.

기본 요건 및 일반적인 구성 요구사항

문제 해결을 시작하기 전에 환경과 계정이 Looker 모바일 애플리케이션 사용을 위한 필수 요건을 충족하는지 확인하세요.

  • 모바일 애플리케이션 액세스 사용 설정: Looker 관리자가 인스턴스에 대해 모바일 애플리케이션 액세스를 사용 설정해야 합니다.
  • 사용자 권한: 사용자 계정에 mobile_app_access Looker 권한이 직접 또는 사용자 그룹을 통해 할당되어 있어야 합니다.
  • 지원되는 인스턴스: Looker 모바일 애플리케이션은 Looker(Google Cloud 핵심 서비스)(공개 IP 또는 비공개 서비스 액세스나 Private Service Connect를 통해 액세스할 수 있는 비공개 IP(회사 VPN을 통해 액세스)) 및 Looker(원본)(Looker 호스팅 및 고객 호스팅) 인스턴스를 지원합니다.
  • 회사 VPN 및 IP 허용 목록: Looker 인스턴스에서 IP 허용 목록을 적용하는 경우 모바일 기기가 인스턴스 IP 허용 목록에 있는 고정 IP 주소를 사용하여 회사 VPN을 통해 연결되어야 합니다.
  • 지원되는 인증: Looker 모바일 애플리케이션은 Google OAuth, SAML, LDAP, OpenID Connect, 이메일 및 비밀번호 사용자 인증 정보를 지원합니다. QR 코드를 사용한 로그인은 Looker Mobile (기존) 애플리케이션에서만 지원되며 삽입 SSO가 사용 설정되어 있어야 합니다.

디버깅 트리

다음 결정 트리를 사용하여 Looker 모바일 애플리케이션 문제 해결을 시작하세요.

다음 섹션에서는 트리에서 시나리오를 자세히 설명합니다.

설치된 모바일 애플리케이션 식별

Looker 모바일 애플리케이션과 Looker Mobile (기존) 애플리케이션이 모두 앱 스토어에서 제공되므로 첫 번째 문제 해결 단계는 휴대기기에 설치된 애플리케이션을 확인하는 것입니다. 지원팀의 초기 분류 단계에서는 잘못된 경로로 이동하거나 지연된 조사를 방지하기 위해 이 구분을 사용합니다.

  • Looker: Looker 및 데이터 스튜디오 Pro 콘텐츠를 위한 현재 통합 모바일 애플리케이션입니다. 기기 홈 화면과 앱 스토어에서 이 앱의 이름은 Looker입니다. 표준 인증 방법 (예: Google OAuth, SAML, OpenID Connect, LDAP, 이메일 및 비밀번호 사용자 인증 정보)을 지원하며 QR 코드 로그인은 지원하지 않습니다. 이 문제 해결 가이드에서는 주로 이 애플리케이션을 다룹니다.
  • Looker Mobile (기존): 이전 모바일 애플리케이션입니다. 기기 홈 화면과 앱 스토어에서 이 앱의 이름은 Looker Mobile(기존) (또는 Looker Mobile)입니다. QR 코드와 이메일 및 비밀번호 로그인을 지원하지만 Google OAuth, SAML 또는 Looker (Google Cloud 핵심 서비스) 인스턴스는 지원하지 않습니다.

기기에 설치된 애플리케이션을 확인하려면 다음 단계를 따르세요.

  1. 기기 홈 화면이나 앱 런처에서 앱 아이콘 아래에 표시된 애플리케이션 이름을 확인합니다.
  2. 모바일 애플리케이션에서 하단 탐색 메뉴의 더보기를 선택하거나 설정을 열고 메뉴 하단에서 애플리케이션 이름과 버전 번호를 찾습니다.
  3. Apple App Store (iOS) 또는 Google Play 스토어 (Android)에서 설치된 앱 목록을 확인합니다.

Looker 모바일 (기존)이 설치된 경우 이 애플리케이션에 대한 지원이 2027년 1월 31일에 종료되고 애플리케이션이 목록에서 삭제됩니다. 현재 Looker 모바일 애플리케이션으로 마이그레이션하는 것이 좋습니다. 기존 애플리케이션의 문서 및 문제 해결은 Looker 모바일 (기존) 애플리케이션 가이드를 참고하세요.

Looker 모바일 애플리케이션이 설치되어 있는 경우 다음 섹션의 문제 해결 단계를 진행하세요.

모바일 애플리케이션 외부에서 문제가 재현되는지 확인

문제 해결의 첫 번째 단계는 문제가 모바일 애플리케이션에만 국한되는지 아니면 Looker 웹 애플리케이션에도 영향을 미치는지 확인하는 것입니다.

데스크톱 또는 모바일 웹브라우저를 열고 Looker 인스턴스에 로그인한 후 동일한 작업을 수행해 보세요.

  • 웹브라우저를 통해 로그인할 수 있나요? 웹브라우저에서 로그인할 수 없는 경우 문제는 모바일 애플리케이션에 국한되지 않습니다. 사용자 인증 정보, ID 공급업체 (IdP) 구성 또는 사용자 계정 상태를 확인하세요.
  • 웹브라우저에서 쿼리 또는 대시보드가 로드되나요? 대시보드 또는 Look이 로드되지 않거나, 데이터베이스 오류가 반환되거나, 브라우저에서 시간이 초과되면 문제는 모바일 애플리케이션이 아닌 기본 쿼리, 데이터베이스 연결 또는 LookML 모델에서 발생합니다.
  • 콘텐츠에 액세스할 권한이 있나요? 웹 인터페이스에서 콘텐츠를 볼 수 없는 경우 적절한 폴더, 모델, 탐색 액세스 권한이 있는지 확인하세요.

웹브라우저에서도 문제가 재현되는 경우 Looker 인스턴스에서 문제를 해결하세요.

문제가 모바일 애플리케이션에서만 발생하는 경우 이 가이드의 관련 섹션으로 이동하세요.

로그인 문제 해결하기

Looker 모바일 애플리케이션에 로그인할 수 없는 경우 다음과 같은 일반적인 원인을 조사하세요.

  • 인스턴스 URL 형식: 모바일 앱에 인스턴스 URL을 입력할 때는 instance_name.looker.com 형식 또는 커스텀 도메인을 사용하세요. https://, http:// 또는 후행 슬래시는 포함하지 마세요.
  • 인스턴스 사용 설정: Looker 관리자에게 문의하여 관리 > 일반 > 모바일 애플리케이션에서 모바일 애플리케이션 액세스가 사용 설정되어 있는지 확인합니다.
  • 사용자 권한: 관리자에게 사용자 역할 또는 그룹에 mobile_app_access 권한이 포함되어 있는지 확인합니다.
  • 회사 VPN 및 IP 허용 목록: 인스턴스에서 IP 허용 목록을 적용하는 경우 모바일 기기가 조직의 VPN에 연결되어 있고 VPN 서버의 고정 IP 주소가 인스턴스의 IP 허용 목록에 있는지 확인합니다. VPN에 연결된 상태에서 동일한 모바일 기기의 웹브라우저에서 인스턴스 URL을 열어 이를 테스트합니다.
  • 고객 호스팅 API 구성: 고객 호스팅 Looker(원래) 인스턴스를 사용하는 경우 인스턴스의 API 호스트 URL(관리 > 플랫폼 > API)이 인스턴스 호스트 이름과 일치하는지 확인합니다. 또한 네트워크에서 포트 443 또는 포트 19999의 모바일 트래픽을 허용하는지 확인합니다. 자세한 내용은 고객 호스팅 인스턴스 고려사항 및 Looker API 문제 해결 문서 페이지를 참고하세요.
  • 생체 인식 로그인: 생체 인식 인증 (지문 또는 얼굴 인식)에 실패하면 표준 사용자 이름과 비밀번호를 사용하여 로그인합니다. 앱의 설정 메뉴의 보안에서 생체 인식 인증을 재구성할 수 있습니다. 모바일 기기의 시스템 설정에서도 생체 인식을 사용 설정해야 합니다.

QR 코드 로그인 문제

통합 Looker 모바일 애플리케이션은 QR 코드를 사용한 로그인을 지원하지 않습니다. 대신 표준 인증 (Google OAuth, SAML, LDAP, OpenID Connect 또는 이메일 및 비밀번호)을 사용하세요.

Looker 모바일 (기존) 애플리케이션을 사용 중이고 QR 코드로 로그인할 수 없는 경우 다음을 조사하세요.

  • SSO 인증 삽입: Looker 웹 인터페이스에서 관리 > 플랫폼 > 삽입으로 이동하여 SSO 인증 삽입이 사용 설정되어 있는지 확인합니다. 이 설정은 QR 코드 로그인 옵션을 사용 설정합니다.
  • QR 코드 새로고침: QR 코드는 시간에 민감합니다. QR 코드가 표시된 웹페이지를 새로고침한 다음 새로 생성된 QR 코드를 스캔해 보세요.
  • 카메라 권한 및 가시성: 모바일 애플리케이션에 기기 카메라에 액세스할 수 있는 권한이 있는지 확인하고 화면을 스캔할 때 조명이 충분한지 확인합니다.
  • 대체 로그인: QR 코드 인증이 계속 실패하면 이메일 및 비밀번호 사용자 인증 정보를 사용하여 로그인하거나 업데이트된 Looker 모바일 애플리케이션으로 이전하세요.

콘텐츠 렌더링 문제 해결

대시보드 또는 Look이 렌더링되지 않거나, 빈 카드가 표시되거나, 모바일 애플리케이션에 오류 메시지가 표시되면 다음을 조사하세요.

  • 문제 범위: 렌더링 실패가 모든 콘텐츠에 영향을 미치는지 아니면 특정 Look 또는 대시보드에만 영향을 미치는지 확인합니다.
    • 모든 콘텐츠가 실패하는 경우: 모바일 기기 네트워크 연결을 확인하고 세션이 만료되지 않았는지 확인한 후 애플리케이션에서 로그아웃했다가 다시 로그인해 보세요.
    • 특정 콘텐츠가 실패함: 콘텐츠에서 맞춤 시각화 또는 지원되지 않는 레이아웃 형식을 사용하는지 확인합니다. 기본 모델과 탐색 분석에 액세스할 수 있는지 확인합니다.
  • 오류 메시지 검사: 오류 배너 또는 타일 오류가 표시되면 특정 메시지를 기록합니다. 일반적인 문제로는 데이터베이스 연결 오류, 쿼리 시간 초과 또는 필드 참조 누락이 있습니다.
  • 간헐적 실패와 지속적 실패: 콘텐츠가 간헐적으로 실패하는 경우 데이터베이스 로드 또는 일시적인 네트워크 변동과 관련이 있을 수 있습니다.
  • 새로고침을 위해 풀: 새로고침을 위해 풀 동작 (화면에서 아래로 풀)을 사용하여 대시보드 또는 Look을 새로고침하고 새 쿼리를 실행합니다.

애플리케이션 비정상 종료 문제 해결

Looker 모바일 애플리케이션이 비정상 종료되거나 예기치 않게 닫히는 경우 다음 문제 해결 단계를 따르세요.

  • 비정상 종료 트리거 식별: 비정상 종료가 발생하는 시점을 기록합니다. 앱이 실행 시, 특정 대시보드 열기 시, 기기를 세로 모드와 가로 모드 간에 회전할 때 또는 특정 사용자 상호작용 후에 즉시 비정상 종료되나요?
  • 애플리케이션 업데이트: Apple App Store 또는 Google Play 스토어에서 최신 버전의 Looker 모바일 앱을 실행하고 있는지 확인합니다. 업데이트에는 안정성 개선사항과 버그 수정이 포함되는 경우가 많습니다.
  • 기기 운영체제 업데이트: 모바일 기기가 지원되는 버전의 iOS 또는 Android를 실행하고 있는지 확인합니다. 오래된 운영체제는 호환성 문제를 일으킬 수 있습니다.
  • 캐시 삭제 및 다시 시작:
    • 애플리케이션을 강제 종료하고 다시 엽니다.
    • 휴대기기를 다시 시작합니다.
    • Android에서 설정 > 앱 > Looker > 저장소 > 캐시 지우기에서 애플리케이션 캐시를 지웁니다.
  • 애플리케이션 재설치: 앱을 제거하고 기기를 다시 시작한 후 공식 앱 스토어에서 애플리케이션을 재설치합니다.

성능 및 지연 시간 문제 해결

Looker 모바일 애플리케이션이 느리거나 응답하지 않거나 콘텐츠를 로드하는 데 시간이 오래 걸리는 경우 다음을 조사하세요.

  • 느린 구성요소 식별: 앱을 실행하거나, 폴더와 보드를 탐색하거나, 캐시된 콘텐츠 목록을 로드하거나, 대시보드 타일의 쿼리를 실행할 때 지연이 발생하는지 확인합니다.
  • 목록 캐싱: 모바일 애플리케이션은 최근에 본 콘텐츠와 즐겨찾기 콘텐츠의 목록을 캐시하여 탐색 속도를 높입니다. 앱을 실행하면 목록이 자동으로 새로고침되지만 목록이 오래된 것으로 표시되면 아래로 드래그하여 수동으로 새로고침할 수 있습니다.
  • 대시보드 복잡성 및 타일 수: 타일이 많거나 시각화 유형이 복잡한 대시보드는 휴대기기에서 상당한 메모리 및 처리 리소스가 필요합니다. 더 작은 대시보드나 개별 Look이 더 빠르게 로드되는지 테스트합니다.
  • 네트워크 속도 및 지연 시간: 모바일 네트워크에서 지연 시간이 길거나 패킷 손실이 발생할 수 있습니다. 안정적인 고속 Wi-Fi 네트워크에 연결했을 때 성능이 향상되는지 테스트합니다.
  • 데이터베이스 쿼리 성능: 개별 타일이 렌더링되는 데 시간이 오래 걸리는 경우 Looker 웹 인터페이스 또는 시스템 활동에서 쿼리 기간을 확인합니다. 지연은 장기 실행 데이터베이스 쿼리로 인해 발생할 수 있습니다.

디스플레이 및 스타일 문제 해결

요소의 정렬이 잘못되었거나, 아이콘이 깨졌거나, 이미지가 왜곡되었거나, 패딩이 예상치 못한 경우와 같은 시각적 결함이 발생하면 다음을 조사하세요.

  • 화면 방향: 대시보드 또는 Look을 세로 및 가로 방향으로 모두 테스트합니다. 일부 복잡한 대시보드와 표는 더 넓은 가로 모드 보기에 최적화되어 있습니다.
  • 대시보드 레이아웃: 모바일 친화적인 대시보드는 작은 화면에 맞게 타일 위치를 동적으로 조정합니다. 타일이 겹치거나 텍스트가 잘리면 웹 애플리케이션의 대시보드 수정 모드에서 타일 크기와 구성을 확인합니다.
  • 기기 디스플레이 설정: 맞춤 시스템 글꼴 크기, 디스플레이 확대/축소, 서드 파티 어두운 모드 반전 도구와 같은 접근성 설정은 콘텐츠가 렌더링되는 방식을 변경할 수 있습니다. 기본 시스템 디스플레이 설정으로 테스트합니다.
  • 시각적 문서: 렌더링 불일치를 명확하게 보여주는 스크린샷이나 화면 녹화 동영상을 찍어 관리자나 지원팀과 공유합니다.

진단 정보 수집

문제 해결 단계를 따른 후에도 문제를 해결할 수 없는 경우 지원팀에 문의하기 전에 다음 정보를 수집하세요.

  1. Looker 인스턴스 정보:
    • 인스턴스 URL (예: instance_name.looker.com)
    • Looker 출시 버전 (웹 애플리케이션에서 도움말 > 정보 선택)
    • 인스턴스 호스팅 유형 (Looker 호스팅 또는 고객 호스팅, Looker (Google Cloud 핵심 서비스) 또는 Looker (원본))
  2. 모바일 애플리케이션 정보:
    • 설치된 앱: Looker 모바일 앱 또는 Looker Mobile (기존)을 설치했는지 지정합니다.
    • 애플리케이션 버전 번호 (인앱 더보기 메뉴 하단 또는 설정에 있음)
    • 애플리케이션이 설치된 앱 스토어 (Apple App Store 또는 Google Play 스토어)입니다.
  3. 기기 및 운영체제 세부정보:
    • 기기 제조업체 및 모델 (예: Google Pixel 8, iPhone 15 Pro)
    • 운영체제 버전 (예: Android 14, iOS 17.5)
  4. 범위 및 영향:
    • 문제가 모든 사용자에게 영향을 미치나요 아니면 특정 사용자 계정에만 영향을 미치나요?
    • 문제가 모든 휴대기기에서 발생하나요, 아니면 특정 기기 모델이나 운영체제 버전에서만 발생하나요?
  5. 시각적 예시 및 로그:
    • 예상치 못한 동작 또는 오류 메시지를 보여주는 스크린샷 또는 화면 녹화
    • 문제를 재현하는 정확한 단계

지원팀에 문의

이전 단계를 모두 확인했는데도 문제가 해결되지 않으면 다음 단계를 따르세요.