Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Tracebereiche erstellen und verwalten

Mit Trace-Bereichen können Sie Cloud Trace-Daten in mehreren Projekten über die Seite Trace-Explorer suchen und analysieren. Wenn Sie nur Spans ansehen und analysieren möchten, die in einem einzelnen Google Cloud Projekt erstellt wurden, müssen Sie keine Trace-Bereiche konfigurieren. Informationen zum Ansehen von Traces und Spans finden Sie unter Traces finden und untersuchen.

Tracebereiche

Mit Tracebereichen können Sie eine aggregierte Ansicht von Tracedaten erstellen, die in mehreren Projekten gespeichert sind. Diese Bereiche sind dauerhafte Ressourcen auf Projektebene, in denen Ansichten aufgeführt sind. Jede Ansicht bietet Zugriff auf die von einem Projekt gespeicherten Tracedaten. Auf Seiten wie dem Trace-Explorer wird mit Trace-Bereichen festgelegt, wo nach Daten gesucht werden soll. Auf diesen Seiten wird jedoch auch anhand Ihrer IAM-Rollen (Identity and Access Management) für diese Ressourcen ermittelt, ob Sie die gefundenen Daten sehen dürfen.

Wenn Sie einen Tracebereich 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 verweisen auf einen Beobachtungs-Bucket, das Dataset, in dem die Daten gespeichert werden, und eine Ansicht des Datasets. Die Ansicht _AllSpans bietet Zugriff auf alle Tracedaten, die im Projekt gespeichert sind.

Auf der Seite Trace-Explorer können Sie einen Tracebereich auswählen. Wenn Sie eine Auswahl treffen, werden auf der Seite die Ansichten durchsucht, die im Trace-Bereich aufgeführt sind, und die Anzeige wird aktualisiert.

Sie können die konfigurierte Ansicht auch freigeben, indem Sie die Browser-URL kopieren. In der URL werden der ausgewählte Trace-Bereich und andere Seiteneinstellungen codiert. Dadurch werden die Standardbereichsauswahlen für alle Nutzer überschrieben, die den Link öffnen. Weitere Informationen finden Sie unter Traces und Spans teilen.

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

Das System aktualisiert den Beobachtbarkeitsbereich. Dieser Bereich enthält Verweise auf den Standardlogbereich und den Standardtrace-Bereich. So kann das System Log- und Tracedaten korrelieren, wenn diese Daten in mehreren Projekten gespeichert sind. Weitere Informationen finden Sie unter Beobachtbarkeitsbereiche für Abfragen mit mehreren Projekten konfigurieren.
Das System aktualisiert den Tracebereich, den die Seite Trace-Explorer automatisch zum Suchen nach Tracedaten verwendet. Wenn die Seite nicht auf den Standard-Tracebereich zugreifen kann, wird in Ihrem Projekt nach Tracedaten gesucht.

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 Tracebereich, konfigurieren Sie ihn so, dass die Standard-Traceansicht aller Projekte aufgeführt wird, in denen Tracedaten gespeichert sind, und konfigurieren Sie ihn dann als Standard-Tracebereich. 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

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

Projekt und Rollen konfigurieren

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.

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.

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

Enable the API

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 erforderlich, um Trace-Bereiche zu erstellen und anzusehen:
- 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 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.

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

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.
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.
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 Standardbereich für die Analyse.

Wenn Sie die Details eines Trace-Bereichs aufrufen möchten, maximieren Sie ihn.

Wenn Sie einen Tracebereich 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 Tracedaten angibt. Die Felder _Trace, Spans und _AllSpans beziehen sich auf den Beobachtungs-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 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 die 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.

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.

Pro Projekt können Sie 100 Tracebereiche erstellen. Ein Tracebereich kann insgesamt 20 Ansichten enthalten.

Console

So erstellen Sie einen Trace-Bereich:

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.
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.
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).
Klicken Sie auf Projekte hinzufügen und füllen Sie das Dialogfeld aus.

Hinweis :Wenn Sie ein Projekt auswählen, wird dem Bereich die Standard-Traceansicht des Projekts hinzugefügt.
Geben Sie im Abschnitt Name trace scope (Name des Trace-Bereichs) 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.

Klicken Sie auf Trace-Bereich erstellen.

