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 de créer le bucket d'observabilité nommé _Trace lorsque le bucket 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.

Si vous pouvez afficher les données de trace à l'aide de la page Explorateur Trace, cela signifie que votre bucket d'observabilité nommé _Trace existe. Si vous ne voyez aucune donnée ou si une bannière indiquant que le stockage n'est pas initialisé s'affiche, essayez l'une des solutions suivantes :

Résidence des données pour les buckets d'observabilité

Si vous devez stocker vos données dans des emplacements spécifiques ou utiliser des CMEK pour respecter des exigences réglementaires ou de conformité, nous vous recommandons de configurer les paramètres par défaut des buckets d'observabilité :

  • Pour les organisations, les dossiers et les projets, les paramètres par défaut des buckets d'observabilité vous permettent de configurer les éléments suivants :

    • Un emplacement de stockage par défaut.
    • Une clé Cloud Key Management Service par défaut pour chaque emplacement.

    Les descendants de la hiérarchie des ressources utilisent automatiquement ces paramètres, à l'exception de ceux pour lesquels vous avez configuré des paramètres par défaut.

    Les paramètres par défaut des buckets d'observabilité ne s'appliquent qu'aux nouvelles ressources, et non à celles existantes. Pour en savoir plus, consultez Définir des valeurs par défaut pour les buckets d'observabilité.

Les paramètres par défaut des buckets d'observabilité ne s'appliquent pas aux buckets de journaux, qui stockent les données de journaux. Pour savoir comment définir l'emplacement par défaut ou exiger l'utilisation de CMEK pour les buckets de journaux, consultez Configurer les paramètres de ressources par défaut pour Cloud Logging.

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.

Étape suivante