Traces et segments

Ce document présente les traces et les segments. Une trace représente une seule opération de bout en bout. Les traces sont composées de segments, qui sont des enregistrements associés à une seule fonction ou opération.

Modèle de données Trace

Une trace possède les propriétés suivantes:

  • ID de trace: identifiant unique de l'opération de bout en bout. L'ID de trace doit être propagé en tant que contexte dans le cadre de l'opération de bout en bout.

  • Ensemble de segments qui partagent la même valeur pour l'ID de trace.

    Cloud Trace utilise l'ID de trace pour identifier les délais de son dépôt associés à la même trace.

Modèle de données des segments

Un segment correspond à une opération qui s'est produite sur une période finie, mais non nulle. Voici quelques propriétés essentielles stockées par chaque segment:

  • ID de trace: identifiant de l'opération de bout en bout dans laquelle cette opération globale particulière a eu lieu.
  • ID du segment: identifiant unique du segment. Si la même opération est appelée plusieurs fois dans le traitement d'une même opération globale, une trace peut contenir plusieurs délais portant le même nom. Cependant, chaque segment possède un ID distinct.
  • Parent span ID (ID de segment parent) : identifie l'opération qui a appelé ce segment. L'ID du délai parent est défini sur null pour le délai "root".
  • Nom: nom de l'opération effectuée.
  • Start time (Heure de début) : heure de début de l'opération.
  • End time (Heure de fin) : heure de fin de l'opération.

Les segments peuvent également contenir des attributs, qui stockent des informations supplémentaires sur une opération à l'aide de paires clé/valeur. Cloud Trace recommande d'utiliser les conventions sémantiques OpenTelemetry dans la mesure du possible.

Ressources

Ressources OpenTelemetry:

Étapes suivantes