排查嵌入设置问题

本文档介绍了如何排查设置 Looker 嵌入功能时遇到的问题。如果嵌入的内容无法加载,请检查以下几个可能的原因。

决策树

使用以下决策树排查嵌入设置问题:

问题排查步骤

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

这是已签名的嵌入吗?

如需详细了解签名嵌入,请参阅签名嵌入文档。

如果您使用的是签名嵌入,请继续阅读私密嵌入是否有效?。如果您未使用签名嵌入,请参阅第三方 Cookie 问题

私密嵌入是否有效?

检查私密嵌入是否正常运行。

如果私密嵌入有效,请继续排查签名嵌入问题。如果私密嵌入不起作用,请参阅第三方 Cookie 问题

检查嵌入平台的网域和嵌入网址的网域。如果基本网域不匹配,则可能是浏览器屏蔽了第三方 Cookie 导致了此问题。

例如,如果您的嵌入式应用托管在 example.com 上,但用于嵌入的 Looker 实例网址为 customer.cloud.looker.com,则当 Looker iframe 嵌入到 example.com 中时,浏览器可能会阻止来自 customer.cloud.looker.com 的 Cookie。如果您的 Looker 实例位于 looker.example.com,则由于基本网域 example.com 匹配,Cookie 将为第一方 Cookie。

如果问题是由拒绝第三方 Cookie 引起的,您可以启用浏览器中的第三方 Cookie,也可以配置自定义网域。对于 Looker (Google Cloud Core) 实例,您可以使用自助服务配置自定义网域。对于 Looker(原始)实例,您可以申请配置自定义网域,以便使实例网域与嵌入式应用的基本网域保持一致。

排查已签名的嵌入问题

如果您在签名嵌入方面遇到问题,请参阅以下问题排查页面:

最终审核和支持

如果嵌入式 iframe 仍无法加载,请查看本页上的问题排查步骤。如果您仍需要帮助,请先收集以下信息,然后再与支持团队联系

  • 在重现嵌入问题时捕获的网络流量生成的 HAR 文件
  • 所用嵌入类型:公开私密签名
  • 问题开始出现的时间