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.

Angenommen, Sie haben die Google Cloud-Projekte A und B und gehen davon aus, dass eine vom Projekt B gehostete Anwendung einen gRPC-Aufruf an eine vom Projekt A gehostete Anwendung sendet. Wenn Sie die Google Cloud Console öffnen und das Projekt A auswählen, können Sie nur Trace-Spans ansehen, die von den vom Projekt A gehosteten Anwendungen generiert wurden. Insbesondere können Sie die vom Projekt B generierten Trace-Spans nicht ansehen, 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. Verknüpfen Sie alle Ihre Google Cloud-Projekte mit derselben Organisation.

    • 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, wird im Dialogfeld Neues Projekt angezeigt:

      Neuer Projektbereich mit Ihrer Organisation.

    • 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. Prüfen Sie, ob Sie für jedes Projekt die Cloud IAM-Rolle (Cloud Identity and Access Management) Cloud Trace-Nutzer und Logging-Betrachter haben.

  3. Außerdem benötigen Sie die Berechtigung resourcemanager.organizations.get für den Lesezugriff auf die Organisation der Projekte. Diese Berechtigung ist Teil der Cloud 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 dann 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