本文档介绍了如何将跟踪记录与 Cloud Logging LogEntry
相关联。
将日志条目与跟踪记录或 span 相关联
如果您使用 Cloud Logging API 写入日志数据,或者写入结构化日志数据,则可以将日志条目与跟踪记录或 span 相关联。日志条目还可以记录跟踪记录是否已被采样。如需了解 Ops Agent 如何将结构化日志数据转换为 LogEntry
中的字段,请参阅结构化载荷中的特殊字段。
通过设置 LogEntry
对象中的 trace
字段,将日志条目与跟踪记录相关联。trace
字段必须设置为采用以下格式的字符串:
projects/PROJECT_ID/traces/TRACE_ID
其中,PROJECT_ID
是您的 Google Cloud 项目 ID,TRACE_ID
是跟踪记录标识符
如需在使用 Cloud Logging API 时将日志条目与 span 相关联,请将 LogEntry
对象中的 spanId
字段设置为 span ID 的 16 个字符十六进制编码。例如,如需将日志条目与 ID 为 74
的 span 相关联,请将 span ID 设置为 000000000000004a
。
如需指明您正在使用跟踪记录采样,并且已在写入日志条目时对跟踪记录进行采样以存储,请设置 LogEntry
对象中的 traceSampled
字段。使用跟踪记录采样时,如果系统未捕获跟踪记录本身,则可能会创建日志条目。
查看日志
您可以在瀑布图或日志浏览器中查看跟踪记录的日志条目。使用日志浏览器时,它将自动限制为跟踪记录的时间戳范围。如果没有要显示的日志条目,则日志浏览器会显示消息 No entries found matching current filter
。
在 Trace 详情窗格中,如需查看跟踪记录的日志条目,请执行以下操作之一:
如需在瀑布图旁边显示跟踪记录日志条目,请转到瀑布图,然后点击显示日志。如果未显示显示日志,则表示没有可用的日志条目。
如需在日志浏览器中查看日志条目,请点击详细信息部分中日志标签旁边的查看。请注意,如果您有 Cloud Load Balancing 跟踪记录,请点击虚拟机日志标签旁边的查看。
如需详细了解如何在 Cloud Logging 中查看日志条目,请参阅使用日志浏览器。
日志查看权限
要查看任何日志条目,您必须拥有项目的 logging.logEntries.list
权限。此权限由 Logs Viewer 和 Project Viewer Identity and Access Management (IAM) 角色提供。
要查看虚拟机实例日志,您必须拥有项目的 compute.instances.get
权限。此权限由 Compute Engine Network Viewer 和 Project Viewer IAM 角色提供。