Zu Observability Analytics migrieren

Wenn Sie Trace-Senken verwenden, um Cloud Trace-Daten nach BigQuery zu exportieren, migrieren Sie zu Observability Analytics. Trace-Senken sind eingestellt und werden am oder nach dem 18. Februar 2027 entfernt. Mit Observability Analytics können Sie Ihre Tracedaten direkt mit derselben SQL-Abfragesprache wie BigQuery abfragen, ohne Exportsinks verwalten zu müssen.

Wenn Sie BigQuery-Dienste zum Verknüpfen von Datasets, zum Verwalten von Tabellen oder zum Exportieren von Daten verwenden möchten, können Sie ein verknüpftes BigQuery-Dataset erstellen. Sie können das verknüpfte BigQuery-Dataset während der Migration oder zu einem späteren Zeitpunkt erstellen. 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 einfach 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, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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. Führen Sie die Aktionen aus, die im Abschnitt Vorbereitung dieses Dokuments aufgeführt sind. Dazu gehört das Aktivieren der Observability API.

2. Prüfen Sie mit Observability Analytics, ob Sie Zugriff auf Ihre Trace-Daten haben:

   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. Gehen Sie im Menü Ansichten zum Bereich Traces und wählen Sie _Trace.Spans._AllSpans aus.

      Der Bereich Schema wird aktualisiert und das Schema wird angezeigt.

      Wenn Sie keine Ansicht mit dem Namen _Trace.Spans._AllSpans sehen, enthält IhrGoogle Cloud -Projekt keinen Observability-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 eigenes 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