É possível adicionar conteúdo definido pelo usuário a um trace. A API Cloud Trace v1 permite adicionar rótulos, e a API Cloud Trace v2 permite adicionar eventos ou atributos de tempo.
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.
Fazer anotações com rótulos
É possível adicionar anotações de eventos a períodos criando um objeto labels e
anexando-o ao objeto TraceSpan ao usar
o patchTraces da API Cloud Trace v1.
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 saber mais, consulte Explorar rastros.
Anotar com eventos de tempo
É possível adicionar anotações de eventos e eventos de mensagem a períodos criando um objeto
TimeEvents e anexando-o ao objeto
Span ao usar a batchWrite da API Cloud Trace
v2.
O objeto TimeEvents é uma matriz de
objetos TimeEvent. Cada um contém um objeto MessageEvent e um
Annotation.
Para visualizar o TimeEvents de um trace, acesse o gráfico de hierarquia dos traces
e clique em Mostrar registros e eventos. Se você selecionar um TimeEvent, os detalhes dele serão exibidos no painel de detalhes.