Sie können einem Trace benutzerdefinierten Inhalt hinzufügen. Mit der Cloud Trace API v1 können Sie Labels und mit der Cloud Trace API v2 Zeitereignisse oder Attribute hinzufügen.
Zeitereignisse sind flexibler, da Sie zusätzlich zu einer Reihe von Attributen eine Nachricht in Form eines Strings angeben können.
Jedes Attribut wird als Schlüssel/Wert-Paar dargestellt.
Ein Attribut könnte beispielsweise eine Instanzkennung aufzeichnen. Beispiele für Attribute finden Sie auf der API-Referenzseite für Attributes.
Mit Labels versehen
Sie können Spans Ereignisanmerkungen hinzufügen. Erstellen Sie dazu ein labels-Objekt und hängen Sie es an das Objekt TraceSpan an, wenn Sie patchTraces der Cloud Trace API Version 1 verwenden.
Diese Ereignisanmerkungen werden als Labels angezeigt, wenn Sie die Details eines Trace aufrufen. Weitere Informationen zu Labels finden Sie unter Trace-Labels.
Mit Attributen annotieren
Sie können Spans annotieren, indem Sie ein attributes-Objekt erstellen und an das SpanObjekt anhängen, wenn Sie die Cloud Trace API v2 batchWrite verwenden.
Diese Ereignisanmerkungen werden als Labels angezeigt, wenn Sie die Details eines Trace aufrufen. Weitere Informationen finden Sie unter Trace untersuchen.
Mit Zeitereignissen versehen
Sie können Spans Ereignisanmerkungen und Nachrichtenereignisse hinzufügen. Erstellen Sie dazu ein TimeEvents-Objekt und hängen Sie es an das Span-Objekt an, wenn Sie die batchWrite der Cloud Trace API Version 2 verwenden.
Das TimeEvents-Objekt ist ein Array von TimeEvent-Objekten, von denen jedes ein MessageEvent- und ein Annotation-Objekt enthält.
Rufen Sie zum Ansehen des TimeEvents für ein Trace das Wasserfalldiagramm des Trace auf und klicken Sie auf Logs und Ereignisse anzeigen. Bei Auswahl von TimeEvent werden die Details im Detailbereich angezeigt.