In der Tabelle Trace-Bereiche werden Ihre Trace-Bereiche standardmäßig in minimierter Form aufgeführt. Für jeden Bereich sind in der Tabelle ein Name, eine Beschreibung, ein Typ und eine Anzahl von Ressourcen aufgeführt.

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 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 zum Terraform-Anbieter.

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.

Hinweis :Das Projekt wird nicht in den Umfang aufgenommen. Stattdessen wird die _AllSpans-Ansicht des Projekts dem Spans-Dataset hinzugefügt.
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 voll 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 Pfad-Parameter 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 einen Trace-Bereich:

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.
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.
Wählen Sie den Tab Trace-Bereiche aus.
Suchen Sie den zu ändernden Bereich für den Trace, klicken Sie auf Mehr und wählen Sie Bereich bearbeiten aus. Füllen Sie dann 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. 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

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

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.
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.
Wählen Sie den Tab Trace-Bereiche aus.
Suchen Sie den zu löschenden Bereich und 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 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 sehen 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

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-Tracebereich konfigurieren

Wenn die Seite Trace-Explorer geöffnet wird, werden die Ansichten, die im Standard-Tracebereich aufgeführt sind, nach Tracedaten durchsucht. Wenn auf den Standardbereich nicht zugegriffen werden kann, wird auf der Seite in Ihrem Projekt nach Tracedaten gesucht. Diese Suche entspricht der Abfrage der _AllSpans-Ansicht Ihres Projekts im Standard-Dataset.

Beim Erstellen von Projekten wird der Tracebereich mit dem Namen _Default erstellt und als Standard-Tracebereich festgelegt. Sie können jedoch einen eigenen Trace-Umfang erstellen und als Standard-Trace-Umfang festlegen.

Console

So legen Sie den Standard-Tracebereich fest:

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.
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.
Wählen Sie den Tab Trace-Bereiche aus.

Auf dem Tab werden Ihre Trace-Bereiche angezeigt. Außerdem ist dort eine Schaltfläche zum Erstellen eines benutzerdefinierten Trace-Bereichs vorhanden. Der Tracebereich, der mit dem Symbol „Standard“ angezeigt wird, ist der aktuelle Standard-Tracebereich.
Wenn Sie den Standardbereich für Traces ändern möchten, suchen Sie den Bereich für Traces, den Sie als Standard festlegen möchten, klicken Sie auf das 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:

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 gesetzt 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 ähnelt der folgenden:

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

Führen Sie den Befehl gcloud observability scopes update aus, um den Observability-Bereich zu aktualisieren. Im Befehl update 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 gesetzt 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-Trace-Bereich mit einem API-Aufruf abrufen und festlegen möchten, konfigurieren Sie den Observability-Bereich. Im Bereich „Beobachtbarkeit“ 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 Standard-Logbereich und den Standard-Tracebereich 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. Das Scope-Objekt mit dem Namen _Default, das automatisch erstellt wird, enthält Informationen zum Standard-Log-Bereich und zum Standard-Trace-Bereich.

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:

Klicken Sie auf projects.locations.scopes.get.
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.
Wählen Sie Ausführen aus.

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 Tracebereichen pro Projekt	100
Maximale Anzahl von Ansichten pro Tracebereich	20

Nächste Schritte

Traces suchen und ansehen
Cloud Logging und Cloud Monitoring enthalten ähnliche Konstrukte, mit denen Sie die Logdaten oder Messwertdaten steuern können, die Sie aufrufen oder überwachen können. Informationen zu diesen Bereichen finden Sie in den folgenden Dokumenten:

Tracebereiche erstellen und verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Tracebereiche

App Hub-Anwendungen und Trace-Bereiche

Hinweis

Projekt und Rollen konfigurieren

Erforderliche Berechtigungen

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

Console

gcloud

Terraform

REST

Tracebereiche auflisten

Console

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Terraform

REST

Tracebereich erstellen

Console

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Terraform

REST

Tracebereich ändern

Console

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Terraform

REST

Tracebereich löschen

Console

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Terraform

REST

Standard-Tracebereich konfigurieren

Console

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Terraform

REST

Limits für Tracebereiche

Nächste Schritte

Tracebereiche erstellen und verwalten