创建和管理轨迹范围

本文档介绍了如何创建和管理跟踪范围,以便 Trace Explorer 页面查找您要查看或分析的跟踪 span。如果您只想查看和分析源自 Google Cloud 项目的跨度,则无需配置任何轨迹范围。不过,如果您的轨迹数据存储在多个项目中(使用微服务架构时可能会出现这种情况),则您需要执行一些配置活动,才能查看单个 Google Cloud 项目中的所有跨度。

本文档未介绍如何查看轨迹和跨度。如需了解该主题,请参阅查找和探索跟踪记录

跟踪范围简介

跟踪记录范围是一种持久的项目级资源,用于列出一系列 Google Cloud 项目。您可以将 Trace 探索器页面配置为按跟踪记录范围进行搜索,这意味着该页面会搜索所选范围中列出的项目。您在所搜索项目中的 Identity and Access Management (IAM) 角色和时间范围设置决定了系统会从存储空间提取哪些数据并显示。

创建 Google Cloud 项目时,系统会创建一个名为 _Default 的轨迹范围。此范围仅包含 Google Cloud 项目。您无法向此范围添加项目或删除此范围。

您可以创建轨迹范围,还可以修改和删除您创建的任何轨迹范围。如果您有将跨度数据写入多个 Google Cloud 项目的服务,则需要创建轨迹范围。

除非您使用包含跟踪记录范围或跟踪记录和跨度 ID 的网址打开 Trace 探索器页面,否则 Trace 探索器页面会搜索默认跟踪记录范围中列出的 Google Cloud 项目以查找跟踪记录数据。创建项目时,系统会将名为 _Default 的轨迹范围设置为默认轨迹范围。不过,您可以选择其他轨迹范围作为默认轨迹范围。

准备工作

如需获得创建和查看轨迹范围以及设置默认轨迹范围所需的权限,请让您的管理员为您授予以下 IAM 角色:

  • 如需创建和查看跟踪范围以及获取默认跟踪范围:针对您的项目的 Cloud Trace User (roles/cloudtrace.user)
  • 如需设置默认轨迹范围:针对您的项目的 Observability Editor (roles/observability.editor)

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

这些预定义角色包含创建和查看轨迹范围以及设置默认轨迹范围所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

如需创建和查看轨迹范围以及设置默认轨迹范围,需要具备以下权限:

  • 如需创建和管理轨迹范围,请执行以下操作: cloudtrace.traceScopes.[create, delete, get, list, update]
  • 如需设置默认轨迹范围,请执行以下操作: observability.scopes.[get, update]

您也可以使用自定义角色或其他预定义角色来获取这些权限。

列出跟踪范围

如需列出轨迹范围,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 设置页面:

    前往设置

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

  2. 选择轨迹范围标签页。

    表格中会列出您的轨迹范围。选择 Google Cloud 项目后,系统会显示一个带有“默认”图标 的条目,表示它是默认的轨迹范围。Trace 探索器页面在打开时会在默认跟踪记录范围中列出的项目中搜索跟踪记录数据。

创建跟踪范围

Trace 探索器页面显示的跨度取决于搜索的项目、您在这些项目中的 IAM 角色、时间范围设置以及您应用的过滤条件。

每个项目最多可以创建 100 个轨迹范围。一个跟踪记录范围总计可以包含 20 个项目。

如需创建轨迹范围,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 设置页面:

    前往设置

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

  2. 选择轨迹范围标签页,然后点击创建轨迹范围
  3. 点击添加项目并完成对话框。

    添加项目后,存储在该项目中的跨度会包含在轨迹范围内。如果您不知道要将哪些项目包含在范围中,可以使用旧版 Trace 探索器页面来帮助您确定这些项目。如需了解详情,请参阅本文档的迁移到轨迹作用域部分。

  4. 为轨迹范围命名部分,输入您希望在轨迹范围标签页上显示的名称和说明。

    跟踪记录范围的名称无法修改,并且在项目中必须是唯一的。

  5. 点击创建轨迹范围

迁移到跟踪范围

Trace 探索器页面要求您指定要搜索跟踪记录数据的 Google Cloud 项目,这与旧版 Trace 探索器页面的行为有所不同。旧版 Trace 探索器页面可搜索组织中的所有项目。由于这些差异,Trace Explorer 页面可能不会显示旧版 Trace Explorer 页面显示的跨度。

您可以使用旧版 Trace 探索器页面的 Trace 详情窗格部分,帮助您编制存储跟踪数据的 Google Cloud 项目列表:

  1. 前往旧版 Trace 探索器页面:

    前往旧版轨迹探索器

  2. 选择一个轨迹。

    您可以尝试以下操作:

    • 轨迹 ID 字段中输入轨迹的 ID,以查看该轨迹。
    • 添加过滤条件。
  3. 跟踪记录详情窗格中,选择跟踪记录,然后前往项目标签页。

    此标签页列出了存储轨迹跨度的项目。

  4. 如需创建包含所列项目的轨迹范围,请前往项目标签页的工具栏,选择使用这些项目创建范围,然后完成对话框。

  5. 重复上述步骤,直到编译出项目列表。

编译项目列表后,创建轨迹范围。 您还可以将其设置为默认轨迹范围。

设置默认轨迹范围

Trace 探索器页面打开后,会在默认跟踪记录范围中列出的项目中搜索跟踪记录数据。如果无法访问该轨迹范围,系统会搜索您的项目以查找轨迹数据。

创建项目时,系统会创建一个名为 _Default 的轨迹范围,并将其指定为默认轨迹范围。不过,您可以创建自己的轨迹作用域,并将其指定为默认轨迹作用域。

如需设置默认轨迹范围,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 设置页面:

    前往设置

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

  2. 选择轨迹范围标签页。
  3. 找到要指定为默认轨迹范围的轨迹范围,点击其  More(更多),然后选择 Set as default(设为默认)。

    您选择的轨迹范围会显示“默认”图标

修改或删除轨迹范围

您无法删除或修改名为 _Default 的轨迹范围。您可以修改或删除所有其他轨迹范围。

如需修改或删除轨迹范围,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 设置页面:

    前往设置

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

  2. 选择轨迹范围标签页。
  3. 找到要修改或删除的轨迹范围,点击  More(更多),然后执行以下操作之一:

    • 如需修改,请选择修改范围,然后在对话框中填写信息。
    • 如要删除,请选择删除镜重,然后在对话框中填写信息。

限制

Cloud Trace API 或 Google Cloud CLI 不支持创建或管理轨迹作用域。

后续步骤