Tracebereiche erstellen und verwalten

In diesem Dokument wird beschrieben, wie Sie einen Trace-Bereich erstellen und verwalten. Damit kann auf der Seite Trace Explorer nach den Trace-Spans gesucht 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 Tracedaten jedoch in mehreren Projekten gespeichert sind, wie es bei einer Microservices-Architektur 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. Weitere Informationen zu diesem Thema finden Sie unter Traces suchen 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 des für Apps aktivierten Ordners aus.

Tracebereiche

Tracebereiche sind persistente Ressourcen auf Projektebene, in denen eine Gruppe von Google Cloud Projekten aufgeführt ist. Sie können die Seite Trace-Explorer so konfigurieren, dass nach Trace-Bereich gesucht wird. Das bedeutet, dass auf der Seite in den Projekten gesucht wird, die im ausgewählten Bereich aufgeführt sind. Ihre IAM-Rollen (Identity and Access Management) für die durchsuchten Projekte und die Einstellung für den Zeitraum bestimmen, welche Daten aus dem Speicher abgerufen und dann angezeigt werden.

Wenn Sie ein Google Cloud -Projekt erstellen, wird ein Trace-Bereich mit dem Namen _Default erstellt. Dieser Bereich umfasst nur das Projekt Google Cloud . Sie können diesem Bereich keine Projekte hinzufügen und ihn auch nicht löschen.

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

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 denGoogle Cloud Projekten, die im Standard-Tracebereich aufgeführt sind, 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 Tracing-Bereich als Standard-Tracing-Bereich auswählen.

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 alle Projekte aufgeführt werden, in denen Ihre Tracedaten gespeichert sind, 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 Logdaten ansehen. Dieses Projekt ist entweder Ihr App Hub-Hostprojekt oder das Verwaltungsprojekt Ihres für Anwendungen aktivierten Ordners. Wenn der Anzeigename des Ordners beispielsweise My Folder ist, lautet der Anzeigename des Verwaltungsprojekts My Folder-mp.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Trace User (roles/cloudtrace.user) 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. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Trace-Bereiche zu erstellen und anzusehen:

  • So erstellen und verwalten Sie Tracebereiche: cloudtrace.traceScopes.{create, delete, get, list, update}

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

Zum Festlegen des Standardbereichs für Traces sind zusätzliche Berechtigungen erforderlich. Diese Berechtigungen werden im Abschnitt Standardmäßigen Trace-Bereich konfigurieren dieses Dokuments beschrieben.

Trace-Bereiche 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 des für Apps aktivierten Ordners aus.

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

    In der Tabelle werden Ihre Trace-Bereiche aufgeführt. Wenn Sie ein Google Cloud Projekt ausgewählt haben, wird ein Eintrag mit dem Symbol „Standard“  angezeigt. Das bedeutet, dass es sich um den Standard-Trace-Bereich handelt. Auf der Seite Trace-Explorer wird beim Öffnen der Seite in den Projekten, die im Standard-Tracebereich aufgeführt sind, nach Tracedaten gesucht.

Tracebereich erstellen

Die Spans, die auf der Seite Trace-Explorer angezeigt werden, hängen von den durchsuchten Projekten, Ihren IAM-Rollen für diese Projekte, 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 Projekte 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 des für Apps aktivierten Ordners 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.

    Wenn Sie ein Projekt hinzufügen, werden die in diesem Projekt gespeicherten Spans in den Tracebereich aufgenommen. Wenn Sie nicht wissen, welche Projekte in einen Bereich aufgenommen werden sollen, können Sie die alte Seite Trace Explorer verwenden, um sie zu identifizieren. Weitere Informationen finden Sie im Abschnitt Zu Trace-Bereichen migrieren in diesem Dokument.

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

  6. Klicken Sie auf Trace-Bereich erstellen.

Zu Tracebereichen migrieren

Auf der Seite Trace-Explorer müssen Sie dieGoogle Cloud Projekte angeben, in denen nach Tracedaten gesucht werden soll. Das ist eine Verhaltensänderung im Vergleich zur alten Seite Trace-Explorer. Auf der alten Seite Trace-Explorer wird in allen Projekten einer Organisation gesucht. Aufgrund dieser Unterschiede werden auf der Seite Trace Explorer möglicherweise nicht alle Spans angezeigt, die auf den alten Trace Explorer-Seiten zu sehen sind.

Mithilfe des Bereichs Trace-Details auf der alten Seite Trace-Explorer können Sie eine Liste derGoogle Cloud -Projekte erstellen, in denen Ihre Tracedaten gespeichert sind:

  1. Rufen Sie die alte Seite Trace Explorer auf:

    Zum Legacy Trace Explorer

  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 des für Apps aktivierten Ordners aus.

  3. Wählen Sie einen Trace aus.

    Sie können Folgendes versuchen:

    • Sie können einen Trace aufrufen, indem Sie seine ID in das Feld Trace-ID eingeben.
    • Filter hinzufügen

  4. Wählen Sie im Bereich Trace-Details den Trace aus und rufen Sie dann den Tab Projekte auf.

    Auf diesem Tab werden die Projekte aufgeführt, in denen Spans für den Trace gespeichert sind.

  5. Wenn Sie einen Trace-Bereich erstellen möchten, der die aufgeführten Projekte enthält, wählen Sie auf der Symbolleiste des Tab Projekte die Option Bereich mit diesen Projekten erstellen aus und füllen Sie das Dialogfeld aus.

  6. Wiederholen Sie die vorherigen Schritte, bis Sie eine Liste mit Projekten zusammengestellt haben.

Nachdem Sie eine Liste von Projekten zusammengestellt haben, erstellen Sie einen Tracebereich. Sie können ihn auch als Standard-Tracebereich festlegen.

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 des für Apps aktivierten Ordners 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.

Standard-Tracebereich konfigurieren

Wenn die Seite Trace-Explorer geöffnet wird, wird in den Projekten, die im Standard-Tracebereich aufgeführt sind, nach Tracedaten gesucht. Wenn dieser Ablaufbereich nicht zugänglich ist, wird in Ihrem Projekt nach Ablaufdaten gesucht.

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.

Hinweise

  1. Enable the Observability API.

    Enable the API

    Prüfen Sie vor dem Aktivieren der API, ob das richtige Projekt ausgewählt ist. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.

  2. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Aufrufen von Trace-Bereichen und zum Festlegen des Standard-Trace-Bereichs benötigen:

    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 Trace-Bereichen und zum Festlegen des Standard-Trace-Bereichs erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

    Erforderliche Berechtigungen

    Die folgenden Berechtigungen sind erforderlich, um Trace-Bereiche zu erstellen und anzusehen und den Standard-Trace-Bereich festzulegen:

    • So erstellen und verwalten Sie Tracebereiche: cloudtrace.traceScopes.{create, delete, get, list, update}
    • So legen Sie den Standard-Tracebereich fest: observability.scopes.{get, update}

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

Standardbereich 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 des für Apps aktivierten Ordners 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.

  4. Suchen Sie den Bereich, den Sie als Standardbereich festlegen möchten, klicken Sie auf das Dreipunkt-Menü  Mehr und wählen Sie dann Als Standard festlegen aus.

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

Beschränkungen

Die Cloud Trace API oder das Google Cloud CLI unterstützen das Erstellen oder Verwalten von Trace-Bereichen nicht.

Limits für Tracebereiche

Limits für Tracebereiche Wert
Maximale Anzahl von Trace-Bereichen pro Projekt 100
Maximale Anzahl an Projekten pro Tracebereich 20

Nächste Schritte