问题排查指南

数据洞察有时会向用户显示各种错误，这些错误可能会中断报告流程。这些问题可能由多种原因导致，包括数据源和报告配置方面的问题，以及超出平台配额。了解这些常见错误是排查问题的第一步，有助于确保报告准确无误且易于访问。

下面列出了一些您可能会在 Data Studio 报告中遇到的一些最常见的错误，并按类别进行了划分，以便您更清楚地了解这些错误。如果您遇到图表、报告或数据源方面的问题，请查看本指南，看看其中是否列出了您遇到的问题。如果您的具体问题已列出，请点击解决步骤，了解如何进一步调查和解决问题。

基本卫生措施

数据洞察的某些问题可能是由临时网络错误或后端故障引起的。在花费大量时间排查问题之前，请先尝试执行以下基本清理步骤。每执行一个步骤后，请查看问题是否得到解决。

可能出现的症状和错误消息

错误消息以代码字体显示。

  • 无响应的网页

  • System error

  • Looker Studio is not available

解决步骤

  • 刷新浏览器窗口。
  • 清除浏览器缓存和 Cookie。
  • 重启浏览器。
  • 尝试使用其他浏览器。
  • 重启计算机。
  • 如果可能，请尝试使用其他电脑。

如果这些步骤无法解决问题，请稍等片刻，然后再次检查。如果问题仍然存在，您可以在 Looker 论坛上搜索，看看其他用户是否也遇到了同样的问题。

访问权限问题

如果您是 Google Workspace 或 Cloud Identity 客户，则贵组织的管理员必须先启用数据洞察，然后您才能使用该产品。同样，如果您与其他 Google Workspace 或 Cloud Identity 用户共享报告，则对方所在组织的管理员必须为其账号启用数据洞察。

服务已针对您的账号停用的示例错误消息

错误消息以代码字体显示。

We are sorry, but you do not have access to this service. Please contact your Organization Administrator for access.

解决步骤

让贵组织的管理员为贵组织启用数据洞察。详细了解数据洞察的企业版功能。

首次登录或使用数据洞察功能时，您可能会看到一个 OAuth 对话框，其中请求访问您的 Google 账号。此同意屏幕是授予 datastudio.firstparty 范围的授权所必需的，该范围可实现与 Data Studio API 的通信（例如用于进行 RPC 调用）。

解决步骤

在对话框中点击 **继续**（或 **允许**）以授予所需权限。除非您明确撤消访问权限，否则只需执行一次此操作。

针对报告收件人的服务已停用示例错误消息

当您尝试与另一用户（通常是外部用户）共享数据洞察报告时，作为发送者，您可能会收到以下错误消息：

You do not have access to Looker Studio. To enable this service, please log in to the Admin console.

原因：虽然您（发件人）会看到此错误消息，但实际上，此消息表示您尝试与之共享的收件人在其 Google Workspace 或 Cloud Identity 账号中未启用数据洞察服务。其所在组织的管理员可能已为其组织部门或群组停用或限制了对数据洞察的访问权限。

解决步骤

此问题必须由收件人解决。收件人需要联系其 Google Workspace 或 Cloud Identity 管理员，并请求为自己的账号启用数据洞察服务。

由于此问题与接收者的网域政策有关，因此发送者无法采取任何措施来解决此问题。

数据源和连接问题

数据连接问题可能是由多种原因造成的。有些问题是意料之中的，例如，当您没有适当的数据凭证来查看与您共享的数据源中的数据时，就会出现问题。其他原因包括配置损坏或不完整、数据源被删除以及数据授权丢失等。

请尝试按以下步骤操作，解决与数据集的连接问题。

可能收到的错误消息

错误消息以代码字体显示。

  • Missing data source
  • Data set configuration error
  • No data set access
  • Data source not attached
  • Data source needs to be added
  • The underlying data has changed
  • Database connection error

解决步骤

定时发送的邮件或提醒安排失败、VPC Service Controls 错误

如果数据源受到使用基于 IP 的访问权限级别的 VPC Service Controls (VPC-SC) 边界的保护，则自动后台功能可能会失败。

