Tracebereiche erstellen und verwalten

In diesem Dokument wird beschrieben, wie Sie einen Trace-Bereich erstellen und verwalten, damit auf der Seite Trace Explorer die Trace-Spans gefunden werden, die Sie ansehen oder analysieren möchten. Wenn Sie nur die Spans ansehen und analysieren möchten, die in Ihrem Google Cloud -Projekt erstellt wurden, müssen Sie keine Trace-Bereiche konfigurieren. Wenn Ihre Trace-Daten jedoch in mehreren Projekten gespeichert sind, wie es bei einer Mikrodienstarchitektur der Fall sein kann, müssen Sie einige Konfigurationsschritte ausführen, um alle Spans aus einem einzelnen Google Cloud Projekt aufzurufen.

In diesem Dokument wird nicht beschrieben, wie Sie Ihre Traces und Spans aufrufen. Informationen zu diesem Thema finden Sie unter Traces finden und ansehen.

Diese Funktion wird nur für Google Cloud -Projekte unterstützt. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

Tracebereiche

Tracebereiche sind dauerhafte Ressourcen auf Projektebene, in denen Ansichten aufgeführt sind, die Zugriff auf Ihre Tracedaten ermöglichen. Sie können die Seite Trace-Explorer so konfigurieren, dass nach Tracebereich gesucht wird. Das bedeutet, dass auf der Seite in den Ansichten gesucht wird, die im ausgewählten Bereich aufgeführt sind. Ihre IAM-Rollen (Identity and Access Management) für die durchsuchte Ansicht und die Einstellung für den Zeitraum bestimmen, welche Daten das System aus dem Speicher abruft und dann anzeigt.

Sie können Ablaufverfolgungsbereiche erstellen sowie alle von Ihnen erstellten Ablaufverfolgungsbereiche ändern und löschen. Sie möchten einen Trace-Bereich erstellen, wenn Sie einen Dienst haben, der Spandaten in mehrere Google Cloud Projekte schreibt.

In einem Tracebereich werden Ansichten und nicht Google Cloud Projekte aufgeführt. Wenn Sie beim Konfigurieren eines Trace-Bereichs Projekte auswählen, fügt das System dem Bereich die Standard-Trace-Ansicht dieser Projekte hinzu. Die Standardansicht für Traces eines Projekts entspricht der Ansicht mit dem Pfad _Trace/Spans/_AllSpans, wobei sich die Felder _Trace, Spans und _AllSpans auf einen Observability-Bucket, ein Dataset und eine Ansicht beziehen. Im Dataset Spans werden Ihre Tracedaten gespeichert.

Sofern Sie die Seite Trace-Explorer nicht mit einer URL öffnen, die einen Tracebereich oder eine Trace- und Span-ID enthält, wird auf der Seite Trace-Explorer in den im Standard-Tracebereich aufgeführten Ansichten nach Tracedaten gesucht. Wenn Sie Ihr Projekt erstellen, wird der Trace-Bereich mit dem Namen _Default als Standard-Trace-Bereich festgelegt. Sie können jedoch einen anderen Ablaufverfolgungsbereich als Standard festlegen.

Bereich der Beobachtbarkeit

Mit dem Beobachtbarkeitsbereich wird festgelegt, welche Ihrer Trace- und Logbereiche verwendet werden, wenn die entsprechenden Explorer-Seiten geöffnet werden. Wenn Sie den Beobachtbarkeitsbereich nicht so konfigurieren, dass die Ressourcen aufgeführt werden, in denen Ihre Daten gespeichert sind, können Sie Ihre Trace- und Logdaten möglicherweise nicht in Beziehung setzen. Weitere Informationen finden Sie unter Beobachtbarkeitsbereiche für projektübergreifende Abfragen konfigurieren.

App Hub-Anwendungen und Trace-Bereiche

Ihre App Hub-Anwendungen schreiben möglicherweise Trace-Daten in mehrere Projekte. Wenn Sie eine aggregierte Ansicht dieser Daten erhalten möchten, erstellen Sie einen Tracebereich, konfigurieren Sie ihn so, dass die Standard-Traceansicht aller Projekte mit Tracedaten aufgeführt wird, und legen Sie ihn dann als Standard-Tracebereich fest. Wenn Sie diese Schritte ausführen, werden auf der Seite Trace Explorer automatisch die von Ihrer Anwendung geschriebenen Daten angezeigt, auch wenn diese Daten in verschiedenen Projekten gespeichert sind.

