Puoi aggiungere contenuti definiti dall'utente a una traccia. La versione 1 dell'API Cloud Trace consente di aggiungere etichette, mentre l'Cloud Trace API 2 consente di aggiungere eventi o attributi relativi al tempo.
Gli eventi relativi al tempo sono più flessibili, in quanto ti consentono di specificare un messaggio
sotto forma di stringa, oltre a un insieme di attributi.
Ogni attributo è rappresentato come coppia chiave-valore.
Ad esempio, un attributo potrebbe registrare un identificatore di istanza. Per esempi di attributi, consulta la pagina di riferimento dell'API per Attributes.
Annotare con le etichette
Puoi aggiungere annotazioni degli eventi agli span creando un oggetto labels e agganciandolo all'oggetto TraceSpan quando utilizzi la versione 1 dell'Cloud Trace API patchTraces.
Queste annotazioni degli eventi vengono visualizzate come etichette quando visualizzi i dettagli di una traccia. Per saperne di più sulle etichette, consulta Etichette traccia.
Annotare 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 visualizzate come etichette quando visualizzi i dettagli di una traccia. Per maggiori dettagli, vedi Esplorare una traccia.
Aggiungere annotazioni con eventi nel tempo
Puoi aggiungere annotazioni evento ed evento messaggio agli span creando un oggetto
TimeEvents e collegandolo all'oggetto
Span quando utilizzi la versione 2 dell'Cloud Trace API TracebatchWrite.
L'oggetto TimeEvents è un array di oggetti TimeEvent, ognuno dei quali contiene un oggetto MessageEvent e un oggetto Annotation.
Per visualizzare il TimeEvents di una traccia, vai al grafico a cascata delle tracce
e fai clic su Mostra log ed eventi. Se selezioni un TimeEvent, i relativi dettagli vengono visualizzati nel riquadro dei dettagli.
Passaggi successivi
- Esegui l'integrazione con Cloud Logging.
- Creare report di analisi
- Visualizzare le tracce tra progetti