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é par une paire clé-valeur.
Par exemple, un attribut peut enregistrer un identifiant d'instance. Pour obtenir des exemples d'attributs, consultez la page de référence de l'API pour Attributes.
Annoter avec des libellés
Pour ajouter des annotations d'événement aux segments, créez un objet labels et associez-le à l'objet TraceSpan lorsque vous utilisez patchTraces dans l'API Cloud Trace v1.
Ces annotations d'événement s'affichent 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énement s'affichent 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énements et des événements de message aux segments 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 des traces, puis 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.