排解 Looker 行動應用程式問題

透過 Looker 行動應用程式，您可以在 Android 和 iOS 裝置上存取 Looker 和數據分析 Pro 內容、查看 Look 圖表和資訊主頁，以及隨時隨地進行協作。如果使用行動應用程式時遇到問題 (例如登入問題、轉譯錯誤、應用程式當機、效能延遲或顯示差異)，請參閱本指南進行疑難排解並解決問題。

事前準備和常見設定需求

開始疑難排解前，請確認您的環境和帳戶符合使用 Looker 行動應用程式的先決條件：

  • 啟用行動應用程式存取權：Looker 管理員必須為執行個體啟用行動應用程式存取權。
  • 使用者授權：您的使用者帳戶必須直接或透過使用者群組指派 mobile_app_access Looker 權限。
  • 支援的執行個體：Looker 行動應用程式支援 Looker (Google Cloud Core) (公開 IP，或使用私人服務存取權或 Private Service Connect 的私人 IP，可透過公司 VPN 存取) 和 Looker (原始版) 執行個體 (由 Looker 代管和客戶託管)。
  • 公司 VPN 和 IP 許可清單：如果 Looker 執行個體強制執行 IP 許可清單，行動裝置必須透過公司 VPN 連線，且該 VPN 的靜態 IP 位址必須位於執行個體 IP 許可清單中。
  • 支援的驗證方式：Looker 行動應用程式支援 Google OAuth、SAML、LDAP、OpenID Connect，以及電子郵件和密碼憑證。使用 QR code 登入僅支援舊版 Looker Mobile 應用程式，且必須啟用嵌入式單一登入。

偵錯樹狀結構

請使用下列決策樹，開始排解 Looker 行動應用程式問題：

以下各節將詳細說明樹狀結構中的情境。

找出已安裝的行動應用程式

由於 Looker 行動應用程式和 Looker Mobile (舊版) 應用程式都可在應用程式商店中下載，因此第一個疑難排解步驟是判斷行動裝置上安裝了哪個應用程式。支援團隊的初步分類步驟會依據這項區別，避免調查遭到誤導或延遲：

  • Looker：目前適用於 Looker 和 Data Studio Pro 內容的統一行動應用程式。在裝置主畫面和應用程式商店中，這個應用程式的名稱為「Looker」。支援標準驗證方式 (例如 Google OAuth、SAML、OpenID Connect、LDAP，以及電子郵件和密碼憑證)，但不支援 QR code 登入。本疑難排解指南主要涵蓋這個應用程式。
  • Looker Mobile (舊版)：舊版行動應用程式。在裝置主畫面和應用程式商店中，這個應用程式的名稱為「Looker Mobile (舊版)」 (或「Looker Mobile」)。支援 QR code、電子郵件和密碼登入，但不支援 Google OAuth、SAML 或 Looker (Google Cloud Core) 執行個體。

如要判斷裝置上安裝的是哪個應用程式，請按照下列步驟操作：

  1. 在裝置主畫面或應用程式啟動器中，查看應用程式圖示下方顯示的應用程式名稱。
  2. 在行動應用程式中，選取底部導覽選單中的「更多」，或開啟「設定」，然後在選單底部找到應用程式名稱和版本號碼。
  3. 在 Apple 應用程式商店 (iOS) 或 Google Play 商店 (Android) 中查看已安裝版應用程式清單。

如果已安裝 Looker Mobile (舊版)，這項應用程式的支援服務將於 2027 年 1 月 31 日終止，且應用程式會從市集下架。Google 強烈建議您遷移至目前的 Looker 行動應用程式。如需舊版應用程式的說明文件和疑難排解資訊，請參閱「Looker Mobile (舊版) 應用程式」指南。

如果已安裝 Looker 行動應用程式，請按照下列各節的疑難排解步驟操作。

確認問題是否會在行動應用程式以外的環境重現

疑難排解的第一步是判斷問題是否只影響行動應用程式，還是也會影響 Looker 網頁應用程式。

開啟電腦或行動裝置的網路瀏覽器，登入 Looker 執行個體，然後嘗試執行相同動作：

  • 是否能透過網路瀏覽器登入？如果無法透過網路瀏覽器登入，問題就不是行動應用程式特有的。檢查憑證、識別資訊提供者 (IdP) 設定或使用者帳戶狀態。
  • 查詢或資訊主頁是否會在網路瀏覽器中載入？如果無法載入資訊主頁或 Look、傳回資料庫錯誤，或在瀏覽器中逾時，問題是源自於基礎查詢、資料庫連線或 LookML 模型，而非行動應用程式。
  • 你是否有權存取該內容？如果無法在網頁介面中查看內容，請確認您擁有適當的資料夾、模型和探索存取權限。

