本文档介绍了如何排查 Looker 嵌入设置问题。如果嵌入的内容无法加载,您需要检查几个可能的原因。
决策树
使用以下决策树排查嵌入设置问题:
问题排查步骤
以下部分将更详细地介绍树中的场景。
这是签名嵌入吗?
如需详细了解签名嵌入,请参阅签名嵌入文档。
如果您使用的是签名嵌入,请前往私密嵌入是否有效?。如果您未使用签名嵌入,请参阅第三方 Cookie 问题。
私密嵌入是否有效?
检查私密嵌入是否有效。
如果私密嵌入有效,请前往签名嵌入问题排查。如果私密嵌入无效,请参阅第三方 Cookie 问题。
第三方 Cookie 问题
检查嵌入平台的网域和嵌入网址的网域。如果基本网域不匹配,则问题可能是由浏览器屏蔽第三方 Cookie 引起的。
例如,如果您的嵌入应用托管在 example.com 上,但您用于嵌入的 Looker 实例网址是 customer.cloud.looker.com,则当 Looker iframe 嵌入到 example.com 中时,浏览器可能会屏蔽来自 customer.cloud.looker.com 的 Cookie。如果您的 Looker 实例改为位于 looker.example.com 上,则 Cookie 将是第一方 Cookie,因为基本网域 example.com 匹配。
如果问题是由拒绝第三方 Cookie 引起的,您可以在浏览器中启用第三方 Cookie,也可以配置自定义网域。对于 Looker (Google Cloud Core) 实例,您可以使用自助服务配置自定义网域。对于 Looker(原始)实例,您可以请求配置 自定义网域,以使实例网域与嵌入应用的基本网域保持一致。
签名嵌入问题排查
如果您在使用签名嵌入时遇到问题,请参阅以下问题排查页面:
- 如果您没有看到 Looker 界面,或者只看到登录页面,请参阅排查签名嵌入身份验证错误。
- 如果您看到 Looker 界面,但遇到 404 错误、权限问题或内容访问权限问题,请参阅排查签名嵌入 404 错误、权限问题和内容访问权限问题。
最终审核和支持
如果嵌入的 iframe 仍然无法加载,请查看本页中的问题排查步骤。如果您仍需要帮助,请先收集以下信息,然后再与支持团队联系: