Puoi aggiungere contenuto definito dall'utente a una traccia. L'API Cloud Trace v1 consente di aggiungere etichette, mentre l'Cloud Trace API v2 consente di aggiungere eventi o attributi relativi all'ora.
Gli eventi di tempo sono più flessibili, in quanto consentono di specificare un messaggio sotto forma di stringa oltre a un insieme di attributi.
Ogni attributo è rappresentato come una coppia chiave-valore.
Ad esempio, un attributo potrebbe registrare un identificatore di istanza. Per esempi di attributi, consulta la pagina di riferimento API per Attributes.
Annotazione con etichette
Puoi aggiungere annotazioni di eventi agli intervalli creando un oggetto labels e collegandolo all'oggetto TraceSpan quando utilizzi l'Cloud Trace API v1 patchTraces.
Queste annotazioni degli eventi vengono mostrate come etichette quando visualizzi i dettagli di una traccia. Per ulteriori informazioni sulle etichette, consulta la sezione Etichette di traccia.
Annotazione con attributi
Puoi annotare gli intervalli creando un oggetto attributes e collegandolo all'oggetto Span quando utilizzi l'Cloud Trace API v2 batchWrite.
Queste annotazioni degli eventi vengono mostrate come etichette quando visualizzi i dettagli di una traccia. Per maggiori dettagli, vedi Esplorare una traccia.
Annotare con eventi temporali
Puoi aggiungere annotazioni di eventi ed eventi di messaggio agli intervalli creando un oggetto TimeEvents e collegandolo all'oggetto Span quando utilizzi l'Cloud Trace API v2 batchWrite.
L'oggetto TimeEvents è un array di
TimeEvent oggetti, ognuno dei quali contiene un oggetto MessageEvent e un
oggetto Annotation.
Per visualizzare TimeEvents per una traccia, vai al grafico a cascata delle tracce e fai clic su Mostra log ed eventi. Se selezioni un elemento TimeEvent, i relativi dettagli vengono visualizzati nel riquadro dei dettagli.