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. Für den Cloud Trace-Dienst hat der vom System erstellte Bucket beispielsweise den Namen _Trace. Informationen zur Struktur eines Observability-Buckets finden Sie unter Bucket.
Datasets
Ein Dataset ist eine Speichereinheit. Jedes Dataset ist ein untergeordnetes Element eines Observability-Buckets. Wenn das System einen Observability-Bucket für einen Google Cloud Dienst erstellt, wird auch ein Dataset erstellt. Nachdem das System beispielsweise den Bucket _Trace erstellt hat, wird das Dataset mit dem Namen Spans erstellt. In diesem Dataset werden Ihre Trace-Daten gespeichert. 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. Wenn ein Dataset erstellt wird, wird automatisch eine Ansicht 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 Trace-Daten 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 unternimmt einen einzelnen Versuch, den 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.

So stellen Sie fest, ob der Beobachtbarkeits-Bucket mit dem Namen _Trace vorhanden ist, oder lösen einen Ablauf aus, mit dem dieser Bucket erstellt wird:

  1. Rufen Sie in der Google Cloud Console die Seite Trace Explorer auf:

    Zum Trace Explorer

    Sie können diese Seite auch über die Suchleiste finden.

  2. Führen Sie einen der folgenden Schritte aus:

    • Wenn auf der Seite Tracedaten angezeigt werden, müssen Sie nichts weiter tun. IhrGoogle Cloud -Projekt enthält einen Observability-Bucket mit dem Namen _Trace.

    • Wenn auf der Seite das folgende Banner angezeigt wird, sind für Ihre Anwendung keine Trace-Daten vorhanden oder nur Daten aus Cloud Run Functions, Cloud Run und App Engine.

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

      Wenn Sie einen Ablauf auslösen möchten, mit dem ein Observability-Bucket mit dem Namen _Trace erstellt wird, klicken Sie im Banner auf Aktivieren.

    • Wenn auf der Seite das folgende Banner angezeigt wird, ist die Initialisierung des Observability-Buckets mit dem Namen _Trace fehlgeschlagen. Wenn Sie diese Meldung sehen, klicken Sie im Banner auf Ticket einreichen.

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

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.
  • Erstellen Sie Observability-Buckets an anderen Standorten als us. Ein Observability-Bucket muss sich am Standort us befinden.

Nächste Schritte