排查 Log Analytics 配置问题

本文档介绍了如何解决在使用 Google Cloud 控制台的 Log Analytics 页面时可能发生的错误。

错误消息

本部分介绍了您可能会看到的错误消息，以及如何解决相应的错误情况。

No completion signal within allotted timeframe 错误消息

输入 SQL 查询并选择运行查询。由于查询尚未完成 您会看到以下错误消息：

The query failed to execute and return results due to error: No completion signal within allotted timeframe.

如需解决此错误，请执行以下某项操作：

  • 缩短查询日志的时间间隔，然后重试查询。例如，如果查询间隔为 14 天，请将间隔缩短为 7 天，然后运行查询。

  • 创建 关联的 BigQuery 数据集 然后从 BigQuery 界面运行查询。通过 BigQuery 界面支持需要较长执行时间的查询 比 Cloud Logging 界面所用的时间长。如需了解详情，请参阅 使用 BigQuery 查询日志。

FROM clause must contain exactly one view 错误消息

您可以在 Log Analytics 页面的查询窗格中输入 SQL 查询 但 SQL 解析器会显示以下内容 错误：

FROM clause must contain exactly one log view

如果无法将 FROM 语句中指定的表解析为特定日志视图，系统会报告上一个错误。

如需解决此错误，请确保您的表名称采用正确的语法：

  • 确保表名称遵循 Log Analytics 命名方案所要求的语法。BigQuery 和 Log Analytics 对表名称的要求不同。您可以在帮助中心找到 语法规则 查看默认查询。

  • 如果某个存储分区的 Google Cloud 项目 ID、区域、存储桶 ID 或视图 ID 日志存储桶中包含句点字符 (.)，则确保 字段用单反引号 (`) 引起。

    例如，如果 Google Cloud 项目 ID 为 example.com:bluebird，则如需查询 _Default 日志存储桶的 _AllLogs 视图，请使用以下语法指定表：

    
SELECT *
FROM `example.com:bluebird`.`global`.`_Default`.`_AllLogs`

    上一个查询假定 _Default 存储桶位于 global 区域。

无法保存查询

如果您输入并运行 SQL 查询，但 Save 处于停用状态，则表示您的组织或文件夹的默认资源设置定义了组织政策不允许的位置。如需解决此问题，请让贵组织的管理员在默认资源设置中定义一个与贵组织政策允许的位置匹配的位置。如需了解详情，请参阅 为组织和文件夹配置默认设置。

如果 Save 按钮处于启用状态，但您无法完成对话框并保存查询，请执行以下操作：

  1. 确保查询不包含语法错误。 您只能保存有效的查询。
  2. 可选：将查询复制到剪贴板。
  3. 重新加载页面。
  4. 如果您将查询复制到剪贴板，请将查询粘贴到 查询窗格中的查询，运行查询，然后执行保存操作。

对 Log Analytics 页面的访问遭拒

您在 Google Cloud 控制台中打开 Log Analytics 页面，系统会显示权限被拒绝的错误消息。

如需获得加载 Log Analytics 页面、运行查询和查看日志所需的权限，请让您的管理员向您授予项目的以下 IAM 角色：

您或许还能通过 自定义角色或 Logging 预定义角色。

查看日志条目和对 日志分析页面与您要查看的页面相同 日志浏览器页面上的日志。如需了解您需要哪些其他角色才能查询用户定义的存储桶中的视图或查询 _Default 日志存储桶的 _AllLogs 视图，请参阅 Cloud Logging 角色。

升级日志存储桶以使用 Log Analytics 失败

您创建一个日志存储桶，并选择使用 Log Analytics、 或者升级现有日志存储桶以使用 Log Analytics。 升级失败，并显示类似于以下内容的错误条件：

Failed precondition (HTTP 400): Constraint "my-constraint" violated for PROJECT_ID  with location global.

上一个错误消息表示，您的组织配置了一项限制可用区域的组织政策。符合升级条件以使用 Log Analytics 的日志存储桶必须使用 global 区域。如果您可以移除限制使用 global 区域的组织政策，则可以升级日志存储桶。否则 您无法升级日志存储分区。

未能创建关联的 BigQuery 数据集

修改日志存储桶以创建关联的 BigQuery 数据集，或者 创建新的日志存储桶，然后选择创建关联数据集的选项； 但不会创建关联的数据集。

如需解决此错误，请询问 Google Cloud 项目的系统管理员 可授予您的 IAM 角色，该角色包含 以下权限：

  • logging.links.create

先前的权限包含在 Logging Admin (roles/logging.admin) 中 和 Logs Configuration Writer (roles/logging.configWriter) 角色指定。

如需了解角色和权限，请参阅使用 IAM 进行访问权限控制。

未能删除关联的 BigQuery 数据集

您不再需要关联的数据集，而是选择删除该数据集 已停用。

如需解决此错误，请让 Google Cloud 项目的系统管理员向您授予包含以下权限的 IAM 角色：

  • logging.links.delete

之前的权限包含在 Logging Admin (roles/logging.admin) 和 Logs Configuration Writer (roles/logging.configWriter) 角色中。

有了此权限，您就可以从 Google Cloud 控制台的日志存储页面。 如需详细了解角色和权限，请参阅使用 IAM 进行访问权限控制。

缺少“查询引擎设置”按钮

如果运行查询按钮旁边未显示 设置按钮，则表示您的 Google Cloud 项目未启用预留的 BigQuery 槽。如需启用 Settings 按钮，请为您的项目配置预留的 BigQuery 槽。

“Run on BigQuery”（在 BigQuery 上运行）按钮已停用

如果 Run on BigQuery 按钮显示但处于停用状态， 那么您的查询引用的日志视图没有关联的数据集。 如需对 BigQuery 槽预留运行查询， 在 Google Cloud 控制台上创建关联的 BigQuery 数据集 日志视图。