Beobachtbarkeitsbereiche für Abfragen für mehrere Projekte konfigurieren

In diesem Dokument wird beschrieben, wie Sie Diagramme erstellen oder Logdaten ansehen können, wenn diese Daten in mehreren Projekten gespeichert sind. Standardmäßig sind nur die Daten, die aus einem Projekt stammen, für die Visualisierungstools verfügbar. Wenn Sie jedoch einen Bereich konfigurieren, können Visualisierungs- und Analysetools Daten abfragen, die in mehreren Projekten gespeichert sind.

Wenn Sie nur Daten überwachen oder ansehen möchten, die in einemGoogle Cloud -Projekt gespeichert sind, müssen Sie keine Konfiguration vornehmen.

Bereiche bieten eine Aggregation zur Lesezeit

Mit Bereichen können Visualisierungs- und Analysetools Daten, die an mehreren Orten gespeichert sind, zur Lesezeit aggregieren. Bereiche steuern nicht, wo Daten gespeichert werden. Stattdessen verwenden Abfrage-Engines Bereiche, um zu bestimmen, wo nach Daten gesucht werden soll.

Messwert- und Trace-Daten werden immer im Google Cloud -Projekt gespeichert, aus dem die Daten stammen. Wenn Sie Messwertdaten, die in mehreren Projekten gespeichert sind, in einem einzigen Diagramm ansehen möchten, konfigurieren Sie einen Messwertbereich, in dem diese Projekte aufgeführt sind. Wenn Sie diesen Bereich konfiguriert haben und ein Diagramm oder eine Benachrichtigungsrichtlinie erstellen, gibt die von diesen Diensten ausgegebene Abfrage automatisch Messwertdaten aus den aufgeführten Projekten zurück. Das Verhalten ist bei Trace-Daten ähnlich.

Standardmäßig werden Logdaten in dem Projekt, Rechnungskonto, Ordner oder der Organisation in Google Cloud gespeichert, aus dem die Daten stammen. Sie können Logging jedoch so konfigurieren, dass Logdaten von der Ressource, von der sie stammen, an einen anderen Speicherort weitergeleitet werden, z. B. an ein anderes Projekt oder einen zentralen Log-Bucket. Konfigurieren Sie in allen Fällen einen benutzerdefinierten Logbereich. Wir empfehlen, dass Ihr Logbereich Logansichten anstelle von Projekten auflistet. Eine Logansicht bietet Lesezugriff auf eine Teilmenge von Logeinträgen in einem Log-Bucket. Wenn Sie beispielsweise Logdaten in drei Projekten gespeichert haben, können Sie die Logansicht so konfigurieren, dass die Ansicht _Default/_AllLogs für jedes dieser Projekte enthalten ist.

Verwendung von Bereichen durch Google Cloud Observability

Die Analyse- und Visualisierungstools von Google Cloud Observability verwenden datentypspezifische Bereiche, um zu bestimmen, welche Ressourcen nach den Daten abgefragt werden sollen, die das Tool anzeigen oder analysieren soll.

Beispiele:

  • Wenn die Seite Log-Explorer geöffnet wird, fragt das System die im Standard-Logbereich aufgeführten Ressourcen nach Logdaten ab. Nachdem diese Seite geöffnet wurde, können Sie eine Symbolleistenoption verwenden, um die Ressourcen in einem anderen Bereich abzufragen.
  • Wenn die Seite Trace-Explorer geöffnet wird, fragt das System die im Standard-Tracebereich aufgeführten Projekte nach Tracedaten ab. Nachdem diese Seite geöffnet wurde, können Sie mit einer Symbolleistenoption die Ressourcen in einem anderen Bereich abfragen.
  • Wenn Sie eine Benachrichtigungsrichtlinie erstellen, fragt Monitoring die im Messwertbereich aufgeführten Projekte nach Messwertdaten ab. Anschließend wird die Abfrageantwort analysiert und entschieden, ob eine Benachrichtigung erstellt werden soll.
  • Wenn Sie ein Diagramm auf der Seite Metrics Explorer erstellen, geben Sie einen Messwert an, der im Diagramm dargestellt werden soll. Monitoring fragt die im Messwertbereich aufgeführten Projekte nach Messwertdaten ab und zeigt dann die Abfrageergebnisse an.

