Trace 界面中没有任何数据
如果您在预期跟踪记录数据存在时无法查看 Google Cloud 项目中的任何跟踪记录,请尝试按以下步骤操作:
-
Enable the Cloud Trace API.
在 Google Cloud 控制台中,前往 API 和服务页面:
找到标记为 Cloud Trace API 的行后,请尝试执行以下操作:
如果标记为 Requests 的列没有列出任何数字信息, 系统便不会向您的 Google Cloud 项目发送任何跟踪记录数据。
如需解决此支持请求,请检查您的应用和代理,确保它们已配置为将跟踪记录发送到正确的项目。
选择 Cloud Trace API,选择 Metrics(指标)标签页,然后找到标签为 Errors by API method(按 API 方法划分的错误数)的图表:
如果写入失败,请为提供身份验证凭据的服务账号授予 Cloud Trace Agent (
roles/cloudtrace.agent
) 角色。此角色包含cloudtrace.traces.patch
权限,可让应用将跨度数据写入 Google Cloud 项目。如需了解详情,请参阅 Cloud Trace IAM 角色。
如果读取失败,请确保您的 IAM 该角色拥有该角色中的权限 Cloud Trace 用户 (
roles/cloutrace.user
)。对于列表 该角色的所有权限 请参阅 Cloud Trace IAM 角色。
更新 Go 应用以使用 OpenTelemetry 后没有轨迹数据
您的应用依靠客户端库来捕获轨迹, 更新应用以使用 OpenTelemetry, Cloud Trace 数据。
由于某些适用于 Go 的 Google 客户端库已集成到 OpenCensus,您必须使用 OpenCensus 桥接器。 如需详细了解迁移桥所解决的问题,请参阅 OpenCensus Bridge。
如需了解适用于 Go 的 Google 客户端库的更新,请参阅问题 4237。
没有已部署应用的轨迹数据
您已部署一款应用,该应用使用 Cloud Trace API 将数据发送到您的 Google Cloud 项目,但系统未收集跟踪记录数据。
请尝试以下操作:
如果您在 Google Cloud 控制台的 Trace 探索器页面中没有看到任何数据,请按照标题为Trace 界面中没有任何数据的部分中的步骤操作。
如果应用未部署在 Google Cloud 上或使用 服务账号 提供身份验证凭据,然后确保 服务账号已被授予 Cloud Trace Agent (
roles/cloudtrace.agent
)。此角色包含
cloudtrace.traces.patch
权限,可让应用将跨度数据写入 Google Cloud 项目。如果应用依赖于 OpenTelemetry,请执行以下操作:
对于根服务,请尝试更新环境变量,以便 OpenTelemetry 使用采样率为
0.5
的traceidratio
采样器:export OTEL_TRACES_SAMPLER="traceidratio" export OTEL_TRACES_SAMPLER_ARG="0.5"
对于所有其他服务,请不设置
OTEL_TRACES_SAMPLER
环境变量,以使用默认采样器parentbased_always_on
。默认设置表示 span 的采样决策会从其父 span(如果存在)继承。如果父级跨度不存在,则系统会对该跨度进行采样。
除非您的应用始终对每个跨度进行采样,否则通常无法强制对请求进行端到端跟踪,因为端到端请求中的每个组件都会做出自己的采样决策。不过,您可以影响 向跟踪标头添加
sampled
标志来做出决策, 并将此标志设置为true
。此设置是对子组件的提示 对请求进行采样。 如需详细了解跟踪标头,请参阅用于上下文传播的协议。
轨迹中缺少 span ID 消息
您的跟踪记录包含“缺少 span ID”消息。
在分布式跟踪系统中,不完整的轨迹是正常现象。如果采样的 span 包含对未收到的其他 span 的引用,则轨迹不完整。出现未解析的引用的原因可能如下:
- 未对引用的 span 进行抽样。
- 引用的 span 已被抽样,但尚未被 Cloud Trace 收到,或者 span 已收到,但未存储。
当您查看不完整的跟踪记录时,Cloud Trace 会在跟踪记录详情窗格中显示“缺少 span ID”消息。
如果您一直看到“缺少 span ID”消息,请尝试以下操作:
对于您管理的组件,请确保它们遵循并传播标头的
sampled
标志(如果存在)。此设置提示子组件对 请求。如需详细了解跟踪标头,请参阅用于上下文传播的协议。Google Cloud 服务通常会遵循此提示。不过,它们也会限制跟踪数据的写入速率。
如果您使用的是 Cloud Service Mesh,请务必遵循 来传播这些配置的跟踪上下文。适用于 Cloud Service Mesh 指南,请参阅跟踪上下文传播。