Traces projektübergreifend ansehen

Cloud Trace unterstützt die Möglichkeit, Trace-Spans anzuzeigen, die von einer Anwendung generiert wurden, die sich in einem anderen Google Cloud-Projekt befindet. Dabei filtert Trace automatisch alle Spans heraus, die Sie nicht einsehen dürfen.

Stellen Sie sich vor, Sie haben die Google Cloud-Projekte A und B und gehen davon aus, dass eine von dem Projekt B gehostete Anwendung einen gRPC-Aufruf an eine von Projekt A gehostete Anwendung ausführt. Wenn Sie die Google Cloud Console öffnen und das Projekt A auswählen, können Sie nur Trace-Spans anzeigen lassen, die von den Anwendungen generiert wurden, die vom Projekt A gehostet werden. Insbesondere können Sie die von Projekt B generierten Trace-Spans nicht sehen, wenn ein gRPC-Aufruf an das Projekt A erfolgt.

Wenn Sie jedoch die projektübergreifende Funktion von Trace nutzen, können Sie über die Google Cloud Console von Projekt A die Spans aufrufen, die von der Anwendung generierten werden, welche von Projekt A gehostet wird, sowie die Spans, die von der von Projekt B gehosteten Anwendung erstellt werden, wenn es gRPC-Aufrufe in Projekt A vornimmt.

Diese Seite enthält Details zum Einrichten von Cloud Trace, damit Sie Trace-Spans zu verwandten Google Cloud-Projekten in einer Ansicht ansehen können.

Einstieg

So zeigen Sie Trace-Spans in Google Cloud-Projekten an:

  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.

      Die Organisation, in der Sie Ihr Projekt erstellen, können Sie im Dialogfeld Neues Projekt sehen:

      Neuer Projektbereich mit Ihrer Organisation.

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

  2. Sie benötigen die Rolle Cloud Trace-Nutzer der Identitäts- und Zugriffverwaltung (IAM) und die IAM-Rolle Logging-Betrachter für jedes Projekt.

  3. Außerdem benötigen Sie die Berechtigung resourcemanager.organizations.get für den Lesezugriff auf die Organisation der Projekte. Diese Berechtigung ist Bestandteil der IAM-Rolle Organisationsbetrachter.

    Wenn Sie testen möchten, ob Sie diese Berechtigung haben, öffnen Sie die Projektauswahl oben in der Cloud Console und prüfen Sie, ob ein Drop-down-Menü mit Organisationen angezeigt wird:

    Cloud Trace-Organisationsansicht.

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

    • Hängen Sie einen Trace-Kontext-Header an, damit das Tracing für projektübergreifende Anfragen erzwungen wird.
    • Informationen zu den sprachspezifischen Einrichtungsanleitungen finden Sie unter Cloud Trace einrichten.

Trace-Details projektübergreifend ansehen

Nachdem Sie die Schritte im Abschnitt "Erste Schritte" abgeschlossen haben, gehen Sie so vor:

  1. Wählen Sie in der Cloud Console Trace und anschließend Trace-Liste aus oder klicken Sie auf die folgende Schaltfläche:

    Zur Trace-Liste

    Sie müssen eines der Projekte auswählen, die Sie für die projektübergreifende Trace-Ansicht konfiguriert haben. Im vorherigen Beispiel würden Sie entweder Projekt A oder B auswählen.

    Es kann einige Minuten dauern, bis Traces angezeigt werden, wenn Sie Trace zum ersten Mal verwenden. Weitere Informationen finden Sie unter Traces suchen und ansehen. Der folgende Screenshot zeigt eine Beispielseite für die Trace-Liste:

    Seite Cloud Trace-Liste.

    Die Trace-Ergebnisliste und das Streudiagramm beziehen sich nur auf das aktuell ausgewählte Projekt und nicht auf andere Projekte im Trace.

  2. Rufen Sie die Details zu einem Trace ab. Klicken Sie dazu in der Trace-Liste auf einen beliebigen Anfrage-URI. Die Trace-Details werden unter dem Diagramm angezeigt:

    Bereich Cloud Trace-Details.

    Trace-Spans aus allen Projekten, die mit dem Trace verknüpft sind, werden in den Trace-Details angezeigt. Die Details sind nicht auf die Trace-Spans für das aktuell ausgewählte Projekt beschränkt.

  3. Klicken Sie in der Zeitachse auf einen blauen Balken, der einen Trace-Span darstellt, um den Bereich Details anzusehen. Hier wird angezeigt, welches Projektlabel mit dem Trace-Span verknüpft ist. Außerdem können Sie sich die zugehörigen Details ansehen.

Nächste Schritte