Tracebereiche erstellen und verwalten

Mit Trace-Bereichen können Sie Cloud Trace-Daten über mehrere Projekte hinweg auf der Seite Trace-Explorer suchen und analysieren. Wenn Sie nur Spans ansehen und analysieren möchten, die aus einem einzelnen Google Cloud Projekt stammen, müssen Sie keine Trace-Bereiche konfigurieren. Informationen zum Aufrufen von Traces und Spans finden Sie unter Traces suchen und untersuchen.

Informationen zu Tracebereichen

Mit Tracebereichen können Sie eine aggregierte Ansicht von Tracedaten erhalten, die in mehreren Projekten gespeichert sind. Diese Bereiche sind persistente Ressourcen auf Projektebene, die Ansichten auflisten. Jede Ansicht bietet Zugriff auf die von einem Projekt gespeicherten Trace-Daten. Auf Seiten wie dem Trace-Explorer wird mithilfe von Trace-Bereichen festgelegt, wo nach Daten gesucht werden soll. Auf diesen Seiten werden jedoch auch Ihre IAM-Rollen (Identity and Access Management) für diese Ressourcen verwendet, um festzustellen, ob Sie die Berechtigung haben, die gefundenen Daten zu sehen.

Wenn Sie einen Trace-Bereich erstellen, geben Sie einen Namen und eine Liste von Projekten an. Das System enthält automatisch die Standard-Trace-Ansicht jedes Projekts mit dem Pfad _Trace/Spans/_AllSpans. Die Pfadfelder _Trace, Spans und _AllSpans beziehen sich auf einen Beobachtbarkeits-Bucket, das Dataset, in dem die Daten gespeichert sind, und eine Ansicht des Datasets. Die Ansicht _AllSpans bietet Zugriff auf alle Tracedaten, die im Projekt gespeichert sind.

Die Seite Trace-Explorer enthält eine Option, mit der Sie einen Trace-Bereich auswählen können. Wenn Sie eine Auswahl treffen, werden die im Trace-Bereich aufgeführten Ansichten durchsucht und die Anzeige wird aktualisiert.

Sie können die konfigurierte Ansicht auch freigeben, indem Sie die Browser-URL kopieren. Die URL codiert den ausgewählten Trace-Bereich und andere Seiteneinstellungen und überschreibt die Standardbereichsauswahl für alle, die den Link öffnen. Weitere Informationen finden Sie unter Traces und Spans freigeben.

Sie können einen Trace-Bereich als „Standard“ festlegen. Wenn Sie diese Kennzeichnung vornehmen, geschieht Folgendes:

  • Das System aktualisiert den Beobachtbarkeitsbereich. Dieser Bereich enthält Verweise auf den Standard-Logbereich und den Standard-Trace-Bereich. So kann das System Log- und Trace-Daten korrelieren, wenn diese Daten in mehreren Projekten gespeichert sind. Weitere Informationen finden Sie unter Beobachtbarkeitsbereiche für projektübergreifende Abfragen konfigurieren.

  • Das System aktualisiert, welchen Trace-Bereich die Seite Trace-Explorer automatisch für die Suche nach Tracedaten verwendet. Wenn die Seite nicht auf den Standard-Tracebereich zugreifen kann, wird Ihr Projekt nach Tracedaten durchsucht.

Sie können alle von Ihnen erstellten Trace-Bereiche ändern und löschen.

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 Trace-Bereich, konfigurieren Sie ihn so, dass die Standard-Trace-Ansicht aller Projekte aufgelistet wird, in denen Trace-Daten gespeichert sind, und konfigurieren Sie ihn dann als Standard-Trace-Bereich. Wenn Sie diese Schritte ausgeführt haben, 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, aus dem Sie Ihre Trace-Daten aufrufen. Dieses Projekt ist Ihr App Hub-Hostprojekt oder -Verwaltungsprojekt. Wenn der Anzeigename eines Ordners beispielsweise My Folder lautet, ist der Anzeigename des Verwaltungsprojekts des Ordners My Folder-mp.

Hinweis

