Tracebereiche erstellen und verwalten

In diesem Dokument wird beschrieben, wie Sie einen Trace-Scope erstellen und verwalten. So können Sie auf der Seite Trace Explorer die Trace-Spans finden, die Sie sich ansehen oder analysieren möchten. Wenn Sie nur die Spans aufrufen und analysieren möchten, die in Ihrem Google Cloud-Projekt stammen, müssen Sie keine Trace-Bereiche konfigurieren. Wenn Ihre Trace-Daten jedoch in mehreren Projekten gespeichert sind, was bei einer Microservice-Architektur der Fall sein kann, müssen Sie einige Konfigurationsaktivitäten ausführen, um alle Spans aus einem einzigen 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 analysieren.

Tracebereiche

Tracebereiche sind persistente Ressourcen auf Projektebene, die eine Reihe von Google Cloud-Projekten auflisten. Sie können die Seite Trace Explorer so konfigurieren, dass nach Tracebereich gesucht wird. Das bedeutet, dass auf der Seite in den im ausgewählten Bereich aufgeführten Projekten gesucht wird. Welche Daten aus dem Speicher abgerufen und dann angezeigt werden, hängt von Ihren IAM-Rollen (Identity and Access Management) für die durchsuchten Projekte und der Einstellung für den Zeitraum ab.

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

Sie können Trace-Scopes erstellen und diese auch ändern und löschen. Sie sollten einen Trace-Umfang erstellen, wenn Sie einen Dienst haben, der Spannungsdaten in mehrere Google Cloud-Projekte schreibt.

Sofern Sie die Seite Trace-Explorer nicht mit einer URL öffnen, die einen Trace-Bereich oder eine Trace- und eine Span-ID enthält, wird auf der Seite Trace-Explorer in den im Standard-Trace-Bereich aufgeführten Google Cloud-Projekten nach Trace-Daten gesucht. Beim Erstellen des Projekts wird der Trace-Scope mit dem Namen _Default als Standard-Trace-Scope festgelegt. Sie können jedoch einen anderen Ablaufbereich als Standard-Ablaufbereich auswählen.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Aufrufen von Ablaufumfängen und zum Festlegen des Standard-Ablaufumfangs benötigen:

  • So erstellen und rufen Sie Trace-Scopes auf und rufen Sie den Standard-Trace-Scope ab: Cloud Trace-Nutzer (roles/cloudtrace.user) für Ihr Projekt
  • So legen Sie den Standardumfang der Traces fest: Bearbeiter für die Beobachtbarkeit (roles/observability.editor) 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 Ablaufumfängen und zum Festlegen des Standard-Ablaufumfangs 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 aufzurufen sowie 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.

Tracebereiche auflisten

So listen Sie die Trace-Bereiche auf:

  1. Öffnen Sie in der Google Cloud Console die Seite Einstellungen.

    Einstellungenaufrufen

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

  2. Wählen Sie den Tab Trace Scopes (Ebene der Traces) aus.

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

Tracebereich erstellen

Die auf der Seite Trace-Explorer angezeigten Spans hängen von den gesuchten Projekten, Ihren IAM-Rollen in diesen Projekten, der Einstellung für den Zeitraum und den angewendeten Filtern ab.

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

So erstellen Sie einen Trace-Bereich:

  1. Öffnen Sie in der Google Cloud Console die Seite Einstellungen.

    Einstellungenaufrufen

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

  2. Wählen Sie den Tab Trace Scopes (Trace Scopes erstellen) aus und klicken Sie dann auf Create trace scope (Trace Scope erstellen).

  3. 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 Zeiträume in den Trace-Bereich 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 ermitteln. Weitere Informationen finden Sie im Abschnitt Auf Protokollbereiche umstellen dieses Dokuments.

  4. Geben Sie im Abschnitt Name des Trace-Ebene den Namen und die Beschreibung ein, die auf dem Tab Trace-Ebenen angezeigt werden sollen.

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

  5. Klicken Sie auf Trace-Scope erstellen.

Zu Tracebereichen migrieren

Auf der Seite Trace-Explorer müssen Sie die Google Cloud-Projekte angeben, in denen nach Trace-Daten gesucht werden soll. Das ist eine Änderung gegenüber der 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 keine Spannen angezeigt, die auf den alten Seiten Trace Explorer zu sehen waren.

Im Bereich Trace-Details der alten Seite Trace-Explorer können Sie eine Liste der Google Cloud-Projekte erstellen, in denen Ihre Trace-Daten gespeichert sind:

  1. Rufen Sie die Seite Trace Explorer auf:

    Zum Legacy Trace Explorer

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

  3. Wählen Sie im Bereich Trace-Details den Trace aus und gehen Sie dann zum Tab Projekte.

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

  4. Wenn Sie einen Trace-Bereich mit den aufgeführten Projekten erstellen möchten, wählen Sie auf dem Tab Projekte in der Symbolleiste die Option Bereich mit diesen Projekten erstellen aus und schließen Sie das Dialogfeld ab.

  5. Wiederholen Sie die vorherigen Schritte, bis Sie eine Liste mit Projekten erstellt haben.

Nachdem Sie eine Liste der Projekte erstellt haben, erstellen Sie einen Tracebereich. Sie können ihn auch als Standard-Tracebereich festlegen.

Standard-Tracebereich festlegen

Wenn die Seite Trace-Explorer geöffnet wird, wird in den im Standard-Tracebereich aufgeführten Projekten nach Trace-Daten gesucht. Wenn auf diesen Ablaufbereich nicht zugegriffen werden kann, wird in Ihrem Projekt nach Ablaufdaten gesucht.

Beim Erstellen von Projekten wird der Trace-Scope _Default erstellt und als Standard-Trace-Scope festgelegt. Sie können jedoch Ihren eigenen Trace-Bereich erstellen und als Standard-Trace-Bereich festlegen.

So legen Sie den Standard-Echtzeit-Aufzeichnungsbereich fest:

  1. Öffnen Sie in der Google Cloud Console die Seite Einstellungen.

    Einstellungenaufrufen

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

  2. Wählen Sie den Tab Trace Scopes (Ebene der Traces) aus.

  3. Suchen Sie den Trace-Scope, den Sie als Standard-Trace-Scope festlegen möchten, klicken Sie auf das Dreipunkt-Menü  Mehr und wählen Sie Als Standard festlegen aus.

    Der ausgewählte Trace-Umfang wird durch das Symbol „Standard“  angezeigt.

Trace-Umfang ä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.

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

  1. Öffnen Sie in der Google Cloud Console die Seite Einstellungen.

    Einstellungenaufrufen

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

  2. Wählen Sie den Tab Trace Scopes (Ebene der Traces) aus.

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

    • Wenn Sie ihn ändern möchten, wählen Sie Umfang bearbeiten aus und nehmen Sie die erforderlichen Einstellungen vor.
    • Wenn Sie den Bereich löschen möchten, wählen Sie Bereich löschen aus und schließen Sie das Dialogfeld ab.

Beschränkungen

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

Nächste Schritte