Trace-Speicher – Übersicht

In diesem Dokument wird das Speichermodell für Cloud Trace-Daten beschrieben. Es werden Beobachtbarkeits-Buckets, Beobachtbarkeitsansichten und Links eingeführt. Wenn Sie eine Verknüpfung 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 die Beobachtbarkeit

Das Speichermodell der Observability API basiert auf der folgenden Architektur:

Beobachtbarkeits-Buckets
Ein Observability-Bucket ist die Verwaltungseinheit für Datasets, in denen Daten gespeichert werden. Ein Observability-Bucket befindet sich an einem bestimmten Ort und hat eine Richtlinie zur Datenaufbewahrung. Wenn ein Google Cloud -Dienst die Observability API zum Speichern seiner Daten verwendet, erstellt das System einen Observability-Bucket basierend auf dem Namen des Dienstes, ein Dataset zum Speichern von Daten und eine Ansicht, um Lesezugriff auf die gespeicherten Daten zu ermöglichen. 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 Observability-Buckets finden Sie unter Bucket.
Datasets
In einem Dataset werden Daten gespeichert. Das System erstellt automatisch ein Dataset, wenn es einen Observability-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 für Datasets
Jedes Dataset enthält mindestens eine Ansicht. 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 wird beispielsweise eine Ansicht mit dem Namen _AllSpans für das Dataset Spans erstellt. 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, wird ein verknüpftes BigQuery-Dataset erstellt. Anschließend können Sie die Daten in Ihrem Dataset mit BigQuery oder anderen Diensten, die die BigQuery API verwenden, abfragen. 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 Observability-Bucket namens _Trace gespeichert. Das System erstellt in diesem Bucket ein Dataset mit dem Namen Spans. Für dieses Dataset wird eine Ansicht mit dem Namen _AllSpans erstellt. Diese Ansicht enthält alle Daten im Dataset.

Das System versucht, den Observability-Bucket mit dem Namen _Trace zu erstellen, wenn der Bucket nicht vorhanden ist und eine der folgenden Bedingungen zutrifft:

  • Eine Anwendung sendet Trace-Daten an Ihr Google Cloud -Projekt, indem sie die Cloud Trace API oder die Telemetry API verwendet.

  • Sie aktivieren Cloud Trace für einen Google Cloud -Dienst. Dieser Dienst sendet dann Trace-Daten 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 Tracing für Cloud Service Mesh aktivieren, wird der Bucket durch die von diesem Dienst gesendeten Daten erstellt.

    Durch Trace-Daten, die von Cloud Run Functions, Cloud Run und App Engine generiert werden, wird nicht automatisch der Beobachtbarkeits-Bucket erstellt. Spans aus diesen Diensten werden nur gespeichert, wenn der Observability-Bucket vorhanden ist.

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

Datenstandort für Observability-Buckets

Wenn Sie Compliance- oder behördliche Anforderungen haben, Ihre Daten an bestimmten Standorten zu speichern oder CMEK zu verwenden, empfehlen wir, Standardeinstellungen für Observability-Buckets zu konfigurieren:

  • Mit Standardeinstellungen für Observability-Buckets können Sie für Organisationen, Ordner und Projekte Folgendes konfigurieren:

    • Ein Standardspeicherort.
    • Für jeden Standort ein standardmäßiger Cloud Key Management Service-Schlüssel.

    Untergeordnete Elemente in der Ressourcenhierarchie verwenden diese Einstellungen automatisch, mit Ausnahme der untergeordneten Elemente, für die Sie Standardeinstellungen konfiguriert haben.

    Die Standardeinstellungen für Observability-Buckets gelten nur für neue Ressourcen, nicht für vorhandene Ressourcen. Weitere Informationen finden Sie unter Standardeinstellungen für Observability-Buckets festlegen.

Die Standardeinstellungen für Observability-Buckets gelten nicht für Log-Buckets, in denen Logdaten gespeichert werden. Informationen zum Festlegen des Standardspeicherorts oder zum Erzwingen von CMEK für Log-Buckets finden Sie unter Standardressourceneinstellungen für Cloud Logging konfigurieren.

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
  • Verwenden Sie die Google Cloud Console, um Buckets, Datasets, Ansichten oder Links aufzulisten.

Nächste Schritte