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