本文档介绍如何在单个上下文中查看跟踪记录的所有 span(如果这些 span 由存储在组织内不同 Google Cloud 项目中的应用生成)。
假设您有 Google Cloud 项目 A
和 B
,并假设由项目 B
托管的应用调用由项目 A
托管的应用。如果您打开 Google Cloud 控制台并选择项目 A
,则只能查看由项目 A
托管的应用生成的跟踪记录 span。使用默认配置时,项目 B
在调用项目 A
时生成的跟踪记录 span 无法查看。
如需查看项目 B
在从项目 A
的上下文调用项目 A
时生成的跟踪记录 span,请使用 Trace 的跨项目功能。借助此功能,在查看项目 A
的轨迹数据时,您还可以查看项目 B
在调用项目 A
时生成的 span。
配置项目、权限和应用
执行以下配置步骤:
将您的每个 Google Cloud 项目与同一组织相关联。
如果您在组织的上下文中创建新项目,则该项目将在组织资源中自动创建。
如果您有一个不属于组织的 Google Cloud 项目,可以将其移入组织。如需了解详情,请参阅迁移现有项目。
-
如需获取跨项目查看跟踪记录所需的权限,请让管理员向您授予项目或组织的以下 IAM 角色:
-
每个项目的 Cloud Trace 用户 (
roles/cloudtrace.user
)。 -
每个项目的 Logging 查看者 (
roles/logging.viewer
)。 -
组织的 Organization Viewer (
roles/resourcemanager.organizationViewer
)。如果项目选择器包含组织列表,您就会获得此角色。
如需详细了解如何授予角色,请参阅管理访问权限。
-
每个项目的 Cloud Trace 用户 (
配置应用以将跟踪记录写入托管它们的项目。
如需强制跟踪跨项目请求,请向请求附加跟踪上下文标头。
跨项目查看跟踪记录详情
完成配置步骤后,如需跨 Google Cloud 项目查看跟踪记录,请执行以下操作:
-
在 Google Cloud 控制台中,转到 Trace 探索器页面:
您也可以使用搜索栏查找此页面。
选择您要查看跟踪记录数据的项目。例如,您可以选择项目
A
。Trace Explorer 页面将打开并显示散点图和显示最新跟踪记录的表。
如需探索特定跟踪记录,请从散点图或表格中选择跟踪记录,或在跟踪记录 ID 字段中输入其 ID。
跟踪详情窗格将打开并显示您有权查看的所有 span,即使这些 span 位于属于同一组织的不同 Google Cloud 项目中也是如此。