跨项目查看跟踪记录

本文档介绍了当这些 span 由存储在组织中不同 Google Cloud 项目中的应用生成时,如何从单个上下文查看某个轨迹的所有 span。

考虑这样一个情景:您有 Google Cloud 项目 AB,假设项目 B 托管的一个应用对项目 A 托管的应用发出了调用。如果您打开 Google Cloud 控制台并选择项目 A,则只能查看由项目 A 托管的应用生成的 Trace span。在默认配置下,当项目 B 向项目 A 发出调用时,您无法查看前者生成的 Trace span。

如需查看项目 B 从项目 A 的上下文中向项目 A 发出调用时生成的轨迹 span,请使用 Trace 的跨项目功能。通过使用此功能,您可以在查看跟踪记录时, 项目“A”的数据,您还可以查看项目“B”生成的 span 调用项目 A 时。

配置项目、权限和应用

执行以下配置步骤:

  1. 将您的每个 Google Cloud 项目与同一组织相关联。

    • 如果您要在组织的上下文中创建新项目,系统会在组织资源中自动创建该项目。

    • 如果您有不属于任何组织的 Google Cloud 项目, 您就可以将其移到您的组织中有关详情,请参阅 迁移现有项目

  2. 如需获得查看跨项目轨迹所需的权限,请让管理员向您授予项目或组织的以下 IAM 角色:

    • 每个项目的 Cloud Trace 用户 (roles/cloudtrace.user)。
    • 每个项目的 Logging Viewer (roles/logging.viewer)。
    • 组织的 Organization Viewer (roles/resourcemanager.organizationViewer)。当项目选择器包含组织列表时,您将被授予此角色。

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

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

  3. 配置应用以将跟踪记录写入托管它们的项目。

    如需强制跟踪跨项目请求,请在请求中附加一个跟踪上下文标头

跨项目查看跟踪记录详情

完成配置步骤后,如需跨 Google Cloud 项目查看轨迹,请执行以下操作:

  1. 在 Google Cloud 控制台中,转到 Trace 探索器页面:

    转到 Trace 探索器

    您也可以使用搜索栏查找此页面。

    选择您计划查看其轨迹数据的项目。例如: 则可以选择项目“A”。

    Trace Explorer 页面随即打开,并显示一个散点图和一个表格,其中显示了最近的跟踪记录。

  2. 如需探索特定跟踪记录,请从散点图或表格中选择该跟踪记录,或在跟踪记录 ID 字段中输入其 ID。

    跟踪详情窗格将打开并显示您拥有的所有 span 即使这些 span 在 同一组织内的不同 Google Cloud 项目。

后续步骤