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

Tracebereiche erstellen und verwalten

Sie können Trace-Bereiche erstellen und verwalten, mit denen die Seite Trace Explorer Tracedaten finden kann, wenn sie in mehreren Projekten gespeichert sind. 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.

Informationen zum Ansehen von Traces und Spans finden Sie unter Traces finden und ansehen.

Tracebereiche

Mit Tracebereichen können Sie eine aggregierte Ansicht von Tracedaten erstellen, die in mehreren Projekten gespeichert sind. Diese Bereiche sind persistente Ressourcen auf Projektebene, in denen Ansichten aufgeführt sind. Jede Ansicht bietet Zugriff auf die Trace-Daten, die von einem Projekt gespeichert werden. Auf Seiten wie dem Trace-Explorer wird mit Tracebereichen 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 zu ermitteln, ob Sie die Berechtigung haben, die gefundenen Daten zu sehen.

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 Bucket für die Beobachtbarkeit, das Dataset, in dem die Daten gespeichert werden, und eine Ansicht des Datasets. Über die Ansicht _AllSpans haben Sie Zugriff auf alle Trace-Daten, die im Projekt gespeichert sind.

Auf der Seite Trace-Explorer können Sie einen Tracebereich auswählen. Wenn Sie eine Auswahl treffen, wird auf der Seite in den im Trace-Bereich aufgeführten Ansichten gesucht 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 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 Standardlogbereich und den Standardtrace-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 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 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

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

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.

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

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

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

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 Trace-Daten 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 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 gesetzt 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 Zeiträume 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:

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

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.

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 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 vom System nicht dem Bereich hinzugefügt. 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 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 gesetzt sein.

Tracebereich ändern

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

Console

So ändern Sie den Bereich eines Traces:

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 aus.
Suchen Sie den zu ändernden Trace-Bereich, klicken Sie auf Mehr, wählen Sie Bereich bearbeiten aus und 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 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 gesetzt 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 Scopes aus.
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

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 gesetzt 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 der Standardbereich nicht zugänglich ist, wird auf der Seite in Ihrem Projekt nach Tracedaten gesucht. Diese Suche entspricht der Abfrage der Ansicht _AllSpans Ihres Projekts im Standard-Dataset.

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:

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 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 von Ihnen 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 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

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-Tracebereich mit einem API-Aufruf abrufen und festlegen möchten, konfigurieren Sie den Observability-Bereich. Im Bereich der 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 Standardbereich für die Beobachtbarkeit 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 „Standort“ muss auf global festgelegt werden.
OBSERVABILITY_SCOPE_ID: Der Name eines Scope-Objekts. Dieses Feld muss auf _Default gesetzt sein. Das Objekt Scope mit dem Namen _Default, das automatisch erstellt wird, speichert Informationen zum Standard-Logbereich und zum Standard-Tracebereich.

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 Trace-Bereichen pro Projekt	100
Maximale Anzahl von Ansichten pro Trace-Bereich	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