可能的症状和错误消息包括：

  • 定时发送的电子邮件仅包含报告的链接，缺少报告内容、图片或 PDF 附件。
  • 图表提醒无法触发或停止工作。
  • Organization VPC Service Controls prohibit access to data set used by this component
  • Service Control Failure

解决步骤

自动离线流程不会通过最终用户 IP 地址运行。如需解决这些错误，请将数据源配置为使用服务账号凭据或基于身份的访问权限级别，如 VPC Service Controls 的限制中所述。

配置和图表级问题

如果图表的配置不完整或不兼容，系统会显示错误。公式结构中可能还存在基本错误，例如缺少括号、函数名称不正确或运算符使用不当。数据洞察通常会突出显示公式中存在问题的部分。

可能收到的错误消息

错误消息以代码字体显示。

  • System error
  • Chart configuration incomplete
  • Invalid combination of metrics and dimensions
  • Get report failed

解决步骤

Invalid combination of metrics and dimensions 错误简介

当图表尝试以数据源不支持的方式直观呈现数据时，就会发生此错误。这是某些后端系统（例如 Google Analytics 和 Google Ads）的限制，这些系统中的数据以固定结构存储，只允许一起查询某些字段。

界面和功能问题

如果数据洞察突然停止运行或出现其他异常行为，则可能是由于扩展程序或插件不兼容而导致的问题。

可能出现的症状和错误消息

错误消息以代码字体显示。

  • 功能无法正常使用
  • 界面元素缺失
  • 产品停止响应
  • Sorry! We can't save this report right now.

解决步骤

  • 尝试本页前面介绍的 基本卫生措施。
  • 尝试使用其他浏览器。
  • 停用浏览器扩展程序和插件。
如果停用所有扩展程序后问题得到解决，请尝试逐个重新添加扩展程序，直到找出导致问题的扩展程序（然后考虑在 Looker 论坛上发布您的发现）。

混合问题

用户在混搭时遇到的最常见问题可归为以下几类：

  • 联接配置有误
  • 数据源连接缺失或不正确
  • 对混合结果有疑问或感到困惑

联接配置有误的示例症状和错误消息

错误消息以代码字体显示。

  • One or more join configurations is incomplete.
  • One or more join configurations is missing a join condition.
  • Join key incomplete. Each selected data source must specify a join key field for every join key.
  • 联接条件中存在粉色“缺失”字段。

解决步骤

  • 修改加入配置。
  • 确保混合中的每项配置都包含联接条件和联接运算符（除非您使用的是交叉联接，在这种情况下不允许使用联接条件）。
  • 对于缺失的字段：要么移除该字段，要么确保每对联接配置都有对应的字段。

数据源连接缺失或不正确的示例错误消息

One or more tables is missing its data source.

Google Analytics 4 配额超出

自 2022 年 11 月 7 日起，关联到 Google Analytics 4 数据的数据洞察报告受 Google Analytics Data API (GA4) 配额的约束。您可以使用 Google Analytics 令牌使用情况对话框监控报告的 GA4 流量使用情况。

查看 token 用量

  1. 修改数据洞察报告。
  2. 如需查看报告的总体令牌用量，请右键点击报告画布，然后选择 Google Analytics 令牌用量。
  3. 如需查看特定组件的令牌使用情况，请右键点击该组件，然后选择 Google Analytics 令牌使用情况。

如需查看 Google Analytics 4 令牌的总体使用情况，您可以查看：

“Google Analytics 令牌使用情况”对话框，其中显示了整个报告使用的配额令牌数量

  • 整个报告或当前用户会话中每页使用的配额令牌数
  • 在达到配额之前剩余的配额令牌数量
  • 每个图表消耗的配额令牌数量，按使用令牌数量从多到少排序

如需查看特定组件的令牌用量，您可以查看：

