Berichte erstellen und abrufen

Analyseberichte in Cloud Trace bieten eine Gesamtansicht der Latenz für alle Anfragen oder für einen Teil der Anfragen an Ihre Anwendung.

Tägliche Berichte

Trace erstellt automatisch einen Tagesbericht, der die Leistung des Vortags mit der Leistung am gleichen Tag der Vorwoche für die obersten drei Endpunkte vergleicht.

Weitere Informationen zum Aufrufen des täglichen Analyseberichts finden Sie unter Bericht aufrufen.

Benutzerdefinierte Analyseberichte

Der tägliche Analysebericht wird automatisch erstellt. Sie können den Inhalt des Berichts nicht auswählen. Sie können jedoch einen benutzerdefinierten Analysebericht erstellen und auswählen, welche Traces in diesem Bericht enthalten sein sollen.

Benutzerdefinierte Berichte enthalten Folgendes:

  • Ein Histogramm der Latenzdaten.
  • Eine Tabelle mit der Latenz nach Perzentil und Links zu Beispiel-Traces.
  • (Optional) Latenzdaten aus einem anderen Zeitraum, den Sie für den Vergleich verwenden.
  • Ein Engpass-Bereich, in dem die RPC-Aufrufe aufgelistet werden, die wesentlich zur Latenz beitragen.

Um einen neuen Bericht zu erstellen, können Sie Ihre Berichtsparameter manuell eingeben oder einen vorhandenen Bericht duplizieren und die Parameter bearbeiten. Beide Ansätze werden in folgenden Abschnitten beschrieben.

Neuen Bericht erstellen

So erstellen Sie einen neuen Analysebericht:

  1. Geben Sie in der Suchleiste der Google Cloud Console Analyseberichte ein. Gehen Sie in den Suchergebnissen zum Abschnitt Produkte und Seiten und wählen Sie die Seite Analyseberichte für Trace aus:

    Gehen Sie zu Analyseberichte

  2. Klicken Sie auf Neuer Bericht.

  3. Geben Sie im angezeigten Formular die folgenden Parameter ein oder wählen Sie sie aus:

    • Request filter: Der vollständige URI, das URI-Präfix oder Trace-Filterbegriffe.

      Wenn ein Projekt-Haupt-Span beispielsweise Recv ist, geben Sie den Namen des Haupt-Spans, Recv, oder ein Präfix des Haupt-Span-Namens ein, um alle Anfragen einzubeziehen. Wenn Sie den Bericht auf Traces mit einem URI mit dem Präfix Recv/cart beschränken möchten, geben Sie dieses Präfix in den Filter ein.

      Sie können Traces auch nach Span-Attributen filtern. Wenn Sie beispielsweise /http/status_code:5 hinzufügen, enthält der Bericht nur die Traces, die einen Span mit dem Attributschlüssel /http/status_code und Attributwerten mit dem Präfix 5 haben.
    • HTTP method: HTTP-Methode für die Anfrage. Die Standardeinstellung ist Alle.
    • HTTP Status: Der von der Anfrage zurückgegebene HTTP-Status. Die Standardeinstellung ist Alle.
    • Report Name: Der für Menschen lesbare Name des Berichts. Wenn für dieses optionale Feld kein Name angegeben ist, erstellt Trace einen Namen basierend auf dem angegebenen Anfragefilter und dem Zeitpunkt, zu dem der Bericht erstellt wurde.
    • Module: Das App Engine-Modul (Java, Python, Go oder PHP), von dem die Anfrage verarbeitet wurde. Die Standardeinstellung ist Alle.
    • Version: Version der App Engine-Anwendung, die die Anfrage verarbeitet hat. Die Standardeinstellung ist Alle.
    • Time Range: Der Zeitraum, in dem die Anfragen aufgetreten sind. Sie können Letzte Stunde, Letzte 24 Stunden, Letzte Woche oder Zeitraum festlegen wählen. Wenn Sie Zeitruamm festlegen auswählen, müssen Sie die Start- und Endzeiten für den Bereich angeben. Der Standardwert ist Zeitraum festlegen.
  4. (Optional) Wenn Sie zwei Sätze von Latenzdaten vergleichen möchten, wählen Sie Mit Referenz vergleichen aus und geben Sie den Zeitraum für die Vergleichsdaten ein.

  5. Klicken Sie auf Senden.

Bericht duplizieren

