创建、查询和管理数据分析视图

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

本文档介绍了如何创建、管理和查询分析视图。 如需查看概念性概览，请参阅分析视图简介。

准备工作

注意 ：没有任何预定义的 Cloud Logging Identity and Access Management (IAM) 角色包含创建或查询分析视图所需的权限。

由于分析视图会查询日志视图，因此若要创建和查询分析视图，您的 IAM 角色还必须允许您查询日志视图和使用 Log Analytics。本部分列出了创建分析视图所需的 IAM 角色，以及查询日志视图和使用 Log Analytics 所需的 IAM 角色：

• 如需获得创建、管理和使用分析视图所需的权限，请让您的管理员为您授予项目的 Observability Analytics User (roles/observability.analyticsUser) IAM 角色。

  此预定义角色包含创建、管理和使用分析视图所需的权限。如需查看所需的确切权限，请展开所需权限部分：

  所需权限

  如需创建、管理和使用分析视图，需要具备以下权限：

  • observability.analyticsViews.get
  • observability.analyticsViews.list
  • observability.analyticsViews.create
  • observability.analyticsViews.update
  • observability.analyticsViews.delete

• 如需获得查询日志视图和使用 Log Analytics 所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

  • 如需查询 _Required 和 _Default 日志存储分区，请使用以下角色：Logs Viewer (roles/logging.viewer)
  • 如需查询项目中的所有日志视图，请使用以下角色： Logs View Accessor (roles/logging.viewAccessor)

  您可以通过以下任一方式将主账号限制为只能访问特定的日志视图：向项目级别授予的日志视图访问权限角色授予中添加 IAM 条件，或者向日志视图的政策文件添加 IAM 绑定。如需了解详情，请参阅控制对日志视图的访问权限。

  如需了解查询用户定义的存储分区中的视图或查询 _Default 日志存储分区的 _AllLogs 视图所需的其他角色，请参阅 Cloud Logging 角色。

创建分析视图

注意 ：分析视图只能查询日志视图。查询多个日志视图时，托管这些日志视图的日志存储分区必须位于同一位置。例如，如果您在 us-east1 位置有两个日志分桶，则可以创建一个分析视图，用于查询这些日志分桶中的日志视图。

如需创建分析视图，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Log Analytics 页面：

   转到 Log Analytics

   如果您使用搜索栏查找此页面，请选择子标题为 Logging 的结果。

2. 在视图菜单中，前往细分 日志部分，然后选择要查询的日志视图。

   如需查找日志视图，您可以使用 Filter 栏或滚动浏览日志视图列表。列表中的每个条目均采用以下格式 BUCKET_ID.LOG_VIEW_ID，其中这些字段是指日志分桶和日志视图的 ID。

3. 在架构工具栏中，点击查询。

   查询窗格会更新为显示 SQL 查询。

4. 确保工具栏显示运行查询。

   如果工具栏显示 Run in BigQuery，请点击 Settings（设置），然后选择 Log Analytics（默认）。

5. 在查询窗格中更新 SQL 查询，直到您对查询结果满意为止。

6. 在工具栏中，依次点击保存 保存，然后选择另存为分析视图。

7. 为分析视图输入名称和说明，然后点击保存。

   名称不得超过 100 个字符，且只能包含字母、数字、下划线和连字符。

   注意 ：分析视图一经创建便无法更改其名称。您可以修改说明和查询。

   您的 Google Analytics 数据视图已创建，并列在“视图”窗格中标题为 data_table Google Analytics 数据视图的部分中。列表中的每个条目均采用以下格式 LOCATION.ANALYTICS_VIEW_ID，其中这些字段是指分析视图的位置和 ID。例如，如果您创建了一个名为 my-analytic-view 的 Google Analytics 数据视图，该数据视图会查询日志桶位于 global 区域的日志视图，则此部分会显示 global.my-analytic-view。

查询分析视图

分析视图存在后，您可以像查询日志视图一样对其进行查询。如需查看介绍如何使用 Log Analytics 页面的文档列表，请参阅本文档的后续措施部分。

如需针对分析视图运行默认查询，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Log Analytics 页面：

   转到 Log Analytics

   如果您使用搜索栏查找此页面，请选择子标题为 Logging 的结果。

