Présentation du stockage des traces

Ce document décrit le modèle de stockage des données Cloud Trace. Il présente les buckets, les vues et les liens d'observabilité. Si vous créez un lien, vous pouvez interroger vos données de trace depuis BigQuery.

Ce document ne décrit pas le schéma, qui spécifie la façon dont les portées individuelles sont stockées. Pour en savoir plus, consultez Schéma de trace.

Modèle de stockage de l'observabilité

Le modèle de stockage de l'API Observability repose sur l'architecture suivante :

Buckets d'observabilité
Un bucket d'observabilité est l'entité de gestion des ensembles de données, qui stockent les données. Un bucket d'observabilité se trouve dans un emplacement spécifique et dispose d'une règle de conservation des données. Lorsqu'un service Google Cloud utilise l'API Observability pour stocker ses données, le système crée un bucket d'observabilité en fonction du nom du service. Par exemple, pour le service Cloud Trace, le bucket créé par le système est nommé _Trace. Pour en savoir plus sur la structure d'un bucket d'observabilité, consultez Bucket.
Ensembles de données
Un ensemble de données est une entité de stockage. Chaque ensemble de données est un enfant d'un bucket d'observabilité. Lorsque le système crée un bucket d'observabilité pour un service Google Cloud , il crée également un ensemble de données. Par exemple, une fois que le système a créé le bucket _Trace, il crée l'ensemble de données nommé Spans. Ce jeu de données stocke vos données de trace. Pour en savoir plus sur la structure d'un ensemble de données, consultez Dataset.
Vues sur les ensembles de données
Chaque ensemble de données héberge une ou plusieurs vues. Une vue permet d'accéder en lecture à un sous-ensemble d'entrées de l'ensemble de données. Lorsqu'un ensemble de données est créé, le système crée automatiquement une vue. Cette vue inclut toutes les données de l'ensemble de données. Le nom de la vue dépend du service. Par exemple, pour le service Cloud Trace, le système crée une vue nommée _AllSpans sur l'ensemble de données Spans. Pour en savoir plus sur la structure d'une vue, consultez View.
Liens vers des ensembles de données

Chaque ensemble de données peut contenir au maximum un lien. Lorsque vous créez un lien pour un ensemble de données, le système crée un ensemble de données BigQuery associé. Vous pouvez ensuite interroger les données de votre ensemble de données à l'aide de BigQuery ou d'autres services qui utilisent l'API BigQuery. Pour en savoir plus sur la structure d'un lien, consultez Link.

Le système ne crée pas automatiquement de liens vers les ensembles de données.

Configuration du stockage pour les données de trace

Vos données de trace sont stockées dans un bucket d'observabilité nommé _Trace. Le système crée un ensemble de données nommé Spans dans ce bucket. Dans cet ensemble de données, le système crée une vue nommée _AllSpans. Cette vue inclut toutes les données de l'ensemble de données.

Le système tente une seule fois de créer le bucket nommé _Trace lorsque celui-ci n'existe pas et que l'une des conditions suivantes est remplie :

  • Une application envoie des données de trace à votre projet Google Cloud à l'aide de l'API Cloud Trace ou de l'API Telemetry.

  • Vous activez Cloud Trace pour un service Google Cloud , puis ce service envoie les données de trace à votre projet Google Cloud . Par exemple, Cloud Service Mesh permet de collecter des traces, mais cette fonctionnalité est désactivée par défaut. Si vous activez le traçage pour Cloud Service Mesh, les données envoyées par ce service entraînent la création du bucket par le système.

    Les données de trace générées par Cloud Run Functions, Cloud Run et App Engine n'entraînent pas la création du bucket d'observabilité par le système. Les spans de ces services ne sont stockés que lorsque le bucket d'observabilité existe.

Pour déterminer si le bucket d'observabilité nommé _Trace existe ou pour déclencher un flux qui crée ce bucket, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Explorateur Trace :

    Accéder à Explorateur Trace

    Vous pouvez également accéder à cette page à l'aide de la barre de recherche.

  2. Effectuez l'une des opérations suivantes :

    • Si la page affiche des données de trace, vous n'avez rien à faire. Votre projetGoogle Cloud contient un bucket d'observabilité nommé _Trace.

    • Si la page affiche la bannière suivante, cela signifie que votre page ne contient aucune donnée de trace ou qu'elle ne contient que des données provenant de Cloud Run Functions, Cloud Run et App Engine.

      Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.

      Si vous souhaitez déclencher un flux qui crée un bucket d'observabilité nommé _Trace, accédez à la bannière et cliquez sur Activer.

    • Si la page affiche la bannière suivante, cela signifie que l'initialisation du bucket d'observabilité nommé _Trace a échoué. Si vous voyez ce message, accédez à la bannière et cliquez sur Déposer une demande.

      Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

Limites

Vous ne pouvez pas :

  • Modifier ou supprimer des buckets d'observabilité
  • Créer, supprimer ou modifier des ensembles de données
  • créer, supprimer ou modifier des vues ;
  • Utilisez la console Google Cloud pour lister les buckets, les ensembles de données, les vues ou les liens.
  • Créez des buckets d'observabilité dans des emplacements autres que us. Un bucket d'observabilité doit se trouver dans l'emplacement us.

Étapes suivantes