Vous pouvez ajouter du contenu défini par l'utilisateur à une trace. L'API Cloud Trace v1 vous permet d'ajouter des libellés, tandis que l'API Cloud Trace v2 vous permet d'ajouter des événements ou des attributs temporels.
Les événements temporels sont plus flexibles, car ils vous permettent de spécifier un message sous la forme d'une chaîne, en plus d'un ensemble d'attributs.
Chaque attribut est représenté sous la forme d'une paire clé/valeur.
Par exemple, un attribut peut enregistrer un identifiant d'instance. Pour obtenir des exemples d'attributs, consultez la page de documentation de référence de l'API pour Attributes
.
Annoter avec des libellés
Vous pouvez ajouter des annotations d'événements aux délais en créant un objet labels
et en l'associant à l'objet TraceSpan
lorsque vous utilisez l'API Cloud Trace v1 patchTraces
.
Ces annotations d'événements sont affichées sous forme de libellés lorsque vous affichez les détails d'une trace. Pour en savoir plus sur les libellés, consultez la section Libellés Trace.
Annoter avec des attributs
Vous pouvez annoter des délais en créant un objet attributes
et en l'associant à l'objet Span
lorsque vous utilisez l'API Cloud Trace v2 batchWrite
.
Ces annotations d'événements sont affichées sous forme de libellés lorsque vous affichez les détails d'une trace. Pour en savoir plus, consultez Explorer une trace.
Annoter avec des événements temporels
Vous pouvez ajouter des annotations d'événement et des événements de message aux délais en créant un objet TimeEvents
et en l'associant à l'objet Span lorsque vous utilisez l'API Cloud Trace v2 batchWrite
.
L'objet TimeEvents
est un tableau d'objets TimeEvent
, chacun contenant un objet MessageEvent
et un objet Annotation
.
Pour afficher le TimeEvents
d'une trace, accédez au graphique en cascade de traces et cliquez sur Afficher les journaux et les événements. Si vous sélectionnez un TimeEvent
, ses détails s'affichent dans le volet de détails.