Konfigurieren Sie Ihr Projekt und Ihre IAM-Rollen und wählen Sie die Schnittstelle aus, die Sie verwenden möchten.

Projekt und Rollen konfigurieren

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

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

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

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

    Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen und Aufrufen von Trace-Bereichen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

    Erforderliche Berechtigungen

    Die folgenden Berechtigungen sind zum Erstellen und Aufrufen von Trace-Bereichen erforderlich:

    • observability.traceScopes.{create, delete, get, list, update}
    • observability.scopes.{get, update}

    Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Wählen Sie die Oberfläche aus, die Sie verwenden möchten.

Console

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

gcloud

Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit dem folgenden Befehl:

gcloud init

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. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

    Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Erstellen Sie lokale Authentifizierungsdaten für Ihr Nutzerkonto:

    gcloud auth application-default login

    Wenn ein Authentifizierungsfehler zurückgegeben wird, 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 und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.

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-Bereiche 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 Tracebereich maximieren, wird die Liste der Ansichten angezeigt, die im Bereich enthalten sind. 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 beziehen sich auf den Beobachtbarkeits-Bucket, das Dataset und die Ansicht für Ihre Trace-Daten. Die Ansicht _AllSpans 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 Standort 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. Im Folgenden wird beispielsweise das Ergebnis des Befehls list für ein Projekt mit zwei Trace-Bereichen dargestellt:

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 Terraform verwenden, um einen Trace-Bereich zu erstellen und zu ändern. Sie können Terraform jedoch nicht verwenden, um Trace-Bereiche 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.

Verwenden Sie den Befehl projects.locations.traceScopes.get, um Informationen zu einem bestimmten Trace-Bereich abzurufen.

Tracebereich erstellen

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

Sie können 100 Trace-Bereiche pro Projekt erstellen. Ein Tracebereich kann insgesamt 200 Ansichten enthalten. Wenn Sie einen Trace-Bereich mit mehr als 10 Ansichten erstellen, kann es zu Leistungsproblemen kommen.

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-Bereiche aus und klicken Sie dann auf Trace-Bereich erstellen.
  4. Klicken Sie auf Projekte hinzufügen und füllen Sie das Dialogfeld aus.

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

    Der Name eines Trace-Bereichs 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-Bereiche minimiert aufgeführt. In der Tabelle sind für jeden Bereich ein Name, eine Beschreibung, ein Typ und die Anzahl der Ressourcen aufgeführt.

    Wenn Sie einen Tracebereich maximieren, wird die Liste der Ansichten angezeigt, die im Bereich enthalten sind. 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 beziehen sich auf den Beobachtbarkeits-Bucket, das Dataset und die Ansicht für Ihre Trace-Daten. Die Ansicht _AllSpans 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. Formatieren Sie die Beschreibung als String.
  • RESOURCE_NAMES: Eine durch Kommas getrennte Liste der vollständig qualifizierten Namen von Projekten. Beispiel: projects/my-project.
  • LOCATION: Der Standort 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

Wenn der Vorgang erfolgreich war, enthält die Antwort des Befehls create 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 für Terraform-Anbieter.

Wenn Sie mit Terraform einen Trace-Bereich in einem Projekt erstellen möchten, verwenden Sie 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: Wird auf eine Bereichs-ID festgelegt. 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: „Bereich für Produktionsressourcen“.

REST

Verwenden Sie den Befehl projects.locations.traceScopes.create, um einen Trace-Bereich zu erstellen. 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

Sie können den Trace-Bereich mit dem Namen _Default nicht ändern. Sie können alle anderen Trace-Bereiche ändern.

Console

So ändern 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-Bereiche aus.
  4. Suchen Sie den Trace-Bereich, den Sie ändern möchten, klicken Sie auf  Mehr, wählen Sie Bereich bearbeiten aus und füllen Sie das Dialogfeld 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. Formatieren Sie die Beschreibung als String.
  • RESOURCE_NAMES: Eine durch Kommas getrennte Liste der vollständig qualifizierten Namen von Projekten. Beispiel: projects/my-project.
  • LOCATION: Der Standort 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

