Traces projektübergreifend aufrufen

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

Stellen Sie sich vor, Sie haben die Google Cloud-Projekte A und B und gehen davon aus, dass eine vom Projekt B gehostete Anwendung einen Aufruf an eine Anwendung sendet, die vom Projekt A gehostet wird. 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. In der Standardkonfiguration können Sie die vom Projekt B generierten Trace-Spans nicht ansehen, wenn das Projekt A aufgerufen wird.

Wenn Sie die vom Projekt B generierten Trace-Spans ansehen möchten, wenn das Projekt A aus dem Kontext des Projekts A aufgerufen wird, verwenden Sie die projektübergreifende Funktion von Trace. Wenn Sie sich damit Trace-Daten für das Projekt A ansehen, können Sie auch die Spans aufrufen, die vom Projekt B beim Ausführen der Aufrufe an das Projekt A generiert wurden.

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 Berechtigungen erhalten, die Sie zum projektübergreifenden Aufrufen von Traces benötigen:

    • Cloud Trace-Nutzer (roles/cloudtrace.user) für jedes Projekt.
    • Logging-Betrachter (roles/logging.viewer) für jedes Projekt.
    • Organisationsbetrachter (roles/resourcemanager.organizationViewer) für die 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 Traces in die Projekte geschrieben werden, in denen sie gehostet werden.

    Wenn Sie das Tracing für projektübergreifende Anfragen erzwingen möchten, hängen Sie einen Trace-Kontext-Header an die Anfrage an.

Tracedetails projektübergreifend ansehen

Nachdem Sie die Konfigurationsschritte abgeschlossen haben, gehen Sie so vor, um Traces in Google Cloud-Projekten anzusehen:

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

    Zum Trace Explorer

    Sie können diese Seite auch über die Suchleiste finden.

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

    Die Seite Trace-Explorer wird geöffnet. Hier werden ein Streudiagramm und eine Tabelle mit den neuesten Traces angezeigt.

  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 und zeigt alle Spans an, die Sie aufrufen dürfen, auch wenn sich diese Spans in verschiedenen Google Cloud-Projekten in derselben Organisation befinden.

Nächste Schritte