本文档介绍了如何排查设置 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,则由于基本网域 example.com 匹配,Cookie 将为第一方 Cookie。
如果问题是由拒绝第三方 Cookie 引起的,您可以启用浏览器中的第三方 Cookie,也可以配置自定义网域。对于 Looker (Google Cloud Core) 实例,您可以使用自助服务配置自定义网域。对于 Looker(原始)实例,您可以申请配置自定义网域,以便使实例网域与嵌入式应用的基本网域保持一致。
排查已签名的嵌入问题
如果您在签名嵌入方面遇到问题,请参阅以下问题排查页面:
- 如果您没有看到 Looker 界面,或者只看到登录页面,请参阅对已签名的嵌入式身份验证错误进行问题排查。
- 如果您看到 Looker 界面,但遇到 404 错误、权限问题或内容访问问题,请参阅排查已签名的嵌入式内容中的 404 错误、权限问题和内容访问问题。
最终审核和支持
如果嵌入式 iframe 仍无法加载,请查看本页上的问题排查步骤。如果您仍需要帮助,请先收集以下信息,然后再与支持团队联系: