Sie können einem Trace benutzerdefinierte Inhalte hinzufügen. Mit der Cloud Trace API v1 können Sie Labels hinzufügen, während Sie mit der Cloud Trace API v2 Zeitereignisse oder Attribute hinzufügen können.
Zeitliche Ereignisse 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 kann beispielsweise eine Instanz-ID aufzeichnen. Beispiele für Attribute finden Sie auf der API-Referenzseite für Attributes.
Mit Labels annotieren
Sie können Spans Ereignis-Anmerkungen hinzufügen, indem Sie ein labels-Objekt erstellen und an das TraceSpan-Objekt anhängen, wenn Sie die Cloud Trace API v1 patchTraces verwenden.
Diese Ereignis-Hinweise werden als Labels angezeigt, wenn Sie die Details zu einem Trace ansehen. 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 Ereignis-Hinweise werden als Labels angezeigt, wenn Sie die Details zu einem Trace ansehen. Weitere Informationen finden Sie unter Traces analysieren.
Anmerkungen mit Zeitereignissen
Sie können Spans Ereignis-Anmerkungen und Nachrichtenereignisse hinzufügen, indem Sie ein TimeEvents-Objekt erstellen und an das Span-Objekt anhängen, wenn Sie die Cloud Trace API v2 batchWrite verwenden.
Das TimeEvents-Objekt ist ein Array von TimeEvent-Objekten, die jeweils ein MessageEvent-Objekt und ein Annotation-Objekt enthalten.
Wenn Sie TimeEvents für einen Trace aufrufen möchten, klicken Sie in der Wasserfallgrafik der Traces auf Protokolle und Ereignisse anzeigen. Bei Auswahl von TimeEvent werden die Details im Detailbereich angezeigt.