Trace-Speicher – Übersicht

In diesem Dokument wird das Speichermodell für Cloud Trace-Daten beschrieben. Es werden Beobachtbarkeits-Buckets, Beobachtbarkeitsansichten und Links vorgestellt. Wenn Sie einen Link erstellen, können Sie Ihre Tracedaten in BigQuery abfragen.

In diesem Dokument wird das Schema nicht beschrieben, das angibt, wie einzelne Spans gespeichert werden. Weitere Informationen finden Sie unter Trace-Schema.

Speichermodell für Beobachtbarkeit

Das Speichermodell der Observability API basiert auf der folgenden Architektur:

Beobachtbarkeits-Buckets
Ein Beobachtbarkeits-Bucket ist die Verwaltungseinheit für Datasets, in denen Daten gespeichert werden. Ein Beobachtbarkeits-Bucket befindet sich an einem bestimmten Standort und hat eine Aufbewahrungsrichtlinie für Daten. Wenn ein Google Cloud Dienst die Observability API zum Speichern seiner Daten verwendet, erstellt das System einen Beobachtbarkeits-Bucket basierend auf dem Namen des Dienstes, ein Dataset zum Speichern von Daten und eine Ansicht, um Lesezugriff auf die gespeicherten Daten zu gewähren. Für den Cloud Trace-Dienst benennt das System beispielsweise den vom System erstellten Bucket _Trace, das Dataset Spans, und die Ansicht _AllSpans. Informationen zur Struktur eines Beobachtbarkeits-Buckets finden Sie unter Bucket.
Datasets
In einem Dataset werden Daten gespeichert. Das System erstellt automatisch ein Dataset, wenn es einen Beobachtbarkeits-Bucket erstellt, der das Dataset verwaltet. Wenn das System beispielsweise den Bucket _Trace erstellt, wird auch ein Dataset mit dem Namen Spans erstellt, in dem Ihre Tracedaten gespeichert werden. Informationen zur Struktur eines Datasets finden Sie unter Dataset.
Ansichten von Datasets
Jedes Dataset hostet eine oder mehrere Ansichten. Eine Ansicht bietet Lesezugriff auf eine Teilmenge der Einträge im Dataset. Das System erstellt eine Ansicht, wenn es ein Dataset erstellt. Diese Ansicht enthält alle Daten im Dataset. Der Name der Ansicht hängt vom Dienst ab. Für den Cloud Trace-Dienst erstellt das System beispielsweise eine Ansicht mit dem Namen _AllSpans für das Spans Dataset. Informationen zur Struktur einer Ansicht finden Sie unter View.
Links zu Datasets

Jedes Dataset kann maximal einen Link enthalten. Wenn Sie einen Link für ein Dataset erstellen, erstellt das System ein verknüpftes BigQuery-Dataset. Anschließend können Sie die Daten in Ihrem Dataset mit BigQuery oder anderen Diensten abfragen, die die BigQuery API verwenden. Informationen zur Struktur eines Links finden Sie unter Link.

Das System erstellt nicht automatisch Links zu Datasets.

Speicherkonfiguration für Tracedaten

Ihre Tracedaten werden in einem Beobachtbarkeits-Bucket mit dem Namen _Trace gespeichert. Das System erstellt in diesem Bucket ein Dataset mit dem Namen Spans. In diesem Dataset erstellt das System eine Ansicht mit dem Namen _AllSpans. Diese Ansicht enthält alle Daten im Dataset.

Das System versucht, den Beobachtbarkeits-Bucket mit dem Namen _Trace zu erstellen, wenn der Bucket nicht vorhanden ist und eine der folgenden Bedingungen erfüllt ist:

  • Eine Anwendung sendet Tracedaten mit der Cloud Trace API oder der Telemetry API an Ihr Google Cloud Projekt.

  • Sie aktivieren Cloud Trace für einen Google Cloud Dienst und dieser Dienst sendet dann Tracedaten an Ihr Google Cloud Projekt. Cloud Service Mesh unterstützt beispielsweise das Erfassen von Traces. Die Trace-Erfassung ist jedoch standardmäßig deaktiviert. Wenn Sie das Tracing für Cloud Service Mesh aktivieren, erstellt das System aufgrund der von diesem Dienst gesendeten Daten den Bucket.

    Tracedaten, die von Cloud Run-Funktionen, Cloud Run und App Engine generiert werden, führen nicht dazu, dass das System den Beobachtbarkeits-Bucket erstellt. Spans aus diesen Diensten werden nur gespeichert, wenn der Beobachtbarkeits-Bucket vorhanden ist.

Wenn Sie Tracedaten auf der Seite Trace-Explorer aufrufen können, ist Ihr Beobachtbarkeits-Bucket mit dem Namen _Trace vorhanden. Wenn keine Daten angezeigt werden oder ein Banner mit dem Hinweis, dass der Speicher nicht initialisiert ist, versuchen Sie Folgendes:

Datenstandort für Beobachtbarkeits-Buckets

Wenn Sie Compliance- oder regulatorische Anforderungen haben, Ihre Daten an bestimmten Standorten zu speichern oder kundenverwaltete Verschlüsselungsschlüssel (CMEKs) zu verwenden, empfehlen wir, sowohl Organisationsrichtlinien als auch Standardeinstellungen für Beobachtbarkeits-Buckets zu konfigurieren.

Für Organisationen, Ordner und Projekte können Sie mit den Standardeinstellungen für Beobachtbarkeits-Buckets Folgendes konfigurieren:

  • Einen Standardspeicherort.
  • Für jeden Standort einen Standard-Cloud Key Management Service-Schlüssel.

Wenn diese Einstellungen für ein Projekt konfiguriert sind, gelten sie nur für neue Beobachtbarkeits-Buckets, die in diesem Projekt erstellt werden. Wenn diese Einstellungen für einen Ordner oder eine Organisation konfiguriert sind, gelten sie für neue Beobachtbarkeits-Buckets, die in Projekten erstellt werden, die untergeordnet dem Ordner oder der Organisation sind. Ausgenommen sind Projekte, für die Sie Standardeinstellungen konfiguriert haben.

Sie können auch Organisationsrichtlinien verwenden, um die Standorte neuer Beobachtbarkeits-Buckets einzuschränken, die Verwendung von CMEKs zu erzwingen oder einzuschränken, welche Cloud KMS-Schlüssel für die Verschlüsselung verwendet werden können. Wenn Sie Organisationsrichtlinien konfigurieren, die die Verwendung von CMEKs erfordern, müssen Sie Standardeinstellungen für Beobachtbarkeits-Buckets konfigurieren. Andernfalls schlägt die Bereitstellung für vom System erstellte Beobachtbarkeits-Buckets fehl.

Weitere Informationen finden Sie unter Standardeinstellungen für Beobachtbarkeits-Buckets festlegen.

Beschränkungen

Folgendes ist nicht möglich:

  • Beobachtbarkeits-Buckets ändern oder löschen.
  • Datasets erstellen, löschen oder ändern.
  • Ansichten erstellen, löschen oder ändern.
  • Mit der Google Cloud Console Buckets, Datasets, Ansichten oder Links auflisten.

Nächste Schritte