如果問題也會在網路瀏覽器中重現，請在 Looker 執行個體上排解問題。

如果問題只發生在行動應用程式中，請參閱本指南的相關章節。

排解登入問題

如果無法登入 Looker 行動應用程式，請調查下列常見原因：

  • 執行個體網址格式：在行動應用程式中輸入執行個體網址時，請使用 instance_name.looker.com 格式或自訂網域。請勿加入 https://、http:// 或結尾斜線。
  • 啟用執行個體：請向 Looker 管理員確認「管理」>「一般」>「行動應用程式」下是否已啟用行動應用程式存取權。
  • 使用者授權：請系統管理員確認您的使用者角色或群組是否具備 mobile_app_access 權限。
  • 公司 VPN 和 IP 許可清單：如果執行個體強制執行 IP 許可清單，請確認行動裝置已連上貴機構的 VPN，且 VPN 伺服器的靜態 IP 位址位於執行個體的 IP 許可清單中。 如要測試，請在連上 VPN 的同一部行動裝置上，透過網路瀏覽器開啟執行個體網址。
  • 客戶託管的 API 設定：如果您使用客戶託管的 Looker (原始版) 執行個體，請確認「管理」>「平台」>「API」下的執行個體 API 主機網址與執行個體主機名稱相符。此外，請確認網路允許通訊埠 443 或 19999 上的行動流量。詳情請參閱客戶託管執行個體的注意事項和 Looker API 疑難排解說明文件頁面。
  • 生物辨識登入：如果生物辨識驗證 (指紋或臉部辨識) 失敗，請使用標準使用者名稱和密碼登入。如要重新設定生物辨識驗證，請前往應用程式的「設定」選單，然後選取「安全性」。請注意，您也必須在行動裝置的系統設定中啟用生物辨識功能。

QR code 登入問題

統一的 Looker 行動應用程式不支援使用 QR code 登入。請改用標準驗證方式 (Google OAuth、SAML、LDAP、OpenID Connect 或電子郵件地址和密碼)。

如果您使用 Looker Mobile (舊版) 應用程式 ，但無法透過 QR code 登入，請檢查下列事項：

  • 嵌入單一登入 (SSO) 驗證：在 Looker 網頁介面中，依序前往「管理」>「平台」>「嵌入」，確認已啟用「嵌入單一登入 (SSO) 驗證」。這項設定會啟用 QR code 登入選項。
  • 重新整理 QR code：QR code 有時效性，重新整理顯示 QR code 的網頁，然後嘗試掃描新產生的 QR code。
  • 相機權限和能見度：確認行動應用程式有權存取裝置相機，並確保掃描螢幕時光線充足。
  • 替代登入方式：如果 QR code 驗證持續失敗，請使用電子郵件和密碼憑證登入，或遷移至更新版 Looker 行動應用程式。

排解內容轉譯問題

如果資訊主頁或 Look 無法顯示、顯示空白資訊卡，或在行動應用程式中顯示錯誤訊息，請調查下列事項：

  • 問題範圍：判斷算繪失敗是否影響所有內容，還是只影響特定 Look 或資訊主頁：
    • 所有內容都無法下載：檢查行動裝置的網路連線，確認工作階段未過期，然後嘗試登出應用程式再重新登入。
    • 特定內容無法顯示：檢查內容是否使用自訂視覺化效果或不支援的版面配置格式。此外，也請確認您有權存取基礎模型和探索。
  • 檢查錯誤訊息：如果出現錯誤橫幅或圖塊錯誤，請記下特定訊息。常見問題包括資料庫連線錯誤、查詢逾時或缺少欄位參照。
  • 間歇性失敗與持續性失敗：如果內容間歇性失敗，問題可能與資料庫負載或暫時性網路波動有關。
  • 下拉重新整理：使用下拉重新整理手勢 (在畫面上向下拉)，重新載入資訊主頁或 Look，並執行新的查詢。

疑難排解應用程式當機問題

如果 Looker 行動應用程式當機或意外關閉，請按照下列步驟排解問題：

  • 找出導致當機的原因：請記下當機時間。應用程式是否會在啟動時、開啟特定資訊主頁時、裝置在直向和橫向模式之間旋轉時，或在特定使用者互動後立即當機？
  • 更新應用程式：前往 Apple App Store 或 Google Play 商店，確認您使用的是最新版 Looker 行動應用程式。更新通常會包含穩定性改善項目和錯誤修正。
  • 更新裝置作業系統：確認行動裝置搭載的是支援的 iOS 或 Android 版本。舊版作業系統可能會導致相容性問題。
  • 清除快取並重新啟動：
    • 強制關閉應用程式，然後重新開啟。
    • 重新啟動行動裝置。
    • 在 Android 裝置上，依序前往「設定」>「應用程式」>「Looker」>「儲存空間」>「清除快取」，清除應用程式快取。
  • 重新安裝應用程式：解除安裝應用程式、重新啟動裝置，然後從官方應用程式商店重新安裝應用程式。

排解效能和延遲問題

如果 Looker 行動應用程式速度緩慢、沒有回應，或載入內容的時間過長，請調查下列事項：

  • 找出速度緩慢的元件：判斷延遲是否發生在啟動應用程式、瀏覽資料夾和看板、載入快取內容清單，或是執行資訊主頁圖塊的查詢時。
  • 清單快取：行動應用程式會快取最近瀏覽和喜愛的內容清單，加快瀏覽速度。應用程式啟動時，清單會自動重新整理，但如果清單顯示的資訊過時，你可以下拉清單手動重新整理。
  • 資訊主頁複雜度和圖塊數量：如果資訊主頁包含許多圖塊或複雜的視覺化類型，行動裝置就需要大量記憶體和處理資源。測試較小的資訊主頁或個別 Look 是否載入速度較快。
  • 網路速度和延遲：行動網路可能會出現延遲時間過長或封包遺失的情況。連上可靠的高速 Wi-Fi 網路後，測試效能是否有所提升。
  • 資料庫查詢效能：如果個別圖塊需要很長時間才能算繪，請在 Looker 網頁介面或系統活動中檢查查詢時間。延遲可能是因為資料庫查詢執行時間偏長。

排解顯示和樣式問題

如果遇到視覺缺陷 (例如元素未對齊、圖示損壞、圖片變形或出現非預期的邊框間距)，請調查下列事項：

  • 螢幕方向：測試直向和橫向模式的資訊主頁或 Look。部分複雜的資訊主頁和表格已最佳化，適合以寬螢幕檢視。
  • 資訊主頁版面配置：適合行動裝置的資訊主頁會動態調整圖塊位置，以適應小螢幕。如果動態磚重疊或文字遭到截斷，請在網頁應用程式的資訊主頁編輯模式中，確認動態磚大小和設定。
  • 裝置顯示設定：自訂系統字型大小、顯示縮放或第三方深色模式反轉工具等無障礙設定，可能會改變內容的顯示方式。使用預設系統顯示設定進行測試。
  • 視覺化文件：擷取螢幕截圖或錄製螢幕畫面，清楚顯示轉譯差異，並分享給管理員或支援團隊。

收集診斷資訊

如果按照疑難排解步驟操作後仍無法解決問題，請先收集下列資訊，再與支援團隊聯絡：

  1. Looker 執行個體資訊：
    • 執行個體網址 (例如 instance_name.looker.com)。
    • Looker 發布版本 (在網頁應用程式中，依序選取「說明」>「關於」)。
    • 執行個體代管類型 (由 Looker 代管或客戶託管； Looker (Google Cloud Core) 或 Looker (原始版))。
  2. 行動應用程式資訊：
    • 已安裝的應用程式：指定您已安裝 Looker 行動應用程式或 Looker Mobile (舊版)。
    • 應用程式版本號碼 (位於應用程式內「更多」選單底部或「設定」中)。
    • 安裝應用程式的應用程式商店 (Apple App Store 或 Google Play 商店)。
  3. 裝置和作業系統詳細資料：
    • 裝置製造商和型號 (例如 Google Pixel 8、iPhone 15 Pro)。
    • 作業系統版本 (例如 Android 14、iOS 17.5)。
  4. 範圍和影響：
    • 這個問題會影響所有使用者，還是只有特定使用者帳戶？
    • 這個問題是否會發生在所有行動裝置上，還是只會發生在特定裝置型號或作業系統版本上？
  5. 視覺化範例和記錄：
    • 螢幕截圖或螢幕錄影，顯示非預期行為或錯誤訊息。
    • 重現問題的確切步驟。

聯絡支援團隊

如果已完成所有先前的驗證步驟，但問題仍未解決：