“Google Analytics 令牌使用情况详情”对话框，其中显示了每个图表使用的配额令牌数量

  • 每个请求消耗的配额令牌数量
  • 每个请求的完成时间
  • 请求是由底层数据集还是内存处理的，其中红色 X 表示请求是由数据集处理的，而绿色对勾标记表示请求是由内存处理的。如需了解详情，请参阅管理数据新鲜度一文。

“已超出配额”错误消息

如果报告超出这些配额，可能会显示以下某条错误消息：

  • Exhausted concurrent requests quota. Please send fewer requests concurrently.
  • This property has issued too many requests in the last day.
  • Too many requests using this Google Analytics property have encountered errors in the last hour.
  • This property has issued too many requests in the last hour.
  • This property is denied access to Google Analytics.
  • This property has issued too many potentially thresholded requests in the last hour.
  • This project/property has issued too many requests in the last hour.

解决步骤

如果您遇到此错误，可以尝试以下方法来减少从 Google Analytics 4 查询的数据量。以下步骤有助于减少配额用尽的情况，因为它们会增加对数据洞察数据缓存机制的依赖程度：
  • 首先，为数据源使用所有者凭据，而不是查看者凭据，以提高使用缓存数据的可能性，而不是查询数据和使用配额令牌。如果您依赖的是观看者的凭据，请考虑改用所有者的凭据。
  • 如果您的报告使用多个 Google Analytics 4 数据源，请考虑尽可能将它们整合为单个 可重复使用的数据源。这也会增加使用缓存数据而非查询数据和使用令牌的可能性。
  • 减少报告的流量。考虑减少报告的分享对象人数，并且不要将报告嵌入到流量较高的网站中。
  • 减少每个页面上的图表数量。
  • 提取 Google Analytics 4 数据，并使用提取的数据，而不是 Google Analytics 4 数据源。
    • 注意：您需要等到任何超出配额的情况得到解决后，才能提取数据。此过程最多可能需要 24 小时，具体取决于超出配额的程度。
  • 将您的 Analytics 数据导出到 BigQuery，然后使用 BigQuery 连接器在数据洞察中直观呈现该数据。
  • 升级到 Analytics 360。
  • 考虑使用合作伙伴连接器。

排查更复杂问题的策略

如果您想诊断数据洞察中不太明显的问题，第一步是确定问题发生的位置。

例如，问题是普遍存在还是仅限于特定情况？是所有报告都有问题，还是特定报告有问题？这种情况是发生在所有组件类型上，还是仅发生在特定组件上？问题出现在多个浏览器中，还是仅出现在特定浏览器的特定版本中？

另请参阅： 使用数据洞察所需的条件

下一步是减少变量数量。

一般来说，这意味着通过尽量减少数据或简化报告，尽可能将问题隔离到最少的因素。例如，如果您怀疑数据存在问题，请尝试使用过滤条件或修改数据集，将行数减少一半。如果问题消失了，但在您添加另一半行后又重新出现，则说明问题出在后一半数据中。

同样，如果问题出在特定图表上，请先尝试创建一个简单的图表版本，其中包含最少的字段和最简单的样式选项，然后逐渐增加复杂性，看看问题是否是由特定字段或设置引起的。

向 Google 报告问题

如果您无法解决问题，可以向 Google 报告。为便于我们诊断问题，请准备好提供以下信息：

  • 问题的完整说明
  • 重现问题的步骤
  • 显示的任何错误消息或错误 ID
  • 指向演示问题的测试报告或数据源的链接

关于错误 ID

如果您看到错误 ID（通常是 8 个字符的数字和字母组合），请务必将其包含在向 Google 提交的报告中。错误 ID 是唯一标识符，可帮助我们的工程师在日志中快速找到相应错误。错误 ID 不是静态映射到特定错误情况，而是动态生成的，因此它们与特定错误实例相对应。这意味着每次发生错误时，ID 都会发生变化。

测试报告简介

如排查更复杂问题的策略部分中所述，减少您分享的测试报告的复杂性有助于我们进行问题排查。如果可能，您创建的测试报告应尽可能简单。例如，复制原始报告，然后移除不必要用于演示问题的额外网页、图表、过滤条件和其他组件。