Über Cloud Trace

Cloud Trace, ein verteiltes Tracing-System für Google Cloud, hilft Ihnen zu verstehen, wie lange es dauert, bis Ihre Anwendung eingehende Anfragen von Nutzern oder anderen Anwendungen verarbeitet, und wie lange es dauert, Vorgänge wie RPC-Aufrufe bei der Verarbeitung der Anfragen auszuführen.

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 Debugging oder Profiling für Ihre Anwendung finden Sie unter Application Performance Management.

Umgebungsunterstützung

Cloud Trace wird unter Linux in den folgenden Umgebungen ausgeführt:

Cloud Trace bietet Clientbibliotheken für die Instrumentierung Ihrer Anwendung zum Erfassen von Trace-Informationen. Eine Anleitung zur Einrichtung pro Sprache finden Sie unter Cloud Trace einrichten.

In der App Engine-Standardumgebung müssen Java 8-, Python 2- und PHP 5-Anwendungen die Cloud Trace-Clientbibliotheken nicht verwenden. Diese Laufzeiten senden automatisch Latenzdaten für Anfragen an Anwendungs-URIs an Cloud Trace. Die Anfragen enthalten Latenzdaten für Umlauf-RPC-Aufrufe an App Engine-Dienste. Cloud Trace kann mit allen Admin APIs von App Engine außer Cloud SQL verwendet werden.

Sprachunterstützung

In der folgenden Tabelle sind die Verfügbarkeit von Trace-Clientbibliotheken und OpenCensus-Bibliotheken zusammengefasst, die einen Stackdriver-Exporter enthalten:

Sprache Clientbibliothek verfügbar OpenCensus-Bibliothek verfügbar
C# ASP.NET Core Ja No
C# ASP.NET Ja No
Go Ja Ja
Java Ja Ja
Node.js Ja Ja
PHP Ja Ja
Python Ja Ja
Ruby Ja No

OpenCensus-Bibliotheken sind einfacher zu verwenden, da sie einen Teil der Komplexität der entsprechenden Cloud Trace-Clientbibliothek verbergen. Wenn Sie OpenCensus verwenden, wählen Sie den Stackdriver-Exporter aus.

Eine allgemeine Anleitung zur Einrichtung finden Sie unter Cloud Trace einrichten.

Komponenten

Cloud Trace besteht aus einem Tracing-Client, der Traces erfasst und an Ihr Google Cloud-Projekt sendet. Anschließend können Sie mit der Google Cloud Console die vom Agent erfassten Daten ansehen und analysieren.

Ein Trace beschreibt die Zeit, die 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 Teilvorgang auszuführen. Ein Trace kann 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 dauert. Weitere Informationen finden Sie im Datenmodell von Cloud Trace.

Tracing-Client

Wenn eine OpenCensus-Bibliothek für Ihre Programmiersprache verfügbar ist, können Sie das Erstellen und Senden von Trace-Daten mit OpenCensus vereinfachen. OpenCensus ist nicht nur nutzerfreundlicher, sondern unterstützt auch die Batchverarbeitung, was die Leistung verbessern kann.

Wenn keine OpenCensus-Bibliothek vorhanden ist, können Sie Ihren Code mithilfe der Trace SDK-Bibliothek und der Cloud Trace API importieren. 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 besteht aus drei Fenstern: Übersicht, Trace-Liste und Analyseberichte.

Wenn Sie Cloud Trace verwenden möchten, wählen Sie im Navigationsbereich der Cloud Console Trace aus oder klicken Sie auf die folgende Schaltfläche:

Zu Trace

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

Überblick

Das Fenster Übersicht enthält 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 das Fenster Trace-Liste geöffnet, das für die Anzeige übereinstimmender Anfragen vorkonfiguriert ist. Mit dem Fenster Trace-Liste können Sie die Latenz als Zeitfunktion anzeigen lassen und jeden einzelnen Trace im Detail 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 den Kosten finden Sie im Abschnitt Preise auf dieser Seite.

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 zum Fenster Übersicht von Cloud Trace finden Sie unter Traces in der Cloud Console ansehen.

Traceliste

Im Fenster Trace-Liste 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. Um Traces für die Untersuchung zu finden, verwenden Sie Filter.

Weitere Informationen zum Filtern und Ansehen von Trace-Details finden Sie unter Traces suchen und ansehen und Trace-Details ansehen.

Analyseberichte

Über das Fenster 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 Analyseberichte erstellen.

Preis

Latenzdaten werden in ein Trace gepackt, das sich aus Spans zusammensetzt. Die Spans werden vom Cloud Trace-Back-End aufgenommen, das die Daten dann in der Cloud Console für die Anzeige in Echtzeit und Berichterstellung verfügbar macht. Wenn Sie Trace-Daten ansehen, werden die gespeicherten Spans im Rahmen des Abrufvorgangs gescannt.

Die Preise für Cloud Trace richten sich nach der Anzahl der aufgenommenen und gescannten Trace-Spans auf monatlicher Basis. Weitere Informationen finden Sie unter Trace-Preise.

Sie können eine Benachrichtigung erstellen, damit Sie informiert werden, wenn die Zahl Ihrer aufgenommenen Spans eine vordefinierte Schwelle überschreitet. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien erstellen.

Kontingent

Cloud Trace erzwingt ein Ratenkontingent für Ihre API-Anfragen und ein Aufnahmekontingent für die Spans, die Sie an Trace gesendet haben. Weitere Informationen finden Sie unter Kontingente und Limits.

So lassen Sie Ihre aktuelle Nutzung anzeigen:

  1. Wählen Sie in der Google Cloud Console APIs & Dienste und dann Cloud Trace API aus oder verwenden Sie die folgende Schaltfläche:

    Trace API aufrufen

  2. Klicken Sie auf Kontingente.

Sie können eine Benachrichtigung erstellen, damit Sie informiert werden, wenn Sie Ihre Kontingente überschritten haben. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien erstellen.

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

  • Weitere Informationen zur Cloud Trace-Konsole finden Sie unter Traces in der Cloud Console ansehen.

  • Wenn Sie Cloud Trace verwenden möchten, rufen Sie in der Cloud Console Trace auf oder klicken Sie auf die folgende Schaltfläche.

    Zu Trace

  • Dann bietet sich der Schnellstart an.