Logging und Trace prüfen Ihre IAM-Rollen (Identity and Access Management) für eine Ressource, bevor eine Abfrage Daten zurückgibt. Wenn in einem Logbereich beispielsweise ein Projekt angegeben ist, für das Sie keine Berechtigungen zum Lesen von Logdaten haben, werden bei einer Abfrage dieses Projekts keine Daten zurückgegeben.

Monitoring prüft Ihre IAM-Rolle für das Projekt, von dem die Abfrage ausgegeben wird. Angenommen, der Messwertbereich für ein Projekt mit dem Namen AllEnv enthält die folgenden Projekte: AllEnv, Prod und Staging. Außerdem wird davon ausgegangen, dass Ihnen die Rolle „Monitoring Viewer“ für das Projekt AllEnv zugewiesen wurde. In Diagrammen, die Sie mit der Seite Metrics Explorer erstellen, wenn Sie das Projekt AllEnv verwenden, werden automatisch Messwertdaten für die drei Projekte angezeigt.

Google Cloud Observability-Bereiche

In diesem Abschnitt werden die von Google Cloud Observability verwendeten Bereiche beschrieben.

Bereich für Beobachtbarkeit

Der Beobachtbarkeitsbereich gibt den Standard-Logbereich und den Standard-Tracebereich an. Auf Seiten wie dem Log-Explorer und dem Trace-Explorer wird anhand der Standardbereiche festgelegt, welche Ressourcen beim Öffnen der Seite abgefragt werden sollen. Angenommen, Sie haben eine Anwendung, die Trace-Daten in drei Projekten generiert. Sie können die Seite Trace Explorer so konfigurieren, dass diese drei Projekte automatisch abgefragt werden, indem Sie den Standard-Trace-Bereich festlegen.

Wenn Sie den Beobachtbarkeitsbereich nicht konfigurieren, geschieht Folgendes:

  • Auf der Seite Log-Explorer werden Logdaten für Ihr Projekt abgefragt.
  • Auf der Seite Trace-Explorer werden Tracedaten für Ihr Projekt abgefragt.

Der Beobachtbarkeitsbereich gilt nicht für Messwertdaten.

Wann der Beobachtbarkeitsbereich konfiguriert werden sollte

Konfigurieren Sie den Beobachtbarkeitsbereich in den folgenden Szenarien:

  • Sie erstellen einen benutzerdefinierten Logbereich und möchten, dass die in diesem Bereich aufgeführten Ressourcen standardmäßig abgefragt werden.

  • Sie erstellen einen benutzerdefinierten Trace-Bereich und möchten, dass die in diesem Bereich aufgeführten Projekte standardmäßig abgefragt werden.

Limits im Zusammenhang mit Bereichen für Beobachtbarkeit

Beschreibung Maximalwert
Anzahl der Beobachtbarkeitsbereiche pro Projekt 1

Logbereiche

Logbereiche werden auf der Seite Log-Explorer und in Dashboards verwendet, in denen Logdaten angezeigt werden:

  • Wenn die Seite Log-Explorer geöffnet wird, fragt das System automatisch die im Standard-Logbereich aufgeführten Ressourcen nach Logdaten ab. Auf dieser Seite finden Sie auch Steuerelemente, mit denen Sie zwischen Bereichen wechseln können.

  • Bei Dashboards bestimmt die Implementierung, ob das System das Projekt oder die Ressourcen abfragt, die im Standard-Logbereich aufgeführt sind.

Ein Logbereich kann Logansichten, Projekte, Ordner und Organisationen enthalten.

Wenn Sie keinen benutzerdefinierten Logbereich konfigurieren, werden auf der Seite Log-Explorer Logdaten aus Ihrem Projekt abgefragt.

Wann benutzerdefinierte Logbereiche erstellt werden sollten

Erstellen Sie benutzerdefinierte Logbereiche für die folgenden Konfigurationen:

Konfigurieren Sie in allen Fällen Ihre benutzerdefinierten Logbereiche so, dass eine oder mehrere Logansichten aufgeführt werden. Diese Logansichten können sich in einem zentralen Log-Bucket oder in verschiedenen Log-Buckets befinden. Wenn Sie einen zentralisierten Log-Bucket verwenden, können Sie mehrere benutzerdefinierte Logbereiche erstellen, die jeweils eigene Logansichten haben.

