É possível adicionar conteúdo definido pelo usuário a um rastro. A API Cloud Trace v1 permite
adicionar rótulos, enquanto a API Cloud Trace v2 permite adicionar eventos de tempo ou atributos.
Os eventos de tempo são mais flexíveis, porque permitem especificar uma mensagem
na forma de uma string, além de um conjunto de atributos.
Cada atributo é representado como um par de chave-valor.
Por exemplo, um atributo pode registrar um identificador de instância. Para conferir exemplos de atributos, consulte a página de referência da API para Attributes.
Anotar com rótulos
É possível adicionar anotações de evento a períodos criando um objeto labels e
anexando-o ao objeto TraceSpan ao usar a
API Cloud Trace v1 patchTraces.
Essas anotações de evento são exibidas como rótulos quando você visualiza os detalhes de um trace. Para mais informações sobre os rótulos, consulte Rótulos de trace.
Anotar com atributos
É possível anotar períodos criando um objeto attributes e anexando-o ao objeto Span ao usar a API Cloud Trace v2 batchWrite.
Essas anotações de evento são exibidas como rótulos quando você visualiza os detalhes de um trace. Para mais detalhes, consulte Conhecer um trace.
Anotar com eventos de hora
É possível adicionar anotações de evento e eventos de mensagem a períodos criando um objeto
TimeEvents e anexando-o ao objeto
Período ao usar a API Cloud Trace v2 batchWrite.
O objeto TimeEvents é uma matriz de
objetos TimeEvent, cada um contendo um objeto MessageEvent e um
Annotation.
Para conferir o TimeEvents de um trace, acesse o gráfico de cascata dos traces
e clique em Mostrar registros e eventos. Se você selecionar um TimeEvent, os detalhes dele serão exibidos no painel de detalhes.