Zu Observability Analytics migrieren

Vorschau

Dieses Produkt oder Feature unterliegt den "Nutzungsbedingungen für Pre-GA-Angebote" im Abschnitt "Allgemeine Dienstbedingungen" der Dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Wenn Sie Sinks verwenden, um Trace-Daten nach BigQuery zu exportieren, dann gilt dieses Dokument für Sie. Die Verwendung von Sinks zum Exportieren von Trace-Daten 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 sinkbasierten Lösung zu einer Lösung migrieren, die Observability Analytics verwendet. Außerdem erfahren Sie, wie Sie Ihre Trace-Daten mit BigQuery-Diensten abfragen.

Informationen zu den ersten Schritten mit Observability Analytics finden Sie unter Traces abfragen und analysieren.

Hinweis

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Google Cloud-Konto haben, erstellen Sie ein Konto, um die Leistung 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 Observability Analytics Seite, zum Ausführen von Abfragen und zum Erstellen eines verknüpften Datasets benötigen:

   • Cloud Trace-Administrator (roles/cloudtrace.admin)
   • Observability-Bearbeiter (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 Befehlszeilenaufforderung 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 im Abschnitt Vorbereitung dieses Dokuments aufgeführten Aktionen ausgeführt. Dazu gehört das Aktivieren der Observability API.

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

   1. Rufen Sie in der Google Cloud Console die Loganalysen Seite auf.

      Zu Loganalysen

      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 dann _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 Ihr Google Cloud Projekt keinen Observability-Bucket mit dem Namen _Trace. Informationen zum Beheben 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 ähnlich dem folgenden:

      `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 geprüft, ob Sie Ihre Trace-Daten über die Seite Observability Analytics abfragen können.

3. Optional: Wenn Sie Ihre Trace-Daten 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. Trace-Sinks und unnötige Datasets löschen:

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

      gcloud alpha trace sinks list
      

   2. Führen Sie für jeden Sink den gcloud alpha trace sinks delete Befehl 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 werden die Unterschiede zwischen den Schemas für Observability Analytics und sinkbasierten Export beschrieben.

Name	Analyse	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 in der Cloud Trace API-Referenz SpanKind Seite.
Startzeit des Spans	start_time	span.startTime
Endzeit des Spans	end_time	span.endTime
Attribute	Span-, Ressourcen- und Instrumentation-Attribute 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.