Erstellen Sie den benutzerdefinierten Trace-Bereich in dem Projekt, in dem Sie Ihre Trace-Daten ansehen. Dieses Projekt ist Ihr App Hub-Hostprojekt oder Ihr Verwaltungsprojekt. Wenn der Anzeigename eines Ordners beispielsweise My Folder ist, lautet der Anzeigename des Verwaltungsprojekts des Ordners My Folder-mp.

Hinweis

  1. 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.

  2. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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

  5. 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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. 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

    8.

  8. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Observability Scopes Editor (roles/observability.scopesEditor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Aufrufen von Trace-Bereichen benötigen. 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.

    Die Rolle „Observability Scopes Editor“ umfasst private Berechtigungen, mit denen Sie Trace-Bereiche erstellen und ansehen können. Diese Berechtigungen können nicht in benutzerdefinierte IAM-Rollen aufgenommen werden.

  9. Wählen Sie den Tab aus, der Ihrer geplanten Verwendung der Beispiele auf dieser Seite entspricht:

    Console

    Wenn Sie über die Google Cloud Console auf Google Cloud Dienste und APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

    gcloud

    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.

    Terraform

    Wenn Sie die Terraform-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

    1. Installieren Sie die Google Cloud CLI.

    2. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    3. Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto: 

      gcloud auth application-default login

      Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.

      Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

    Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter ADC für eine lokale Entwicklungsumgebung einrichten.

    REST

    Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

      Installieren Sie die Google Cloud CLI.

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Tracebereiche auflisten

Console

So listen Sie die Trace-Bereiche auf:

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

    Einstellungenaufrufen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

  3. Wählen Sie den Tab Trace Scopes aus.

    Im Fenster wird eine Liste Ihrer Trace-Bereiche angezeigt. Der Eintrag mit dem Symbol „Standard“  ist der Standard-Trace-Bereich.

  4. Maximieren Sie einen Trace-Bereich, um die Details aufzurufen.

    Wenn Sie einen Trace-Bereich maximieren, sehen Sie die Liste der Ansichten, die er enthält. In jeder Zeile wird eine Projekt-ID zusammen mit einem Eintrag wie _Trace/Spans/_AllSpans aufgeführt, der den Standardspeicherort für Ihre Trace-Daten angibt. Die Felder _Trace, Spans und _AllSpans verweisen auf den Observability-Bucket, das Dataset und die Ansicht für Ihre Tracedaten. Die _AllSpans-Ansicht entspricht jedem Eintrag im Bucket:

    Name Beschreibung Typ Ressourcen
    _Default Trace scope 1
    myscope My description Trace scope 2
      _Trace/Spans/_AllSpans myproject Trace view
      _Trace/Spans/_AllSpans project-b Trace view

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • LOCATION: Der Speicherort des Trace-Bereichs. Dieses Feld muss den Wert global haben.
  • PROJECT_ID: Die Kennung des Projekts.

Führen Sie den Befehl gcloud observability trace-scopes list aus:

Linux, macOS oder Cloud Shell

gcloud observability trace-scopes list \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes list `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes list ^
 --location=LOCATION --project=PROJECT_ID

Die Antwortdaten sind eine Liste von Trace-Bereichen. Für jeden Bereich werden der Name und die relevanten Informationen angezeigt. Das folgende Beispiel zeigt das Ergebnis des Befehls list für ein Projekt mit zwei Trace-Bereichen: 

name: projects/my-project/locations/global/traceScopes/_Default
resourceNames:
- projects/my-project
---
createTime: '2026-03-26T13:43:54.772326947Z'
description: a test
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:43:54.772326947Z'

Terraform

Sie können mit Terraform einen Trace-Bereich erstellen und ändern. Sie können Terraform jedoch nicht verwenden, um Ablaufverfolgungsbereiche aufzulisten.

REST

Verwenden Sie den Befehl projects.locations.traceScopes.list, um alle Trace-Bereiche in einem Google Cloud Projekt aufzulisten. Sie müssen einen Pfadparameter angeben.

Der Pfadparameter für diesen Endpunkt hat die folgende Syntax:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  • LOCATION_ID muss auf global festgelegt sein.

Die Antwort ist ein Array von TraceScope-Objekten. Jedes Objekt enthält einen Namen und eine Liste von Ressourcen.

Mit dem Befehl projects.locations.traceScopes.get können Sie Informationen zu einem bestimmten Trace-Bereich abrufen.

Tracebereich erstellen

Die auf der Seite Trace-Explorer angezeigten Spannen hängen von den durchsuchten Ansichten, Ihren IAM-Rollen für diese Ansichten, der Einstellung für den Zeitraum und den angewendeten Filtern ab.

Sie können 100 Trace-Bereiche pro Projekt erstellen. Ein Tracebereich kann insgesamt 20 Ansichten enthalten.

Console

So erstellen Sie einen Trace-Bereich:

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

    Einstellungenaufrufen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  3. Wählen Sie den Tab Trace Scopes (Bereiche für Traces) aus und klicken Sie dann auf Create trace scope (Bereich für Traces erstellen).

  4. Klicken Sie auf Projekte hinzufügen und füllen Sie das Dialogfeld aus.

  5. Geben Sie im Abschnitt Name trace scope (Trace-Bereich benennen) den Namen und die Beschreibung ein, die auf dem Tab Trace Scopes (Trace-Bereiche) angezeigt werden sollen.

    Der Name eines Tracebereichs kann nicht geändert werden und muss innerhalb des Projekts eindeutig sein.

  6. Klicken Sie auf Trace-Bereich erstellen.

    Standardmäßig werden die Trace-Bereiche in der Tabelle Trace scopes (Trace-Bereiche) in minimierter Form aufgeführt. Für jeden Bereich sind in der Tabelle ein Name, eine Beschreibung, ein Typ und die Anzahl der Ressourcen aufgeführt.

    Wenn Sie einen Trace-Bereich maximieren, sehen Sie die Liste der Ansichten, die er enthält. In jeder Zeile wird eine Projekt-ID zusammen mit einem Eintrag wie _Trace/Spans/_AllSpans aufgeführt, der den Standardspeicherort für Ihre Trace-Daten angibt. Die Felder _Trace, Spans und _AllSpans verweisen auf den Observability-Bucket, das Dataset und die Ansicht für Ihre Tracedaten. Die _AllSpans-Ansicht entspricht jedem Eintrag im Bucket:

    Name Beschreibung Typ Ressourcen
    _Default Trace scope 1
    myscope My description Trace scope 2
      _Trace/Spans/_AllSpans myproject Trace view
      _Trace/Spans/_AllSpans project-b Trace view

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • TRACE_SCOPE_NAME: Der Name eines Trace-Bereichs. Beispiel: my-trace-scope.
  • DESCRIPTION: Optional. Die Beschreibung des Tracebereichs. Formatiere die Beschreibung als String.
  • RESOURCE_NAMES: Eine durch Kommas getrennte Liste der vollständig qualifizierten Namen von Projekten. Beispiel: projects/my-project.
  • LOCATION: Der Speicherort des Trace-Bereichs. Dieses Feld muss den Wert global haben.
  • PROJECT_ID: Die Kennung des Projekts.

Führen Sie den Befehl gcloud observability trace-scopes create aus:

Linux, macOS oder Cloud Shell

gcloud observability trace-scopes create TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes create TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes create TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

Bei Erfolg enthält die Antwort des create-Befehls den Namen des neuen Trace-Bereichs: 

Created traceScope [my-test-scope].

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle. Weitere Informationen finden Sie in der Referenzdokumentation des Anbieters zu Terraform.

Verwenden Sie zum Erstellen eines Trace-Bereichs in einem Projekt mit Terraform die Terraform-Ressource google_observability_trace_scope.

Legen Sie im Befehl die folgenden Felder fest:

  • project: Der Name Ihres Projekts, Ordners oder Ihrer Organisation. Beispiel: my-project. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

  • trace_scope_id: Auf eine Bereichs-ID festlegen. Beispiel: my-trace-scope.

  • location: Legen Sie "global" fest.

  • resource_names: Ein Array von Projekten, wobei jedes Projekt mit seinem vollständig qualifizierten Namen angegeben wird.

  • description: Eine kurze Beschreibung. Beispiel: „Scope for production resources“ (Bereich für Produktionsressourcen).

REST

Verwenden Sie zum Erstellen eines Trace-Bereichs den Befehl projects.locations.traceScopes.create. Sie müssen einen Pfadparameter angeben und ein TraceScope-Objekt bereitstellen. Die Antwort ist ein TraceScope-Objekt.

Der Pfadparameter für diesen Endpunkt hat die folgende Syntax:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  • LOCATION_ID muss auf global festgelegt sein.

Tracebereich ändern

Der Tracebereich mit dem Namen _Default kann nicht geändert werden. Alle anderen Trace-Bereiche können Sie ändern.

Console

So ändern Sie den Bereich eines Traces:

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

    Einstellungenaufrufen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  3. Wählen Sie den Tab Trace Scopes aus.
  4. Suchen Sie den Bereich, den Sie ändern möchten, klicken Sie auf  Mehr und wählen Sie Bereich bearbeiten aus. Füllen Sie dann den Dialog aus.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • TRACE_SCOPE_NAME: Der Name eines Trace-Bereichs. Beispiel: my-trace-scope.
  • DESCRIPTION: Optional. Die Beschreibung des Tracebereichs. Formatiere die Beschreibung als String.
  • RESOURCE_NAMES: Eine durch Kommas getrennte Liste der vollständig qualifizierten Namen von Projekten. Beispiel: projects/my-project.
  • LOCATION: Der Speicherort des Trace-Bereichs. Dieses Feld muss den Wert global haben.
  • PROJECT_ID: Die Kennung des Projekts.

Führen Sie den Befehl gcloud observability trace-scopes update aus:

Linux, macOS oder Cloud Shell

gcloud observability trace-scopes update TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes update TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes update TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

Bei Erfolg werden in den Antwortdaten eines update-Befehls die aktualisierten Trace-Bereiche angezeigt: 

Updated traceScope [my-test-scope].
createTime: '2026-03-26T13:43:54.772326947Z'
description: A scope for testing
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:48:05.262142872Z'

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle. Weitere Informationen finden Sie in der Referenzdokumentation des Anbieters zu Terraform.

Wenn Sie einen Trace-Bereich in einem Projekt mit Terraform ändern möchten, verwenden Sie die Terraform-Ressource google_observability_trace_scope.

REST

Verwenden Sie zum Ändern eines Trace-Bereichs den Befehl projects.locations.traceScopes.patch. Sie müssen einen Pfadparameter und Abfrageparameter angeben und ein TraceScope-Objekt bereitstellen. Die Abfrageparameter geben an, welche Felder geändert wurden. Die Antwort ist ein TraceScope-Objekt.

Der Pfadparameter für diesen Endpunkt hat die folgende Syntax:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  • LOCATION_ID muss auf global festgelegt sein.
  • TRACE_SCOPE_NAME: Der Name eines Trace-Bereichs. Beispiel: my-trace-scope.

Tracebereich löschen

Sie können den Tracebereich mit dem Namen _Default nicht löschen. Sie können alle anderen Trace-Bereiche löschen.

Console

So löschen Sie einen Trace-Bereich:

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

    Einstellungenaufrufen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  3. Wählen Sie den Tab Trace Scopes aus.
  4. Suchen Sie den zu löschenden Bereich, klicken Sie auf das Dreipunkt-Menü  Mehr, wählen Sie Bereich löschen aus und schließen Sie das Dialogfeld ab.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • TRACE_SCOPE_NAME: Der Name eines Trace-Bereichs. Beispiel: my-trace-scope.
  • LOCATION: Der Speicherort des Trace-Bereichs. Dieses Feld muss den Wert global haben.
  • PROJECT_ID: Die Kennung des Projekts.

Führen Sie den Befehl gcloud observability trace-scopes delete aus:

Linux, macOS oder Cloud Shell

gcloud observability trace-scopes delete TRACE_SCOPE_NAME \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME ^
 --location=LOCATION --project=PROJECT_ID

Wenn Sie einen delete-Befehl ausführen, werden Sie aufgefordert, die Aktion zu bestätigen. Im Folgenden finden Sie ein Beispiel für die Ausführung: 

You are about to delete traceScope [my-test-scope]

Do you want to continue (Y/n)?  Y

Deleted traceScope [my-test-scope].

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle. Weitere Informationen finden Sie in der Referenzdokumentation des Anbieters zu Terraform.

Wenn Sie einen Trace-Bereich in einem Projekt mit Terraform löschen möchten, verwenden Sie die Terraform-Ressource google_observability_trace_scope.

REST

Verwenden Sie den Befehl projects.locations.traceScopes.delete, um einen Trace-Bereich zu löschen. Sie müssen einen Pfadparameter angeben.

Der Pfadparameter für diesen Endpunkt hat die folgende Syntax:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  • LOCATION_ID muss auf global festgelegt sein.
  • TRACE_SCOPE_NAME: Der Name eines Trace-Bereichs. Beispiel: my-trace-scope.

Standard-Tracebereich konfigurieren

Wenn die Seite Trace-Explorer geöffnet wird, werden die im Standard-Tracebereich aufgeführten Ansichten nach Tracedaten durchsucht. Wenn dieser Tracebereich nicht zugänglich ist, wird auf der Seite Trace-Explorer_AllSpans-Ansicht Ihres Projekts für das Standard-Dataset abgefragt.

Wenn Projekte erstellt werden, wird der Trace-Bereich mit dem Namen _Default erstellt und als Standard-Trace-Bereich festgelegt. Sie können jedoch einen eigenen Trace-Bereich erstellen und als Standard-Trace-Bereich festlegen.

Console

So legen Sie den Standardbereich für Traces fest:

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

    Einstellungenaufrufen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

  3. Wählen Sie den Tab Trace Scopes aus.

    Auf dem Tab werden Ihre Trace-Bereiche angezeigt. Außerdem ist dort eine Schaltfläche zum Erstellen eines benutzerdefinierten Trace-Bereichs zu sehen. Der Tracebereich, der mit dem Symbol „Standard“  angezeigt wird, ist der aktuelle Standard-Tracebereich.

  4. Wenn Sie den Standardbereich für Traces ändern möchten, suchen Sie den gewünschten Bereich, klicken Sie auf das  Dreipunkt-Menü und wählen Sie Als Standard festlegen aus.

    Der ausgewählte Trace-Bereich wird mit dem Symbol „Standard“  angezeigt.

gcloud

So rufen Sie den Beobachtbarkeitsbereich auf und aktualisieren ihn:

  1. Führen Sie den Befehl gcloud observability scopes describe aus, um die Einstellungen für den Observability-Bereich aufzurufen.

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • OBSERVABILITY_SCOPE_ID: Der Name eines Scope-Objekts. Dieser Wert muss auf _Default festgelegt werden.
    • LOCATION: Das Feld „Standort“ muss auf global festgelegt werden.
    • PROJECT_ID: Die Kennung des Projekts.

    Führen Sie den Befehl gcloud observability scopes describe aus:

    Linux, macOS oder Cloud Shell

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \
   --location=LOCATION\
   --project=PROJECT_ID

    Windows (PowerShell)

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID `
   --location=LOCATION`
   --project=PROJECT_ID

    Windows (cmd.exe)

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^
   --location=LOCATION^
   --project=PROJECT_ID

    Die Antwort auf den Befehl sieht etwa so aus: 

    logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default
traceScope: projects/my-project/locations/global/traceScopes/_Default
name: projects/my-project/locations/global/scopes/_Default

  2. Führen Sie den Befehl gcloud observability scopes update aus, um den Observability-Bereich zu aktualisieren. Im update-Befehl können Sie das Flag --log-scope, das Flag --trace-scope oder beide Flags einfügen.

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • OBSERVABILITY_SCOPE_ID: Der Name eines Scope-Objekts. Dieser Wert muss auf _Default festgelegt werden.
    • LOG_SCOPE_FQN_ID: Der vollständig qualifizierte Ressourcenname des Logbereichs. Dieses Feld hat das folgende Format: 
      logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

      Im vorherigen Ausdruck ist LOG_SCOPE_ID die ID des Log-Bereichs. Beispiel: my-scope.

    • TRACE_SCOPE_FQN_ID: Der vollständig qualifizierte Ressourcenname des Trace-Bereichs. Dieses Feld hat das folgende Format: 
      projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME

      Im vorherigen Ausdruck ist TRACE_SCOPE_NAME der Name des Trace-Bereichs. Beispiel: my-trace-scope.

    • LOCATION: Das Feld „Standort“ muss auf global festgelegt werden.
    • PROJECT_ID: Die Kennung des Projekts.

    Führen Sie den Befehl gcloud observability scopes update aus:

    Linux, macOS oder Cloud Shell

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID \
   --log-scope=LOG_SCOPE_FQN_ID\
   --trace-scope=TRACE_SCOPE_FQN_ID\
   --location=LOCATION\
   --project=PROJECT_ID

    Windows (PowerShell)

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
   --log-scope=LOG_SCOPE_FQN_ID`
   --trace-scope=TRACE_SCOPE_FQN_ID`
   --location=LOCATION`
   --project=PROJECT_ID

    Windows (cmd.exe)

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
   --log-scope=LOG_SCOPE_FQN_ID^
   --trace-scope=TRACE_SCOPE_FQN_ID^
   --location=LOCATION^
   --project=PROJECT_ID

    Wenn der Wert von LOG_SCOPE_ID beispielsweise my-log-scope und der Wert von TRACE_SCOPE_NAME my-trace-scope ist, sieht die Antwort so aus: 

    Updated scope [_Default].
logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-log-scope
traceScope: projects/my-project/locations/global/traceScopes/my-trace-scope
name: projects/my-project/locations/global/scopes/_Default

Terraform

Sie können mit Terraform einen Trace-Bereich erstellen und ändern. Sie können Terraform jedoch nicht verwenden, um den Standard-Tracebereich festzulegen.

REST

Wenn Sie den Standard-Logbereich oder den Standard-Tracebereich mit einem API-Aufruf abrufen und festlegen möchten, konfigurieren Sie den Observability-Bereich. Im Bereich „Observability“ werden der Standardlogbereich und der Standardtracebereich aufgeführt:

  • Wenn Sie den standardmäßigen Observability-Bereich für ein Projekt abrufen möchten, senden Sie eine Anfrage an den Endpunkt projects.locations.scopes.get. Sie müssen einen Pfadparameter angeben. Die Antwort ist ein Scope-Objekt, das den Standardprotokollbereich und den Standard-Trace-Bereich auflistet.

  • Wenn Sie den Standard-Beobachtbarkeitsbereich für ein Projekt aktualisieren möchten, senden Sie eine Anfrage an den Endpunkt projects.locations.scopes.patch. Sie müssen einen Pfadparameter und Abfrageparameter angeben und ein Scope-Objekt bereitstellen. Die Abfrageparameter geben an, welche Felder geändert wurden. Die Antwort ist ein Scope-Objekt.

Der Pfadparameter für beide Endpunkte hat das folgende Format:

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  • LOCATION: Das Feld „Standort“ muss auf global festgelegt werden.
  • OBSERVABILITY_SCOPE_ID: Der Name eines Scope-Objekts. Dieses Feld muss auf _Default gesetzt sein. Im automatisch erstellten Scope-Objekt mit dem Namen _Default werden Informationen zum Standard-Logbereich und zum Standard-Tracebereich gespeichert.

Wenn Sie einen Befehl an einen API-Endpunkt senden möchten, können Sie den APIs Explorer verwenden. Damit können Sie einen Befehl über eine Referenzseite ausgeben. Um beispielsweise den aktuellen Standardbereich abzurufen, können Sie Folgendes tun:

  1. Klicken Sie auf projects.locations.scopes.get.

  2. Geben Sie im Widget Diese Methode ausprobieren Folgendes in das Feld name ein:

    projects/PROJECT_ID/locations/global/scopes/_Default

    Bevor Sie das vorherige Feld kopieren, ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts.

  3. Wählen Sie Ausführen aus.

  4. Führen Sie im Autorisierungsdialogfeld die erforderlichen Schritte aus.

    Das Ergebnis sieht etwa so aus:

    {
"name": "projects/my-project/locations/global/scopes/_Default",
"logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default"
"traceScope": "projects/my-project/locations/global/traceScopes/_Default"
}

Limits für Tracebereiche

Limits für Tracebereiche Wert
Maximale Anzahl von Trace-Bereichen pro Projekt 100
Maximale Anzahl von Ansichten pro Trace-Bereich 20

Nächste Schritte