Traces projektübergreifend aufrufen

In diesem Dokument wird beschrieben, wie Sie alle Spans für einen Trace aus einem einzigen Kontext aufrufen können, wenn diese Spans von Anwendungen generiert werden, die in verschiedenen Google Cloud-Projekten gespeichert sind, die sich in einer Organisation befinden.

Angenommen, Sie haben die Google Cloud-Projekte A und B. Angenommen, eine von Projekt B gehostete Anwendung ruft eine von Projekt A gehostete Anwendung auf. Wenn Sie die Google Cloud Console öffnen und das Projekt A auswählen, können Sie nur Trace-Spans ansehen, die von den Anwendungen generiert wurden, die vom Projekt A gehostet werden. Mit der Standardkonfiguration können Sie die vom Projekt B generierten Trace-Spans nicht ansehen, wenn es einen Aufruf an das Projekt A sendet.

Verwenden Sie die projektübergreifende Funktion von Trace, um die Trace-Spans anzusehen, die von Projekt B generiert werden, wenn es einen Aufruf an Projekt A aus dem Kontext des Projekts A sendet. Mit dieser Funktion können Sie beim Anzeigen von Trace-Daten für das Projekt A auch die Spans anzeigen, die vom Projekt B generiert wurden, wenn es die Aufrufe des Projekts A ausführt.

Projekte, Berechtigungen und Anwendungen konfigurieren

Führe die folgenden Konfigurationsschritte aus:

  1. Ordnen Sie alle Google Cloud-Projekte derselben Organisation zu.

    • Wenn Sie ein neues Projekt im Kontext der Organisation erstellen, wird es automatisch in der Organisationsressource erstellt.

    • Wenn Sie ein Google Cloud-Projekt haben, das nicht zu einer Organisation gehört, können Sie es in Ihre Organisation verschieben. Weitere Informationen finden Sie unter Vorhandene Projekte migrieren.

  2. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihre Projekte oder Ihre Organisation zu gewähren, damit Sie die erforderlichen Berechtigungen zum projektübergreifenden Ansehen von Traces erhalten:

    • Cloud Trace-Nutzer (roles/cloudtrace.user) für jedes Projekt.
    • Logging-Betrachter (roles/logging.viewer) für jedes Projekt.
    • Organisationsbetrachter (roles/resourcemanager.organizationViewer) in der Organisation. Sie haben diese Rolle erhalten, wenn die Projektauswahl eine Liste von Organisationen enthält.

    Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

  3. Konfigurieren Sie Ihre Anwendungen so, dass sie Traces in die Projekte schreiben, in denen sie gehostet werden.

    Damit projektübergreifende Anfragen verfolgt werden, hängen Sie einen Trace-Kontextheader an die Anfrage an.

Trace-Details projektübergreifend ansehen

Nachdem Sie die Konfigurationsschritte abgeschlossen haben, können Sie Traces in Google Cloud-Projekten so ansehen:

  1. Wählen Sie im Navigationsbereich der Google Cloud Console Trace und dann Trace Explorer aus:

    Zum Trace Explorer

    Wählen Sie das Projekt aus, aus dem Sie die Trace-Daten ansehen möchten. Beispielsweise können Sie das Projekt A auswählen.

    Die Seite Trace Explorer wird geöffnet und enthält ein Streudiagramm und eine Tabelle mit den neuesten Traces.

  2. Wenn Sie einen bestimmten Trace untersuchen möchten, wählen Sie ihn im Streudiagramm oder in der Tabelle aus oder geben Sie seine ID in das Feld Trace-ID ein.

    Der Bereich Trace-Details wird geöffnet. Hier werden alle Spans angezeigt, für die Sie die Berechtigung zum Ansehen haben. Dies gilt auch dann, wenn sich diese Spans in verschiedenen Google Cloud-Projekten in derselben Organisation befinden.

Nächste Schritte