Wenn Sie benutzerdefinierte Logbereiche erstellen, sollten Sie den Standard-Logbereich aktualisieren.

Best Practices für die Konfiguration von Logbereichen

  • Nur Logansichten einschließen.
  • Konfigurieren Sie keinen Bereich, der sowohl Projekte als auch Logansichten enthält.

Limits für Logbereiche

Beschreibung Maximalwert
Anzahl der Logbereiche pro Projekt 100
Anzahl der Projekte pro Logbereich 5
Anzahl der Logansichten oder Projekte pro Logbereich 100

Weitere Informationen finden Sie unter Logbereiche erstellen und verwalten.

Messwertbereich

Der Messwertbereich wird von allen Abfragen verwendet, die von Cloud Monitoring ausgegeben werden. Beispielsweise senden Benachrichtigungsrichtlinien und Diagrammtools wie der Metrics Explorer Abfragen an die Projekte, die im Messwertbereich aufgeführt sind.

Wenn Sie den Messwertbereich nicht konfigurieren, fragen Monitoring-Dienste Ihr Projekt nach Messwertdaten ab.

Wann die Messwertbereiche konfiguriert werden sollten

Konfigurieren Sie den Messwertbereich, wenn eine der folgenden Bedingungen zutrifft:

  • Sie möchten Daten in Diagrammen darstellen, die in verschiedenen Projekten gespeichert sind.
  • Sie möchten eine Benachrichtigungsrichtlinie, um Daten zu überwachen, die in verschiedenen Projekten gespeichert sind.
  • Sie registrieren Anwendungen mit App Hub. Informationen zu diesem Szenario finden Sie unter App Hub-Anwendungen und Messwertbereiche.

Limits für Messwertbereiche

Beschreibung Maximalwert
Anzahl der Messwertbereiche pro Projekt 1
Anzahl der Projekte pro Messwertbereich 375

Weitere Informationen finden Sie unter Messwertbereiche – Übersicht.

Bereiche verfolgen

Auf der Seite Trace Explorer werden Trace-Bereiche verwendet. Wenn diese Seite geöffnet wird, fragt das System automatisch die im Standard-Trace-Bereich aufgeführten Ansichten nach Trace-Daten ab. Diese Seite bietet auch Steuerelemente, mit denen Sie zwischen Bereichen wechseln können.

Wenn Sie keinen benutzerdefinierten Trace-Bereich konfigurieren, fragt die Seite Trace-Explorer die Ansicht _AllSpans des Projekts im Standard-Dataset für Ihre Trace-Daten ab.

In einem Tracebereich werden Ansichten und keine Google Cloud Projekte aufgeführt. Obwohl Sie beim Konfigurieren eines Trace-Bereichs Projekte auswählen, fügt das System dem Bereich die Standard-Trace-Ansicht dieser Projekte hinzu. Die Standard-Trace-Ansicht 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 Trace-Daten gespeichert.

Wann benutzerdefinierte Trace-Bereiche erstellt werden sollten

Erstellen Sie benutzerdefinierte Trace-Bereiche, wenn Sie Anwendungen haben, die auf Ressourcen in verschiedenen Google Cloud -Projekten angewiesen sind.

Best Practices für die Konfiguration von Trace-Bereichen

Limits für Trace-Bereiche

Beschreibung Maximalwert
Anzahl der Trace-Bereiche pro Projekt 100
Anzahl der Ansichten pro Trace-Bereich 20

Weitere Informationen finden Sie unter Trace-Bereiche erstellen und verwalten.

Beobachtbarkeitsbereich konfigurieren

Dieser Abschnitt gilt nicht für Ordner oder Organisationen.

Bei Log- und Trace-Daten wirken sich Ihre IAM-Rollen (Identity and Access Management) für das Projekt, das Sie sich ansehen, sowie für alle durchsuchten Projekte und Logansichten darauf aus, welche Daten von der Abfrage zurückgegeben werden. Wenn Sie eine Abfrage zum Aufrufen von Logdaten senden, für die Sie keine Berechtigung haben, werden keine Logdaten zurückgegeben.