2. 为数据分析视图输入查询或加载默认查询。 查询的 FROM 子句应采用以下格式：

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

   在前面的表达式中，各个字段的含义如下：

   • PROJECT_ID：项目的标识符。
   • LOCATION：分析视图的位置。 分析视图的位置会从其查询的资源继承。例如，如果分析视图查询位于 global 位置的日志视图，则分析视图的位置也为 global。
   • ANALYTICS_VIEW_ID：分析视图的 ID，不得超过 100 个字符，且只能包含字母、数字、下划线和连字符。

   如需运行默认查询，请执行以下操作：

   1. 在视图菜单中，前往 data_table Google Analytics 数据视图部分，然后选择要查询的 Google Analytics 数据视图。

      如需查找数据分析视图，您可以使用 Filter 栏或滚动浏览数据分析视图列表。列表中的每个条目均采用以下格式 LOCATION.ANALYTICS_VIEW_ID，其中这些字段是指分析视图的位置和 ID。

   2. 在架构工具栏中，点击查询。

      查询窗格会更新为包含查询您所选 Google Analytics 视图的 SQL 查询。

3. 点击运行查询。

   如果工具栏显示 Run in BigQuery，请点击 Settings（设置），然后选择 Log Analytics（默认）。

列出 Google Analytics 数据视图

如需列出 Google Cloud 项目中的分析视图，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Log Analytics 页面：

   转到 Log Analytics

   如果您使用搜索栏查找此页面，请选择子标题为 Logging 的结果。

2. 在 Views 菜单中，前往 data_table Analytics Views 部分。

   系统会显示 Google Analytics 数据视图列表。列表中的每个条目均采用以下格式 LOCATION.ANALYTICS_VIEW_ID，其中这些字段是指分析视图的位置和 ID。例如，如果您创建了一个名为 my-analytic-view 的 Google Analytics 数据视图，该数据视图会查询日志桶位于 global 区域的日志视图，则此部分会显示 global.my-analytic-view。

3. 如需查看特定分析视图的详细信息，请执行以下操作：

   1. 选择 Google Analytics 数据视图。

      分析视图的架构显示在架构部分中。

   2. 在架构工具栏中，依次点击 查看分析视图选项，然后选择查看详情。

      该对话框会显示有关数据分析视图的信息，包括数据分析视图的创建时间、架构和查询。

修改分析视图

如需修改分析视图，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Log Analytics 页面：

   转到 Log Analytics

   如果您使用搜索栏查找此页面，请选择子标题为 Logging 的结果。

2. 在视图菜单中，前往 data_table Google Analytics 数据视图部分，然后选择要查询的 Google Analytics 数据视图。

3. 在架构工具栏中，依次点击 View analytics view options（查看分析视图选项），然后选择 Edit view（修改视图）。

   系统会打开一个对话框，其中显示分析视图的相关信息。您可以修改说明和查询。

4. 修改完成后，点击覆盖已保存的视图。

删除 Google Analytics 视图

注意： 如果您针对某个 Google Analytics 视图编写了查询，然后删除了该 Google Analytics 视图，则这些查询将会失败。

如需删除分析视图，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Log Analytics 页面：

   转到 Log Analytics

   如果您使用搜索栏查找此页面，请选择子标题为 Logging 的结果。

2. 在视图菜单中，前往 data_table Google Analytics 数据视图部分，然后选择要查询的 Google Analytics 数据视图。
3. 在架构工具栏中，点击 查看 Google Analytics 视图选项，选择删除视图，然后完成对话框。

限制

以下限制适用于数据分析视图：

• 一个分析视图无法查询另一个分析视图。
• 一个分析视图可以查询多个日志视图。不过，托管查询的日志视图的日志存储分区必须位于同一位置。例如，假设您有两个日志存储分区，一个位于 us-east1，另一个位于 asia-east1。您无法创建用于查询这些日志存储分区中日志视图的分析视图。
• 分析视图的父级资源必须是 Google Cloud 项目。您无法在文件夹或组织中创建分析视图。
• 分析视图不支持关联的数据集。因此，您只能使用 Log Analytics 页面查询分析视图。此外，您必须在默认的 Cloud Logging 服务中运行这些查询。
• 不支持使用 API 创建或管理 Google Analytics 视图。

• 以下限制适用于数据分析视图：

  • 每个 Google Cloud 项目的分析视图数量上限：100
  • 每个 Google Cloud 项目在每个区域的分析视图数量上限： 50
  • 每个 Google Cloud 项目中可存储 Google Analytics 视图的区域数量上限：10 个

后续步骤

• 查询和分析日志概览
• 保存和共享 SQL 查询
• 图表 SQL 查询结果
• SQL 查询示例