Zu Observability Analytics migrieren

Wenn Sie Senken verwenden, um Tracedaten nach BigQuery zu exportieren, ist dieses Dokument für Sie relevant. Die Verwendung von Senken zum Exportieren von Tracedaten wird nicht mehr empfohlen. Stattdessen empfehlen wir die Verwendung von Observability Analytics, das dieselbe SQL-Abfragesprache wie BigQuery unterstützt. In diesem Dokument wird beschrieben, wie Sie von einer senkenbasierten Lösung zu einer Lösung migrieren, die Observability Analytics verwendet. Außerdem finden Sie Informationen dazu, wie Sie Ihre Tracedaten mit BigQuery-Diensten abfragen.

BigQuery bietet Dienste, mit denen Sie Tabellen kopieren oder Daten exportieren können. Nachdem Sie ein verknüpftes BigQuery-Dataset erstellt haben (ein optionaler Schritt, der in diesem Dokument beschrieben wird), können Sie Ihre Tracedaten mit diesen Diensten kopieren und exportieren. Weitere Informationen finden Sie unter Tabellen verwalten und Einführung in den Datenexport.

Informationen zum Einstieg in Observability Analytics finden Sie unter Traces abfragen und analysieren.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Laden der Seite Observability Analytics, zum Ausführen von Abfragen und zum Erstellen eines verknüpften BigQuery-Datasets benötigen:

   • Cloud Trace-Administrator (roles/cloudtrace.admin)
   • Observability Editor (roles/observability.editor)
   • BigQuery User (roles/bigquery.user)

   Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

   Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

2. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

Zu Observability Analytics migrieren

1. Sie haben die Aktionen ausgeführt, die im Abschnitt Vorbereitung dieses Dokuments aufgeführt sind. Dazu gehört das Aktivieren der Observability API.

2. So prüfen Sie, ob Sie mit Observability Analytics auf Ihre Trace-Daten zugreifen können:

   1. Rufen Sie in der Google Cloud Console die Seite Observability Analytics auf:

      Zu Observability Analytics

      Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis mit der Zwischenüberschrift Logging aus.

   2. Rufen Sie im Menü Ansichten den Bereich Traces auf und wählen Sie _Trace.Spans._AllSpans aus.

      Der Bereich Schema wird aktualisiert und zeigt das Schema an.

      Wenn Sie keine Ansicht mit dem Namen _Trace.Spans._AllSpans sehen, enthält IhrGoogle Cloud -Projekt keinen Beobachtungs-Bucket mit dem Namen _Trace. Informationen zur Behebung dieses Problems finden Sie unter Fehler bei der Initialisierung des Trace-Speichers.

   3. Wählen Sie im Bereich Schema die Option Abfrage aus.

      Das Feld des Abfrageeditors wird aktualisiert. Die FROM-Klausel enthält einen Eintrag, der in etwa so aussieht:

      `PROJECT_ID.us._Trace.Spans._AllSpans`
      

   4. Wählen Sie in der Symbolleiste Abfrage ausführen aus.

      Wenn in der Symbolleiste In BigQuery ausführen angezeigt wird, klicken Sie auf  Einstellungen und wählen Sie Analytics (Standard) aus.

   Sie haben überprüft, ob Sie Ihre Trace-Daten über die Seite Observability Analytics abfragen können.

3. Optional: Wenn Sie Ihre Tracedaten mit anderen Geschäftsdaten verknüpfen möchten, die in BigQuery verfügbar sind, erstellen Sie ein verknüpftes BigQuery-Dataset. Weitere Informationen finden Sie unter Verknüpftes BigQuery-Dataset abfragen.

4. Löschen Sie Senken für Traces und unnötige Datasets:

   1. Führen Sie den Befehl gcloud alpha trace sinks list aus, um vorhandene Trace-Senken aufzulisten:

      gcloud alpha trace sinks list
      

   2. Führen Sie für jede Senke den Befehl gcloud alpha trace sinks delete aus:

      gcloud alpha trace sinks delete SINK_NAME
      

   3. Optional: Löschen Sie alle unnötigen BigQuery-Datasets. Informationen zum Löschen eines BigQuery-Datasets finden Sie unter Datasets löschen.

Schemavergleich

In diesem Abschnitt finden Sie Informationen zu den Unterschieden zwischen Observability Analytics- und Senken-basierten Exportschemas.

Name	Analysen	Alt
Trace-ID	trace_id	extendedFields.traceId
Span-ID	span_id	span.spanId
Übergeordnete Span-ID	parent_span_id	span.parentSpanId
Span-Name	name	span.displayName.value
Span-Art	kind Werte finden Sie unter OpenTelemetry: SpanKind.	span.spanKind Werte finden Sie auf der Seite SpanKind in der Cloud Trace API-Referenz.
Beginn des Zeitraums	start_time	span.startTime
Ende des Zeitraums	end_time	span.endTime
Attribute	Die Attribute für Spans, Ressourcen und Instrumentierung haben jeweils ein eindeutiges Format. Diese Felder haben den BigQuery-JSON-Datentyp. Beispiele: attributes["somekey"] resource.attributes["somekey"] instrumentation_scope.attributes["somekey"]	Alle Attribute haben dasselbe Format: span.attributes.attributeMap.ATTRIBUTE_KEY Beispiele: span.attributes.attributeMap._http_method span.attributes.attributeMap.g_co_agent span.attributes.attributeMap.rpc_service span.attributes.attributeMap.rpc_method

Nächste Schritte

• Traces abfragen und analysieren
• Beispielabfragen