Cloud Trace – Übersicht

Mit Cloud Trace, einem verteilten Tracing-System für Google Cloud, können Sie nachvollziehen, wie lange Ihre Anwendung für die Verarbeitung eingehender Anfragen von Nutzern oder anderen Anwendungen benötigt und wie lange es dauert, bis Vorgänge abgeschlossen sind, wie beispielsweise RPC-Aufrufe, die bei der Verarbeitung der Anfragen ausgeführt werden.

Cloud Trace erfasst Latenzdaten von App Engine, HTTP(S)-Load-Balancern und mit der Cloud Trace-API instrumentierten Anwendungen. So kann es bei der Beantwortung folgender Fragen hilfreich sein:

  • Wie lange braucht meine Anwendung zum Verarbeiten einer bestimmten Anfrage?
  • Warum braucht meine Anwendung so lange zum Verarbeiten einer Anfrage?
  • Warum dauern manche meiner Anfragen länger als andere?
  • Wie hoch ist die Gesamtlatenz für Anfragen an meine Anwendung?
  • Ist die Latenz für meine Anwendung im Lauf der Zeit gestiegen oder gesunken?
  • Was kann ich tun, um die Latenz der Anwendung zu verringern?
  • Welche Abhängigkeiten hat meine Anwendung?

Informationen zum Erstellen von Anwendungsprofilen finden Sie unter Cloud Profiler.

Umgebungsunterstützung

Cloud Trace kann unter Linux in folgenden Umgebungen ausgeführt werden:

Cloud Trace stellt Clientbibliotheken für die Instrumentierung Ihrer Anwendung zur Erfassung von Trace-Informationen bereit. Eine Anleitung zum Einrichten von Cloud Trace finden Sie unter Cloud Trace einrichten.

Konfigurationen mit automatischem Tracing

Einige Konfigurationen führen zu einer automatischen Erfassung von Trace-Daten:

  • App Engine-Standardumgebung

    Java 8-, Python 2- und PHP 5-Anwendungen müssen nicht die Cloud Trace-Clientbibliotheken verwenden. Diese Laufzeiten senden automatisch Latenzdaten für Anfragen an Anwendungs-URIs an Cloud Trace. Die Anfragen umfassen Latenzdaten für Round-Trip-RPC-Aufrufe an App Engine-Dienste. Cloud Trace kann mit allen App Engine Admin APIs verwendet werden, mit Ausnahme von Cloud SQL.

  • Cloud Functions und Cloud Run

    Für eingehende und ausgehende HTTP-Anfragen werden Latenzdaten automatisch erfasst.

Sprachunterstützung

In der folgenden Tabelle finden Sie eine Übersicht über die Verfügbarkeit von Trace-Clientbibliotheken, OpenTelemetry-Bibliotheken, für die es einen Exporter nach Cloud Trace gibt, und von OpenCensus-Bibliotheken, die einen Stackdriver-Exporter enthalten.

Sprache Clientbibliothek
verfügbar		 OpenTelemetry
lib/exporter verfügbar		 OpenCensus
-Bibliothek/-Exporter verfügbar
C# ASP.NET Core Ja Nein Nein
C# ASP.NET Ja Nein Nein
Go Ja Ja Ja
Java Ja Ja Ja
Node.js Ja Ja Ja
PHP Ja Nein Ja
Python Ja Ja Ja
Ruby Ja Ja Nein

OpenTelemetry-Bibliotheken sind einfacher zu verwenden als die Cloud Trace-Clientbibliotheken, da sie einen Teil der Komplexität der entsprechenden Trace API verbergen. Wenn Sie diese Bibliotheken verwenden, instrumentieren Sie Ihre Anwendung so, dass sie den Cloud Trace-Exporter verwendet. Eine allgemeine Anleitung zur Einrichtung finden Sie unter Cloud Trace einrichten.

Wenn Sie Anwendungen schreiben, die in Compute Engine ausgeführt werden, können Sie auch den Ops-Agent und den OTLP-Empfänger (OpenTelemetry Protocol) verwenden, um Traces und Messwerte aus Ihrer Anwendung zu erfassen. Wenn Sie den Ops-Agent verwenden, benötigen Sie keinen Trace-Exporter, um mit der Trace API zu interagieren. Weitere Informationen finden Sie unter Ops-Agent und OTLP verwenden.

Komponenten

Cloud Trace besteht aus einem Tracing-Client, der Traces erfasst und an Ihr Google Cloud-Projekt sendet. Sie können dann die Google Cloud Console verwenden, um die vom Agent erfassten Daten anzusehen und zu analysieren.

Ein trace beschreibt, wie lange eine Anwendung benötigt, um einen einzelnen Vorgang abzuschließen. Jeder Trace besteht aus einem oder mehreren Spans. Ein Span beschreibt, wie lange es dauert, einen vollständigen Untervorgang auszuführen. Ein Trace könnte beispielsweise beschreiben, wie lange es dauert, eine eingehende Anfrage von einem Nutzer zu verarbeiten und eine Antwort zurückzugeben. Ein Span kann beschreiben, wie lange ein bestimmter RPC-Aufruf benötigt. Weitere Informationen finden Sie im Datenmodell von Cloud Trace.