Wenn der Vorgang erfolgreich ist, wird in den Antwortdaten eines update-Befehls der aktualisierte Trace-Bereich 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 für Terraform-Anbieter.

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 den Befehl projects.locations.traceScopes.patch, um einen Trace-Bereich zu ändern. Sie müssen einen Pfadparameter und Suchparameter angeben und ein TraceScope-Objekt bereitstellen. Die Abfrageparameter geben an, welche Felder geändert werden. 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 Trace-Bereich 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-Bereiche aus.
  4. Suchen Sie den Trace-Bereich, den Sie löschen möchten, klicken Sie auf  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 Standort 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 eine 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 für Terraform-Anbieter.

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 zum Löschen eines Trace-Bereichs den Befehl projects.locations.traceScopes.delete. 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-Trace-Bereich konfigurieren

Wenn die Seite Trace-Explorer geöffnet wird, werden die im Standard-Tracebereich aufgeführten Ansichten nach Tracedaten durchsucht. Wenn der Standardbereich nicht zugänglich ist, wird auf der Seite nach Tracedaten in Ihrem Projekt gesucht. Diese Suche entspricht der Abfrage der Ansicht _AllSpans Ihres Projekts im Standard-Dataset.

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

Console

So legen Sie den Standard-Tracebereich 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-Bereiche aus.

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

  4. Wenn Sie den Standard-Trace-Bereich ändern möchten, suchen Sie den Trace-Bereich, den Sie als Standard-Trace-Bereich festlegen möchten, klicken Sie auf das zugehörige  Dreipunkt-Menü und wählen Sie dann 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 Beobachtbarkeitsbereich 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 „location“ muss auf global gesetzt sein.
    • 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 in 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 Beobachtbarkeitsbereich zu aktualisieren. Im Befehl update können Sie das Flag --log-scope, das Flag --trace-scope oder beide Flags angeben.

    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 Logbereichs. 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 „location“ muss auf global gesetzt sein.
    • 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 in etwa 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 Terraform verwenden, um einen Trace-Bereich zu erstellen und zu ändern. Sie können Terraform jedoch nicht verwenden, um den Standard-Trace-Bereich festzulegen.

REST

Wenn Sie den Standard-Logbereich oder den Standard-Trace-Bereich mithilfe eines API-Aufrufs abrufen und festlegen möchten, konfigurieren Sie den Beobachtbarkeitsbereich. Im Beobachtbarkeitsbereich werden der Standardlogbereich und der Standard-Trace-Bereich aufgeführt:

  • Wenn Sie den Standard-Beobachtbarkeitsbereich 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, in dem der Standard-Logbereich und der Standard-Trace-Bereich aufgeführt sind.
  • Wenn Sie den Standardbeobachtbarkeitsbereich für ein Projekt aktualisieren möchten, senden Sie eine Anfrage an den Endpunkt projects.locations.scopes.patch. Sie müssen einen Pfadparameter und Suchparameter angeben und ein Scope-Objekt bereitstellen. Die Suchparameter geben an, welche Felder geändert werden. 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 „location“ muss auf global gesetzt sein.
  • OBSERVABILITY_SCOPE_ID: Der Name eines Scope-Objekts. Dieses Feld muss auf _Default festgelegt werden. Das automatisch erstellte Scope-Objekt mit dem Namen _Default speichert Informationen zum Standard-Logbereich und zum Standard-Trace-Bereich.

Wenn Sie einen Befehl an einen API-Endpunkt senden möchten, können Sie den APIs Explorer verwenden, mit dem Sie einen Befehl von einer Referenzseite aus senden können. So rufen Sie beispielsweise den aktuellen Standardbereich ab:

  1. Klicken Sie auf projects.locations.scopes.get.
  2. Geben Sie im Widget Diese Methode ausprobieren im Feld name Folgendes ein:
        projects/PROJECT_ID/locations/global/scopes/_Default
        

    Ersetzen Sie vor dem Kopieren des vorherigen Felds 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 200

Begrenzen Sie die Anzahl der Ansichten in einem Trace-Bereich auf 10, um eine optimale Leistung zu erzielen.

Nächste Schritte