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 d'observabilité, les vues d'observabilité et les liens. Si vous créez un lien, vous pouvez interroger vos données de trace à partir de BigQuery.

Ce document ne décrit pas le schéma, qui spécifie comment les étendues individuelles sont stockées. Pour en savoir plus, consultez la section Schéma de trace.

Modèle de stockage d'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 Google Cloud service utilise l' API Observability pour stocker ses données, le système crée un bucket d'observabilité en fonction du nom du service, d'un ensemble de données pour stocker les données et d'une vue pour fournir un accès en lecture aux données stockées. Par exemple, pour le service Cloud Trace, le système nomme le bucket créé par le système _Trace, l'ensemble de données Spans, et la vue _AllSpans. Pour en savoir plus sur la structure d'un bucket d'observabilité, consultez la section Bucket.
Ensembles de données
Un ensemble de données stocke des données. Le système crée automatiquement un ensemble de données lorsqu'il crée un bucket d'observabilité, qui gère l'ensemble de données. Par exemple, lorsque le système crée le bucket _Trace, il crée également un ensemble de données nommé Spans, qui stocke vos données de trace. Pour en savoir plus sur la structure d'un ensemble de données, consultez la section Dataset.
Vues sur les ensembles de données
Chaque ensemble de données héberge une ou plusieurs vues. Une vue fournit un accès en lecture à un sous-ensemble d'entrées de l'ensemble de données. Le système crée une vue lorsqu'il crée un ensemble de données. 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 la section View.
Liens sur les 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 la section Link.

Le système ne crée pas automatiquement de liens sur 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 sur ce bucket. Sur 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 lorsqu'il n'existe pas et que l'une des conditions suivantes est remplie :

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

  • Vous activez Cloud Trace pour un Google Cloud service, puis ce service envoie des données de trace à votre Google Cloud projet. Par exemple, Cloud Service Mesh est compatible avec la collecte de traces. Toutefois, 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 étendues de ces services ne sont stockées que lorsque le bucket d'observabilité existe.

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

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

Si vous devez respecter des exigences réglementaires ou de conformité pour stocker vos données dans des emplacements spécifiques ou utiliser des CMEK, nous vous recommandons de configurer les paramètres par défaut pour les 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.
    • Pour chaque emplacement, une clé Cloud Key Management Service par défaut.

    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 aux ressources existantes. Pour en savoir plus, consultez la section 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 des CMEK pour les buckets de journaux, consultez la section Configurer les paramètres de ressource par défaut pour Cloud Logging.

Limites

Vous ne pouvez pas effectuer les opérations suivantes :

  • Modifier ou supprimer des buckets d'observabilité.
  • Créer, supprimer ou modifier des ensembles de données.
  • Créer, supprimer ou modifier des vues.
  • Utiliser la Google Cloud console pour répertorier des buckets, des ensembles de données, des vues ou des liens.

Étape suivante