与 Cloud Logging 集成

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本文档介绍如何将跟踪记录与 Cloud Logging LogEntry 相关联。

将跟踪记录与日志条目相关联

使用 Trace 客户端库时,或使用 Python 版或 Java 版 OpenCensus 库时,您可以通过在 LogEntry 对象中设置 trace 字段,将跟踪记录与日志条目相关联。

trace 字段必须设置为字符串,格式如下:

   projects/PROJECT_ID/traces/TRACE_ID

其中,PROJECT_ID 是您的 Google Cloud 项目 ID,TRACE_ID 是跟踪记录标识符

如需在使用 REST API 时将 Span 与日志条目相关联,请将 LogEntry 对象中的 span_id 字段设置为 16 个字符的 Span ID 十六进制编码。如果您使用的是 gRPC API,请设置 spanId 字段。例如,如需在使用 REST API 时将某个 ID 为 74 的 span 与日志条目相关联,请将 span_id 设置为 000000000000004a

如需指明您使用的是跟踪记录采样,并且是在写入日志条目时对跟踪记录进行采样以存储,请在使用 REST API 时在 LogEntry 对象中设置 trace_sampled 字段。如果您使用的是 gRPC API,请设置 traceSampled 字段。使用跟踪记录采样时,如果捕获跟踪记录本身,则可能会创建日志条目。

如需了解详情,请参阅以下资源:

查看日志

您可以在瀑布图或日志浏览器中查看跟踪记录的日志条目。使用日志浏览器时,它将自动限制为跟踪记录的时间戳范围。如果没有要显示的日志条目,则日志浏览器会显示消息 No entries found matching current filter

Trace 详情窗格中,如需查看跟踪记录的日志条目,请执行以下操作之一:

  • 如需在瀑布图旁边显示跟踪记录日志条目,请转到瀑布图,然后点击显示日志。如果未显示显示日志,则表示没有可用的日志条目。

  • 如需在日志浏览器中查看日志条目,请点击详细信息部分中日志标签旁边的查看。请注意,如果您有 Cloud Load Balancing 跟踪记录,请点击虚拟机日志标签旁边的查看

如需详细了解如何在 Cloud Logging 中查看日志条目,请参阅使用日志浏览器

日志查看权限

要查看任何日志条目,您必须拥有项目的 logging.logEntries.list 权限。此权限由 Logs ViewerProject Viewer Identity and Access Management (IAM) 角色提供。

要查看虚拟机实例日志,您必须拥有项目的 compute.instances.get 权限。此权限由 Compute Engine Network ViewerProject Viewer IAM 角色提供。