Wenn der Messwertbereich eines Projekts konfiguriert ist, erhält das Projekt Lesezugriff auf die Messwertdaten, die von den Projekten in seinem Messwertbereich gespeichert werden. Wenn einem Nutzer eine IAM-Rolle (Identity and Access Management) zugewiesen wird, mit der er Messwertdaten in einem Projekt aufrufen kann, kann er die für das Projekt verfügbaren Messwertdaten aufrufen.

Zum Konfigurieren des Beobachtbarkeitsbereichs legen Sie den Standardlogbereich und den Standard-Tracebereich fest. Im weiteren Verlauf dieses Abschnitts wird beschrieben, wie Sie diese Aktionen ausführen.

Hinweis

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

Projekt und Rollen konfigurieren

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

    Roles required to select or create a project

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

    Go to project selector

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

  3. Enable the Observability API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  4. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Aufrufen von Bereichen benötigen:

    • So erstellen und rufen Sie Logbereiche auf und rufen den Standard-Logbereich ab: Logs Configuration Writer (roles/logging.configWriter) für Ihr Projekt
    • Zum Ändern eines Messwertbereichs: Monitoring-Administrator (roles/monitoring.admin) für Ihr Projekt und für jedes Projekt, das Sie dem Messwertbereich hinzufügen möchten
    • Zum Erstellen und Aufrufen von Trace-Bereichen sowie zum Abrufen und Festlegen von Standardbereichen: Observability Scopes Editor (roles/observability.scopesEditor) für Ihr Projekt

    Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen und Aufrufen von 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 Bereichen erforderlich:

    • logging.logScopes.{create, delete, get, list, update}
    • monitoring.metricsscopes.{link, get, list}
    • observability.traceScopes.{create, delete, get, list, update}
    • observability.scopes.{get, update}

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

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

Console

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

gcloud

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

gcloud init

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.

Standardbereich ansehen und festlegen

Console

Wenn Sie den Beobachtbarkeitsbereich konfigurieren möchten, müssen Sie seine Komponenten konfigurieren. Das sind der Standard-Logbereich, der Messwertbereich und der Standard-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. Konfigurieren Sie den Standard-Logbereich:

    1. Wählen Sie den Tab Logbereiche aus.

      Vorhandene Logbereiche werden aufgelistet. Der Eintrag mit dem Symbol „Standard“ () ist der Standard-Logbereich. Wenn Sie einen Logbereich erstellen möchten, klicken Sie auf Logbereich erstellen und füllen Sie das Dialogfeld aus. Weitere Informationen finden Sie unter Logbereiche erstellen und verwalten.

    2. Suchen Sie den Eintrag, den Sie als Standard festlegen möchten, klicken Sie auf  Mehr und wählen Sie dann Als Standard festlegen aus.

  4. Konfigurieren Sie den Messwertbereich:

    1. Wählen Sie den Tab Messwertbereich aus.
    2. Klicken Sie im Bereich Google Cloud-Projekte auf Projekte hinzufügen und füllen Sie das Dialogfeld aus. Weitere Informationen finden Sie unter Messwertbereiche konfigurieren.

  5. Konfigurieren Sie den Standard-Trace-Bereich:

    1. Wählen Sie den Tab Trace-Bereiche aus und gehen Sie so vor:

      Vorhandene Trace-Bereiche werden aufgelistet. Der Eintrag mit dem Symbol „Standard“ () ist der Standard-Trace-Bereich. Wenn Sie einen Trace-Bereich erstellen möchten, klicken Sie auf Logbereich erstellen und füllen Sie das Dialogfeld aus. Weitere Informationen finden Sie unter Trace-Bereiche erstellen und verwalten.

    2. Suchen Sie den Eintrag, den Sie als Standard festlegen möchten, klicken Sie auf  Mehr und wählen Sie dann Als Standard festlegen aus.

gcloud

