您可以将用户定义的内容添加到跟踪记录中。Cloud Trace API v1 支持添加标签,而 Cloud Trace API v2 支持添加时间事件或属性。时间事件更加灵活,因为它们除了支持一组属性外,还允许您以字符串的形式指定消息。每个属性都表示为一个键值对。
例如,一个特性可能会记录一个实例标识符。如需查看属性示例,请参阅 Attributes
的 API 参考文档页面。
使用标签添加注释
您可以向 span 添加事件注释,方法是创建一个 labels
对象,并将其附加到 TraceSpan
对象(使用 Cloud Trace API v1 patchTraces
时)。
当您查看跟踪记录的详细信息时,这些事件注解会显示为标签。如需详细了解标签,请参阅跟踪记录标签。
使用属性添加注释
您可以在使用 Cloud Trace API v2 batchWrite
时为 span 添加注释,方法是创建一个 attributes
对象并将其附加到 Span
对象。
当您查看跟踪记录的详细信息时,这些事件注解会显示为标签。如需了解详情,请参阅探索跟踪记录。
使用时间事件进行注解
您可以向 span 添加事件注解和消息事件,方法是创建一个 TimeEvents
对象,并在使用 Cloud Trace API v2 batchWrite
时将其附加到 Span 对象。
TimeEvents
对象是 TimeEvent
对象的数组,其中每个对象都包含一个 MessageEvent
对象和一个 Annotation
对象。
如需查看跟踪记录的 TimeEvents
,请转到跟踪记录的瀑布图,然后点击显示日志和事件。如果您选择 TimeEvent
,则其详细信息将显示在“详细信息”窗格中。