Tracing-Client

Wenn für Ihre Programmiersprache eine OpenTelemetry-Bibliothek verfügbar ist, können Sie das Erstellen und Senden von Trace-Daten mit OpenTelemetry vereinfachen. OpenTelemetry ist nicht nur einfacher zu verwenden, sondern implementiert auch Batchverarbeitung, wodurch sich möglicherweise die Leistung verbessern lässt.

Wenn keine OpenTelemetry-Bibliothek vorhanden ist, instrumentieren Sie Ihren Code, indem Sie die Trace SDK-Bibliothek importieren und die Cloud Trace API verwenden. Die Cloud Trace API erfasst Trace-Daten und sendet sie an Ihr Google Cloud-Projekt.

Tracingschnittstelle

Nachdem der Agent Trace-Daten erfasst hat, können Sie diese Daten nahezu in Echtzeit in der Cloud Trace-Oberfläche ansehen und analysieren. Die Benutzeroberfläche umfasst drei Seiten: Übersicht, Trace Explorer und Analyseberichte.

Geben Sie in der Suchleiste der Google Cloud Console Trace-Übersicht ein. Rufen Sie in den Suchergebnissen den Abschnitt Produkte und Seiten auf und wählen Sie die Seite Übersicht für Trace aus:

Zur Trace-Übersicht

In der Trace-Konsole werden nur Daten angezeigt, wenn Sie Zugriff auf ein Google Cloud-Projekt haben, das Trace-Daten empfängt.

Übersicht

Auf der Seite Übersicht finden sich zusammenfassende Informationen zu Ihrer Anwendung:

Cloud Trace-Übersichtsseite

Im Bereich Statistiken wird gegebenenfalls eine Liste der Leistungsdaten für Ihre Anwendung angezeigt. In diesem Bereich finden Sie Hinweise auf häufige Probleme mit Anwendungen, z. B. aufeinanderfolgende Aufrufe einer Funktion, die im Batch möglicherweise effizienter verarbeitet werden könnten.

Im Bereich Aktuelle Traces werden die neuesten Traces angezeigt. Für jedes Trace werden die Latenz, der URI und die Zeit angezeigt. Mit dieser Zusammenfassung können Sie die aktuelle Aktivität in Ihrer Anwendung nachvollziehen.

Unter Häufigste URIs und Häufigste RPCs werden die häufigsten URIs (und RPCs) vom Vortag mit der durchschnittlichen Latenz aufgelistet. Wenn Sie in einer dieser Tabellen auf einen Link klicken, wird die Seite Trace Explorer geöffnet, die für die Anzeige übereinstimmender Anfragen vorkonfiguriert ist. Auf der Seite Trace Explorer können Sie sich die Latenzdaten als Funktion der Zeit ansehen und die Details eines Trace untersuchen.

Im Bereich Gebührenpflichtige Trace-Spans werden die Anzahl der im aktuellen Kalendermonat aufgenommenen Spans und die Gesamtsumme für den vorherigen Monat angezeigt. Anhand dieser Informationen können Sie Ihre Kosten für die Verwendung von Cloud Trace überwachen. Weitere Informationen zu Kosten finden Sie auf der Seite Preise.

Im Bereich Tägliche Analyseberichte werden die Latenzdaten für den Vortag angezeigt und mit den Latenzdaten der letzten sieben Tage verglichen. Anhand dieser Daten können Sie feststellen, ob sich Ihr Latenzverhalten mit der Zeit ändert. Sie können das Format der Berichte auf dieser Seite nicht ändern. Sie können jedoch benutzerdefinierte Analyseberichte erstellen.

Weitere Informationen zur Seite Cloud Trace – Übersicht finden Sie unter Traces – Übersicht ansehen.

Trace Explorer

Auf der Seite Trace Explorer können Sie einzelne Traces im Detail untersuchen. Standardmäßig zeigt diese Ansicht eine Darstellung der Latenz für alle Traces und listet in einer Tabelle die aktuellsten Traces auf.

Wenn Sie ein bestimmtes Trace zur Untersuchung auswählen, werden zwei neue Bereiche geöffnet: ein Bereich, in dem alle Spans im Trace angezeigt werden, und ein Informationsbereich mit Details zum ausgewählten Span. Standardmäßig ist der Haupt-Span ausgewählt und die Details enthalten zusammenfassende Informationen zur Anfrage. Verwenden Sie Filter, um Traces für die Prüfung zu finden.

Weitere Informationen zum Filtern und Aufrufen von Tracedetails finden Sie unter Traces suchen und untersuchen.

Analyseberichte

Über die Seite Analyseberichte können Sie benutzerdefinierte Berichte erstellen. Diese Berichte können sich auf alle Traces beziehen oder mithilfe von Filtern nur auf eine Teilmenge der Traces. Sie können auch Berichte erstellen, in denen zwei verschiedene Sätze von Latenzdaten verglichen werden. Weitere Informationen finden Sie unter Berichte erstellen und ansehen.

Datensicherheit

Cloud Trace ist ein von VPC Service Controls unterstützter Dienst. Weitere Informationen dazu finden Sie in der Dokumentation zu VPC Service Controls.

Nächste Schritte