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
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
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.enablepermission. 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.-
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 initTerraform
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.
-
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.
-
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:
-
Rufen Sie in der Google Cloud -Console die Seite settings Einstellungen auf:
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 Standard-Trace-Bereich.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/_AllSpansaufgeführt, der den Standardspeicherort für Ihre Trace-Daten angibt. Die Felder_Trace,Spansund_AllSpansbeziehen sich auf den Beobachtbarkeits-Bucket, das Dataset und die Ansicht für Ihre Trace-Daten. Die Ansicht_AllSpansentspricht jedem Eintrag im Bucket:Name Beschreibung Typ Ressourcen arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace view
gcloud
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- LOCATION: Der Standort des Trace-Bereichs. Dieses Feld muss den Wert
globalhaben. - 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
globalfestgelegt 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:
-
Rufen Sie in der Google Cloud -Console die Seite settings Einstellungen auf:
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 und klicken Sie dann auf Trace-Bereich erstellen.
Klicken Sie auf Projekte hinzufügen und füllen Sie das Dialogfeld aus.
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.
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/_AllSpansaufgeführt, der den Standardspeicherort für Ihre Trace-Daten angibt. Die Felder_Trace,Spansund_AllSpansbeziehen sich auf den Beobachtbarkeits-Bucket, das Dataset und die Ansicht für Ihre Trace-Daten. Die Ansicht_AllSpansentspricht jedem Eintrag im Bucket:Name Beschreibung Typ Ressourcen arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace 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
globalhaben. - 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
globalfestgelegt 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:
-
Rufen Sie in der Google Cloud -Console die Seite settings Einstellungen auf:
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 Trace-Bereich, den Sie ändern möchten, klicken Sie auf more_vert 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
globalhaben. - 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
globalfestgelegt 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:
-
Rufen Sie in der Google Cloud -Console die Seite settings Einstellungen auf:
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 Trace-Bereich, den Sie löschen möchten, klicken Sie auf more_vert 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
globalhaben. - 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
globalfestgelegt 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:
-
Rufen Sie in der Google Cloud -Console die Seite settings Einstellungen auf:
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 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.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 more_vert 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 describeaus, 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_Defaultfestgelegt werden. - LOCATION: Das Feld „location“ muss auf
globalgesetzt sein. - PROJECT_ID: Die Kennung des Projekts.
Führen Sie den Befehl
gcloud observability scopes describeaus: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
- OBSERVABILITY_SCOPE_ID: Der Name eines
Führen Sie den Befehl
gcloud observability scopes updateaus, um den Beobachtbarkeitsbereich zu aktualisieren. Im Befehlupdatekönnen Sie das Flag--log-scope, das Flag--trace-scopeoder 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_Defaultfestgelegt 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
globalgesetzt sein. - PROJECT_ID: Die Kennung des Projekts.
Führen Sie den Befehl
gcloud observability scopes updateaus: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-scopeund der Wert von TRACE_SCOPE_NAMEmy-trace-scopeist, 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
- OBSERVABILITY_SCOPE_ID: Der Name eines
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 einScope-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 einScope-Objekt bereitstellen. Die Suchparameter geben an, welche Felder geändert werden. Die Antwort ist einScope-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
globalgesetzt sein. - OBSERVABILITY_SCOPE_ID: Der Name eines
Scope-Objekts. Dieses Feld muss auf_Defaultfestgelegt werden. Das automatisch erstellteScope-Objekt mit dem Namen_Defaultspeichert 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:
- Klicken Sie auf
projects.locations.scopes.get. - Geben Sie im Widget Diese Methode ausprobieren im Feld name Folgendes ein:
projects/PROJECT_ID/locations/global/scopes/_DefaultErsetzen Sie vor dem Kopieren des vorherigen Felds 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 | 200 |
Begrenzen Sie die Anzahl der Ansichten in einem Trace-Bereich auf 10, um eine optimale Leistung zu erzielen.
Nächste Schritte
Cloud Logging und Cloud Monitoring enthalten ähnliche Konstrukte, mit denen Sie die Log- oder Messwertdaten steuern können, die Sie aufrufen oder überwachen können. Informationen zu diesen Bereichen finden Sie in den folgenden Dokumenten: