Puedes agregar contenido definido por el usuario a un seguimiento. La API de Cloud Trace v1 te permite agregar etiquetas, mientras que la API de Cloud Trace v2 te permite agregar eventos o atributos de tiempo.
Los eventos de tiempo son más flexibles, ya que te permiten especificar un mensaje, en forma de cadena, además de un conjunto de atributos.
Cada atributo se representa como un par clave-valor.
Por ejemplo, un atributo puede registrar un identificador de instancia. Para ver ejemplos de atributos, consulta la página de referencia de la API de Attributes.
Anotar con etiquetas
Para agregar anotaciones de eventos a los intervalos, crea un objeto labels y adjúntalo al objeto TraceSpan cuando uses la API de Cloud Trace v1 patchTraces.
Estas anotaciones de eventos se muestran como etiquetas cuando consultas los detalles de un seguimiento. Para obtener más información sobre las etiquetas, consulta Etiquetas de seguimiento.
Anotar con atributos
Puedes anotar intervalos si creas un objeto attributes y lo adjuntas al objeto Span cuando usas la API de Cloud Trace v2 batchWrite.
Estas anotaciones de eventos se muestran como etiquetas cuando consultas los detalles de un seguimiento. Para obtener más detalles, consulta Cómo explorar un seguimiento.
Anotar con eventos temporales
Puedes agregar anotaciones de eventos y eventos de mensaje a los intervalos. Para ello, crea un objeto TimeEvents y adjúntalo al objeto Span cuando usas la versión 2 de batchWrite de la API de Cloud Trace.
El objeto TimeEvents es un array de objetos TimeEvent, cada uno de los cuales contiene un objeto MessageEvent y un objeto Annotation.
Para ver el TimeEvents de un seguimiento, ve al gráfico de cascada del seguimiento y haz clic en Mostrar registros y eventos. Si seleccionas un TimeEvent, sus detalles se mostrarán en el panel de detalles.