Tracebereiche erstellen und verwalten

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

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

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

Tracebereiche

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

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

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

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

Bereich der Beobachtbarkeit

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

App Hub-Anwendungen und Trace-Bereiche

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

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

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  4. Enable the Observability API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  7. Enable the Observability API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

  8. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Observability Scopes Editor (roles/observability.scopesEditor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Aufrufen von Trace-Bereichen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

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

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

    Console

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

    gcloud

    Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

    Terraform

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

    1. Installieren Sie die Google Cloud CLI.

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

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

      gcloud auth application-default login

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

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

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

    REST

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

      Installieren Sie die Google Cloud CLI.

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

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

Tracebereiche auflisten

Console

So listen Sie die Trace-Bereiche auf:

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

    Einstellungenaufrufen

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

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

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

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

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

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

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

gcloud

Nicht unterstützt.

Terraform

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

REST

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

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

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

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

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

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

Tracebereich erstellen

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

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

Console

So erstellen Sie einen Trace-Bereich:

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

    Einstellungenaufrufen

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

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

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

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

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

  6. Klicken Sie auf Trace-Bereich erstellen.

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

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

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

gcloud

Nicht unterstützt.

Terraform

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

So erstellen Sie mit Terraform einen Trace-Bereich in einem Projekt:

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

    • provider: Legen Sie google-beta fest.

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

  2. Nachdem Sie die Datei main.tf aktualisiert haben, führen Sie ein Upgrade Ihrer Terraform-Installation durch:

    terraform -init upgrade

    Das Upgrade ist erforderlich, da die google_observability_trace_scope-Ressource sich in der Betaphase befindet.

REST

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

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

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

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

Trace-Bereich ändern oder löschen

Sie können den Trace-Bereich mit dem Namen _Default nicht löschen oder ändern. Alle anderen Trace-Bereiche können Sie ändern oder löschen.

Console

So ändern oder löschen Sie einen Trace-Bereich:

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

    Einstellungenaufrufen

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

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

  4. Suchen Sie den Bereich des Traces, den Sie ändern oder löschen möchten, klicken Sie auf  Mehr und führen Sie dann einen der folgenden Schritte aus:

    • Wenn Sie den Bereich ändern möchten, wählen Sie Bereich bearbeiten aus und füllen Sie das Dialogfeld aus.
    • Wählen Sie zum Löschen Bereich löschen aus und füllen Sie das Dialogfeld aus.

gcloud

Nicht unterstützt.

Terraform

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

So ändern Sie einen Trace-Bereich in einem Projekt mit Terraform:

  1. Verwenden Sie die Terraform-Ressource google_observability_trace_scope.

  2. Nachdem Sie die Datei main.tf aktualisiert haben, führen Sie ein Upgrade Ihrer Terraform-Installation durch:

    terraform -init upgrade

    Das Upgrade ist erforderlich, da die google_observability_trace_scope-Ressource sich in der Betaphase befindet.

REST

Bereich ändern

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

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

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

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

Bereich löschen

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

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

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

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

Standard-Tracebereich konfigurieren

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

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

Console

So legen Sie den Standardbereich für Traces fest:

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

    Einstellungenaufrufen

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

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

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

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

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

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

gcloud

Nicht unterstützt.

Terraform

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

REST

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

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

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

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

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

Die Felder im vorherigen Ausdruck haben die folgende Bedeutung:

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

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

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

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

    projects/PROJECT_ID/locations/global/scopes/_Default

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

  3. Wählen Sie Ausführen aus.

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

    Das Ergebnis sieht etwa so aus:

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

Limits für Tracebereiche

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

Nächste Schritte