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

本文档介绍了如何创建和管理分析视图。创建分析视图后，您可以按照与查询日志视图和可观测性视图类似的方式查询该视图。

如需大致了解分析视图，请参阅分析视图简介。

准备工作

  1. 登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请 创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 启用 Observability API。

    启用 API 所需的角色

    如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

    启用 API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. 启用 Observability API。

    启用 API 所需的角色

    如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

    启用 API

    8.

  8. 如需获得创建、管理和使用分析视图所需的权限，请让您的管理员为您授予以下 IAM 角色：

    • Observability View Accessor (roles/observability.viewAccessor) 在您要查询的可观测性视图上。此角色支持 IAM 条件，可让您将授予的权限限制为仅针对特定视图。如果您未为角色授予附加条件，则正文可以访问所有可观测性视图。可观测性视图目前为公开预览版。
    • 针对项目的 Observability Analytics User (roles/observability.analyticsUser)。此角色包含保存和运行专用查询以及运行共享查询所需的权限。
    • 项目的 Logs Viewer (roles/logging.viewer) 角色。
    • 存储您要查询的日志视图的项目的 Logs View Accessor (roles/logging.viewAccessor)。您可以通过添加 IAM 条件，将此角色授予限制为特定视图。

    如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

    您也可以通过自定义角色或其他预定义角色来获取所需的权限。

  9. 确保您拥有以下至少一项：

创建分析视图

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

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

    转到 Log Analytics

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

  2. 配置 Log Analytics 页面：
    1. 确保工具栏显示运行查询。 如果工具栏显示在 BigQuery 上运行，请点击 设置，然后选择 Log Analytics（默认）。
    2. 如果未显示视图菜单，请前往导航窗格，然后点击 视图和架构。

  3. 输入并验证要另存为分析视图的查询。

    您可能需要加载并修改分析视图将查询的日志视图或可观测性视图的默认查询。如需加载默认查询，请执行以下操作：

    1. 在视图菜单中，然后执行以下任一操作：

      • 前往 日志部分，然后选择一个日志视图。
      • 前往 Traces 部分，然后选择 _Trace.Spans._AllSpans。

    2. 在架构工具栏中，点击查询，然后点击覆盖。

      查询窗格会进行更新以显示某个 SQL 查询。

    3. 更新查询，直到您对查询结果满意为止。

  4. 创建分析视图：

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

    2. 为分析视图输入名称和说明。

      名称长度上限为 100 个字符，并且只能包含字母、数字、下划线和连字符。 分析视图创建后，您无法更改其名称。

    3. 点击保存。

    系统会创建您的分析视图，并在视图窗格中的 分析视图部分中列出该视图。

查询分析视图

您查询分析视图的方式与查询日志视图和观测视图类似。如需查询分析视图，请使用以下格式的 FROM 子句：

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

上面表达式中的字段含义如下：

  • PROJECT_ID：项目的标识符。
  • LOCATION：分析视图的位置。
  • ANALYTICS_VIEW_ID：分析视图的 ID，长度不得超过 100 个字符，且只能包含字母、数字、下划线和连字符。

如需了解详情，请参阅 Log Analytics。

列出分析视图

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

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

    转到 Log Analytics

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

  2. 配置 Log Analytics 页面：
    1. 确保工具栏显示运行查询。 如果工具栏显示在 BigQuery 上运行，请点击 设置，然后选择 Log Analytics（默认）。
    2. 如果未显示视图菜单，请前往导航窗格，然后点击 视图和架构。

  3. 在视图菜单中，前往 分析视图部分。

获取有关分析视图的详细信息

您可以使用架构窗格中的选项来显示有关分析视图的以下信息：

  • 名称。
  • 创建日期。
  • 上次更新时间。
  • Schema.
  • Query.

如需查看分析视图的详细信息，请列出项目中的分析视图，然后执行以下操作：

  1. 选择要查看其信息的分析视图。
  2. 在架构工具栏中，点击 查看分析视图选项，然后选择查看详情。

修改分析视图

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

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

    转到 Log Analytics

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

  2. 配置 Log Analytics 页面：
    1. 确保工具栏显示运行查询。 如果工具栏显示在 BigQuery 上运行，请点击 设置，然后选择 Log Analytics（默认）。
    2. 如果未显示视图菜单，请前往导航窗格，然后点击 视图和架构。

  3. 在视图菜单中，前往 分析视图部分，然后选择要修改的分析视图。

  4. 在架构工具栏中，点击 查看分析视图选项，然后选择修改视图。

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

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

删除分析视图

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

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

    转到 Log Analytics

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

  2. 配置 Log Analytics 页面：
    1. 确保工具栏显示运行查询。 如果工具栏显示在 BigQuery 上运行，请点击 设置，然后选择 Log Analytics（默认）。
    2. 如果未显示视图菜单，请前往导航窗格，然后点击 视图和架构。

  3. 在视图菜单中，前往 分析视图部分，然后选择要删除的分析视图。
  4. 在架构工具栏中，点击 查看分析视图选项，选择修改视图，然后完成对话框。

限制

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

  • 分析视图只能查询日志视图和可观测性视图。
  • 分析视图的父级资源必须是 Google Cloud 项目。
  • 您只能使用 Log Analytics 页面查询分析视图，并且只能在使用 Log Analytics（默认）查询引擎时进行查询。
  • 分析视图查询的所有视图都必须位于同一位置。
  • 您必须使用 Google Cloud 控制台来创建或管理分析视图。
  • 每个 Google Cloud 项目最多可以创建 100 个分析视图。
  • 每个区域最多可创建 50 个分析视图。
  • 每个 Google Cloud 项目中最多有 10 个区域可以包含分析视图。

后续步骤