In Trace können Sie die Filterparameter eines vorhandenen Berichts duplizieren.

  1. Geben Sie in der Suchleiste der Google Cloud Console Analyseberichte ein. Gehen Sie in den Suchergebnissen zum Abschnitt Produkte und Seiten und wählen Sie die Seite Analyseberichte für Trace aus:

    Gehen Sie zu Analyseberichte

  2. Klicken Sie auf den Namen des Berichts, dessen Struktur Sie duplizieren möchten.

  3. Klicken Sie auf Ähnlichen Bericht erstellen.

  4. Bearbeiten Sie auf der Seite Neue Berichtsanforderung einen oder mehrere Berichtsparameter, einschließlich des Namens des Berichts.

  5. Klicken Sie auf Senden.

Bericht aufrufen

So zeigen Sie einen Analysebericht an:

  1. Geben Sie in der Suchleiste der Google Cloud Console Analyseberichte ein. Gehen Sie in den Suchergebnissen zum Abschnitt Produkte und Seiten und wählen Sie die Seite Analyseberichte für Trace aus:

    Gehen Sie zu Analyseberichte

  2. Klicken Sie zum Ansehen eines Berichts auf den Namen des Berichts.

Nach Dichteverteilung anzeigen

Standardmäßig ist die Schaltfläche Dichteverteilung aktiviert. Bei dieser Einstellung ist die x-Achse die Trace-Latenz auf einer logarithmischen Skala, während die y-Achse der Prozentsatz der Gesamtanfragen mit dieser Latenz ist:

Cloud Trace-Bericht mit Latenz, die als Histogramm angezeigt wird.

Wenn Sie einen Vergleichsbericht erstellen, überlagert Trace die Daten aus den beiden Datasets, damit Sie sie vergleichen und Änderungen analysieren können:

Cloud Trace-Vergleichsbericht mit Latenz, als Histogramm angezeigt

Im Vergleichsbericht gibt die Legende im Bericht den Zeitraum für die orangefarbenen und blauen Diagramme an. Diese Angaben wurden im Screenshot weggelassen.

Nach kumulativer Verteilung anzeigen

Zum Anzeigen der Gesamtzahl der Anfragen, deren Latenz kleiner oder gleich dem Latenzwert auf der x-Achse ist, klicken Sie auf Kumulative Verteilung:

Cloud Trace-Bericht mit Latenz als kumulative Verteilung.

Informationen zum Latenzbereich

Der Bereich Latenz zeigt Latenzperzentile an und enthält Links zu Traces für repräsentative Beispielanfragen. Wenn Sie Details zu einem bestimmten Trace ansehen möchten, wählen Sie eines der vier Beispiel-Traces aus. Wenn Sie eines der Beispiel-Traces auswählen, wird die Seite Trace Explorer mit detaillierten Informationen zum Haupt-Span dieses Trace geöffnet. Weitere Informationen finden Sie unter Traces suchen und untersuchen.

In folgender Abbildung sehen Sie den Bereich des Latenzen eines Analyseberichts. In diesem Fall gibt es nur ein Dataset, das durch den Buchstaben A gekennzeichnet ist:

Cloud Trace-Latenzbereich.

Wenn Sie einen Vergleichsbericht erstellen, enthält der Latenzdatenbereich Informationen zu beiden Datasets. Die Legende für den Bereich identifiziert die Einträge, die zu den einzelnen Datasets gehören.

Der Bereich „Engpässe“

Ein Engpass gibt an, dass der Latenzwert für einen Span in einem bestimmten Trace außerhalb des erwarteten Latenzwertbereichs liegt. Cloud Trace bestimmt den erwarteten Bereich von Latenzwerten mithilfe von statistischen Techniken, die auf der Berechnung und dem Vergleich empirischer Latenzverteilungen für Teilmengen von Traces beruhen.

Im Bereich Engpässe werden ggf. RPC-Aufrufe aufgelistet, die wesentlich zur Latenz in den Anfragen beitragen. In diesem Bereich werden die RPC-Aufrufe nach Perzentil mit repräsentativen Beispielanfragen angezeigt. Sie können unter Beispiel-Traces auf eine Zahl klicken, um die Details für einen bestimmten Trace aufzurufen.

Die folgende Abbildung zeigt den Bereich Engpässe für einen Analysebericht. In diesem Fall gibt es nur ein Dataset, das durch den Buchstaben A gekennzeichnet ist:

Bereich mit Engpässen von Cloud Trace-Anfragen.

In einem Vergleichsbericht sind im Bereich "Engpässe" die RPC-Aufrufe hervorgehoben, die zu Änderungen der Latenzverteilung zwischen den beiden Datasets geführt haben. Die Legende in diesem Bereich gibt die Einträge an, die zu den einzelnen Datasets gehören.

Nächste Schritte