So rufen Sie den Beobachtbarkeitsbereich auf und aktualisieren ihn:

  1. Führen Sie den Befehl gcloud observability scopes describe aus, um die Einstellungen für den Beobachtbarkeitsbereich aufzurufen.

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • OBSERVABILITY_SCOPE_ID: Der Name eines Scope-Objekts. Dieser Wert muss auf _Default festgelegt werden.
    • LOCATION: Das Feld „Standort“ muss auf global festgelegt sein.
    • PROJECT_ID: Die Kennung des Projekts.

    Führen Sie den Befehl gcloud observability scopes describe aus:

    Linux, macOS oder Cloud Shell

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \
   --location=LOCATION\
   --project=PROJECT_ID

    Windows (PowerShell)

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID `
   --location=LOCATION`
   --project=PROJECT_ID

    Windows (cmd.exe)

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^
   --location=LOCATION^
   --project=PROJECT_ID

    Die Antwort auf den Befehl sieht in etwa so aus: 

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

  2. Führen Sie den Befehl gcloud observability scopes update aus, um den Beobachtbarkeitsbereich zu aktualisieren. Im Befehl update können Sie das Flag --log-scope, das Flag --trace-scope oder beide Flags angeben.

    Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • OBSERVABILITY_SCOPE_ID: Der Name eines Scope-Objekts. Dieser Wert muss auf _Default festgelegt werden.
    • LOG_SCOPE_FQN_ID: Der vollständig qualifizierte Ressourcenname des Logbereichs. Dieses Feld hat das folgende Format: 
      logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

      Im vorherigen Ausdruck ist LOG_SCOPE_ID die ID des Logbereichs. Beispiel: my-scope.

    • TRACE_SCOPE_FQN_ID: Der vollständig qualifizierte Ressourcenname des Trace-Bereichs. Dieses Feld hat das folgende Format: 
      projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME

      Im vorherigen Ausdruck ist TRACE_SCOPE_NAME der Name des Trace-Bereichs. Beispiel: my-trace-scope.

    • LOCATION: Das Feld „Standort“ muss auf global festgelegt sein.
    • PROJECT_ID: Die Kennung des Projekts.

    Führen Sie den Befehl gcloud observability scopes update aus:

    Linux, macOS oder Cloud Shell

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID \
   --log-scope=LOG_SCOPE_FQN_ID\
   --trace-scope=TRACE_SCOPE_FQN_ID\
   --location=LOCATION\
   --project=PROJECT_ID

    Windows (PowerShell)

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
   --log-scope=LOG_SCOPE_FQN_ID`
   --trace-scope=TRACE_SCOPE_FQN_ID`
   --location=LOCATION`
   --project=PROJECT_ID

    Windows (cmd.exe)

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
   --log-scope=LOG_SCOPE_FQN_ID^
   --trace-scope=TRACE_SCOPE_FQN_ID^
   --location=LOCATION^
   --project=PROJECT_ID

    Wenn der Wert von LOG_SCOPE_ID beispielsweise my-log-scope und der Wert von TRACE_SCOPE_NAME my-trace-scope ist, sieht die Antwort in etwa so aus: 

    Updated scope [_Default].
logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-log-scope
traceScope: projects/my-project/locations/global/traceScopes/my-trace-scope
name: projects/my-project/locations/global/scopes/_Default

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 Standardtracebereich aufgeführt:

  • Wenn Sie den Standard-Beobachtbarkeitsbereich für ein Projekt abrufen möchten, senden Sie eine Anfrage an den Endpunkt projects.locations.scopes.get. Sie müssen einen Pfadparameter angeben. Die Antwort ist ein Scope-Objekt, in dem der Standard-Logbereich und der Standard-Trace-Bereich aufgeführt sind.
  • Wenn Sie den 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 Suchparameter angeben und ein Scope-Objekt bereitstellen. Die Abfrageparameter 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 sein.
  • OBSERVABILITY_SCOPE_ID: Der Name eines Scope-Objekts. Dieses Feld muss auf _Default festgelegt werden. Das automatisch erstellte Scope-Objekt mit dem Namen _Default speichert Informationen zum Standard-Logbereich und zum Standard-Trace-Bereich.

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

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

    Ersetzen Sie vor dem Kopieren des vorherigen Felds PROJECT_ID durch den Namen Ihres Projekts.

  3. Wählen Sie Ausführen aus.
  4. Führen Sie im Autorisierungsdialogfeld die erforderlichen Schritte aus.

    Das Ergebnis sieht etwa so aus:

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

Weitere Informationen zu Bereichen

Weitere Informationen zu Bereichen finden Sie in den folgenden Dokumenten: