排查 Looker 移动应用问题

借助 Looker 移动应用，您可以在 Android 和 iOS 设备上访问 Looker 和 Data Studio Pro 内容、查看 Look 和信息中心，以及随时随地进行协作。如果您在使用移动应用时遇到问题（例如登录问题、渲染错误、应用崩溃、性能延迟或显示不一致），本指南可帮助您排查并解决这些问题。

前提条件和常见配置要求

在开始问题排查之前，请确保您的环境和账号满足使用 Looker 移动应用的前提条件：

  • 移动应用访问权限已启用：Looker 管理员必须为您的实例启用移动应用访问权限。
  • 用户权限：您的用户账号必须直接或通过用户群组获得 mobile_app_access Looker 权限。
  • 支持的实例：Looker 移动应用支持 Looker (Google Cloud Core)（公共 IP 或专用 IP，使用专用服务访问通道或 Private Service Connect，可通过企业 VPN 访问）和 Looker（原始）实例（Looker 托管和客户托管）。
  • 企业 VPN 和 IP 许可名单：如果您的 Looker 实例强制执行 IP 许可名单，您的移动设备必须通过企业 VPN 进行连接，且该 VPN 具有实例 IP 许可名单中的静态 IP 地址。
  • 支持的身份验证：Looker 移动应用支持 Google OAuth、SAML、LDAP、OpenID Connect 以及电子邮件地址和密码凭据。使用二维码登录仅在 Looker Mobile（旧版）应用中受支持，并且需要启用嵌入式单点登录。

调试树

请使用以下决策树开始排查 Looker 移动应用问题：

以下部分将更详细地介绍树中的场景。

确定已安装的移动应用

由于 Looker 移动应用和 Looker Mobile（旧版）应用均可在应用商店中下载，因此第一个问题排查步骤是确定您的移动设备上安装了哪个应用。支持团队的初始分诊步骤依赖于此区别，以防止调查被错误地路由或延迟：

  • Looker：目前用于 Looker 和数据洞察 Pro 内容的统一移动应用。在设备主屏幕和应用商店中，此应用的名称为 Looker。它支持标准身份验证方法（例如 Google OAuth、SAML、OpenID Connect、LDAP 以及电子邮件地址和密码凭据），但不支持二维码登录。本问题排查指南主要介绍此应用。
  • Looker Mobile（旧版）：旧版移动应用。在设备主屏幕和应用商店中，此应用的名称为 Looker Mobile（旧版）（或 Looker Mobile）。它支持二维码以及电子邮件地址和密码登录，但不支持 Google OAuth、SAML 或 Looker (Google Cloud Core)实例。

如需确定设备上安装了哪个应用，请执行以下操作：

  1. 查看设备主屏幕或应用启动器中应用图标下方显示的应用名称。
  2. 在移动应用中，选择底部导航菜单中的更多或打开设置，然后在菜单底部找到应用名称和版本号。
  3. 在 Apple App Store (iOS) 或 Google Play 商店 (Android) 中查看已安装的应用列表。

如果您安装了 Looker Mobile（旧版），则对该应用的支持将于 2027 年 1 月 31 日结束，并且该应用将被下架。Google 强烈建议迁移到当前版本的 Looker 移动应用。 如需查看旧版应用的文档和问题排查信息，请参阅 Looker Mobile（旧版）应用指南。

如果您已安装 Looker 移动应用，请继续执行以下部分中的问题排查步骤。

验证问题是否在移动应用之外重现

问题排查的第一步是确定问题是否仅限于移动应用，还是也会影响 Looker Web 应用。

打开桌面版或移动版网络浏览器，登录 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 问题排查文档页面。
  • 生物识别登录：如果生物识别验证（指纹或人脸识别）失败，请使用标准用户名和密码登录。您可以在应用的设置菜单中的安全下重新配置生物识别验证。请注意，还必须在移动设备的系统设置中启用生物识别信息。

二维码登录问题

统一的 Looker 移动应用不支持使用二维码登录。请改用标准身份验证方式（Google OAuth、SAML、LDAP、OpenID Connect 或电子邮件地址和密码）。

如果您使用的是 Looker Mobile（旧版）应用，但无法通过二维码登录，请检查以下各项：

  • 嵌入式单点登录身份验证：在 Looker 网页界面中，依次前往管理 > 平台 > 嵌入，然后确认嵌入式单点登录身份验证已启用。此设置用于启用二维码登录选项。
  • 刷新二维码：二维码具有时效性。刷新显示二维码的网页，然后尝试扫描新生成的二维码。
  • 相机权限和可见性：确保移动应用有权访问设备摄像头，并在扫描屏幕时确保光线充足。
  • 替代登录方式：如果二维码身份验证持续失败，请使用电子邮件地址和密码凭据登录，或迁移到更新后的 Looker 移动应用。

排查内容呈现问题

如果信息中心或 Look 无法呈现、显示空白卡片或在移动应用中显示错误消息，请调查以下问题：

  • 问题范围：确定渲染失败是影响所有内容，还是仅影响特定 Look 或信息中心：
    • 所有内容均无法播放：检查移动设备的网络连接，验证会话是否已过期，然后尝试退出并重新登录应用。
    • 特定内容失败：检查内容是否使用了自定义可视化图表或不受支持的布局格式。另请验证您是否有权访问底层模型和探索。
  • 检查出错提示：如果出现错误横幅或功能块错误，请记下具体的出错提示。常见问题包括数据库连接错误、查询超时或缺少字段引用。
  • 间歇性失败与持续性失败：如果内容间歇性失败，问题可能与数据库负载或临时网络波动有关。
  • 下拉刷新：使用下拉刷新手势（在屏幕上向下拉）重新加载信息中心或 Look，并运行新的查询。

排查应用崩溃问题

如果 Looker 移动应用崩溃或意外关闭，请按照以下问题排查步骤操作：

  • 确定崩溃触发条件：记下发生崩溃的时间。应用是否会在启动时、打开特定信息中心时、在竖屏和横屏模式之间旋转设备时或在特定用户互动后立即崩溃？
  • 更新应用：前往 Apple App Store 或 Google Play 商店，确保您运行的是最新版本的 Looker 移动应用。更新通常包括稳定性改进和 bug 修复。
  • 更新设备操作系统：确保您的移动设备搭载的是受支持的 iOS 或 Android 版本。过时的操作系统可能会导致兼容性问题。
  • 清除缓存并重新启动：
    • 强制关闭应用，然后重新打开。
    • 重启移动设备。
    • 在 Android 上，依次前往设置 > 应用 > Looker > 存储空间 > 清除缓存，清除应用缓存。
  • 重新安装应用：卸载相应应用，重启设备，然后从官方应用商店重新安装该应用。

排查性能和延迟时间问题

如果 Looker 移动应用运行缓慢、无响应或加载内容的时间过长，请调查以下问题：

  • 确定速度缓慢的组件：确定延迟是在启动应用、浏览文件夹和看板、加载缓存的内容列表还是执行信息中心图块的查询时发生。
  • 列表缓存：移动应用会缓存最近查看过的内容和喜爱的内容的列表，以加快导航速度。该列表会在应用启动时自动刷新，但如果列表显示过时，您可以下拉列表手动刷新。
  • 信息中心复杂程度和图块数量：包含许多图块或复杂可视化图表类型的信息中心需要在移动设备上占用大量内存和处理资源。测试较小的信息中心或单个 Look 是否加载得更快。
  • 网络速度和延迟时间：移动网络可能会出现高延迟时间或丟包。测试连接到可靠的高速 Wi-Fi 网络时性能是否有所提升。
  • 数据库查询性能：如果单个平铺图块需要很长时间才能呈现，请在 Looker 网页界面或系统活动中检查查询时长。延迟可能是由于数据库查询运行时间过长。

排查显示和样式问题

如果您遇到视觉缺陷（例如元素未对齐、图标损坏、图片失真或出现意外内边距），请调查以下方面：

  • 屏幕方向：在纵向和横向模式下测试信息中心或 Look。部分复杂的信息中心和表格已针对更宽的横屏视图进行优化。
  • 信息中心布局：适合移动设备的信息中心会针对小屏幕动态调整图块位置。如果图块重叠或截断文本，请在 Web 应用的信息中心修改模式下验证图块大小和配置。
  • 设备显示设置：无障碍设置（例如自定义系统字体大小、显示缩放或第三方深色模式反转工具）可能会改变内容的呈现方式。使用默认系统显示设置进行测试。
  • 直观的文档：截取屏幕截图或录制屏幕视频，清晰展示渲染差异，以便与管理员或支持人员分享。

收集诊断信息

如果您在按照问题排查步骤操作后仍无法解决问题，请先收集以下信息，然后再与支持团队联系：

  1. Looker 实例信息：
    • 实例网址（例如 instance_name.looker.com）。
    • Looker 发布版本（在 Web 应用中，依次选择帮助 > 关于）。
    • 实例托管类型（Looker 托管或客户托管；Looker (Google Cloud Core) 或 Looker [原始版本]）。
  2. 移动应用信息：
    • 安装了哪个应用：指定您安装的是 Looker 移动应用还是 Looker Mobile（旧版）。
    • 应用版本号（可在应用内更多菜单底部或设置中找到）。
    • 安装相应应用的 App Store（Apple App Store 或 Google Play 商店）。
  3. 设备和操作系统详情：
    • 设备制造商和型号（例如 Google Pixel 8、iPhone 15 Pro）。
    • 操作系统版本（例如 Android 14、iOS 17.5）。
  4. 范围和影响：
    • 该问题是影响所有用户，还是仅影响特定用户账号？
    • 问题是出现在所有移动设备上，还是仅出现在特定设备型号或操作系统版本上？
  5. 直观示例和日志：
    • 显示意外行为或出错提示的屏幕截图或屏幕录制。
    • 重现问题的确切步骤。

与支持团队联系

如果您已验证上述所有步骤，但问题仍未解决，请执行以下操作：