Ergebnisse des synthetischen Monitorings analysieren

In diesem Dokument wird beschrieben, wie Sie den Ausführungsverlauf Ihrer synthetischen Monitore untersuchen und wie Sie die erfassten Messwerte und Protokolle aufrufen.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen der Ausführungsergebnisse von synthetischen Monitoren in der Google Cloud Console benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Ausführungsverlauf für einen synthetischen Monitor aufrufen

Informationen zu erfolgreichen und fehlgeschlagenen Ausführungen finden Sie auf der Seite Details zum synthetischen Monitor des synthetischen Monitors:

  1. Rufen Sie in der Google Cloud Console die Seite  Synthetisches Monitoring auf:

    Gehen Sie zu Synthetisches Monitoring.

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wenn Sie die Seite Details zum synthetischen Monitoring öffnen möchten, suchen Sie den gewünschten synthetischen Monitor und klicken Sie auf seinen Namen.

Auf der Seite Details zum synthetischen Monitoring finden Sie zusammenfassende Informationen wie die Erfolgsrate, die Dauer und den aktuellen Status. Auf dieser Seite wird auch die aufgezeichnete Dauer der Ausführung dargestellt. Außerdem enthält sie eine Tabelle mit einer Zeile für jede Ausführung.

Jede Zeile in der Tabelle enthält den Status, das Datum, die Dauer und einen Link zu einer Seite mit dem aktuellen Code und den Protokollen, die für diese Ausführung relevant sind.

Logs und Traces für eine Ausführung ansehen

Wenn Sie die Protokolle, Traces und Zusammenfassungsinformationen für eine Ausführung aufrufen möchten, klicken Sie auf der Seite Details zum synthetischen Monitor auf den Link zur Ausführung. Auf dieser Seite haben Sie folgende Möglichkeiten:

  • Protokolldaten ansehen
  • Trace-Daten ansehen
  • Aktuellen Code ansehen

  • Rufen Sie die Cloud Run-Funktion auf.

  • Rufen Sie für den Mocha-Test die Ergebnisse für jeden Test auf. Wenn Ihr synthetischer Monitor beispielsweise vier Mocha-Tests enthält, enthält der Bereich Testergebnisse vier Einträge. Jeder Eintrag in der Liste ist mit „Bestanden“ oder „Nicht bestanden“ gekennzeichnet.

    Wenn Sie einen Eintrag auswählen, der als fehlgeschlagen markiert ist, wird der Fehlercode angezeigt und hervorgehoben.

Logdaten ansehen

Logs werden automatisch von Cloud Monitoring erfasst. Diese Protokolle enthalten Informationen zum Test und zu den Fehlerdetails. Welche Protokolle verfügbar sind, hängt von Ihrer Cloud Run-Funktion ab. Wenn Sie beispielsweise Mocha verwenden, enthalten die Protokolle Informationen dazu, ob der Test bestanden oder fehlgeschlagen ist, die Testdauer und im Falle eines Fehlers einen vollständigen Stack-Trace. Der Stack-Trace enthält die fehlerhafte Codezeile, Fehlertypen und Fehlermeldungen.

Wenn Sie Details zu den zugehörigen Logs aufrufen möchten, maximieren Sie im Bereich Ausführungsprotokolle einen Logeintrag.

Der Logeintrag wird im JSON-Format angezeigt. Wenn Sie sich die Protokolle lieber im Log-Explorer ansehen möchten, klicken Sie auf Im Log-Explorer öffnen. Der Log-Explorer wird geöffnet und eine Abfrage ist vorkonfiguriert.

Trace-Daten ansehen

Trace-Daten werden automatisch erfasst, wenn Ihre Cloud Run-Funktion ausgeführt wird. Der folgende Screenshot zeigt, welche Daten bei Verwendung der generischen Vorlage erfasst werden:

Cloud Trace mit Details zu einem Trace für eine Cloud Run-Funktion

Im vorherigen Screenshot wird in der ersten Zeile des Gantt-Diagramms die von Cloud Monitoring initiierte HTTP-Anfrage angezeigt. Die Trace-Daten enthalten den Text, der an den Winston-Logger übergeben wurde, und die ausgehende HTTP-Anfrage, die vom Axios-get-Aufruf gesendet wurde.

Wenn Sie im Flyout für den Trace auf In Trace ansehen klicken, können Sie Ihre Trace-Daten im Cloud Trace-Explorer aufrufen. Ihr Trace ist bereits maximiert, um Details anzuzeigen. Wenn in Ihrem Trace oder Ihrer Spanne ein Kreis angezeigt wird, können Sie darauf klicken, um den Logeintrag aufzurufen. Die Cloud Run-Funktion wird im Feld resource.labels.service_name angezeigt.

Console

So rufen Sie Ihre Trace-Daten auf:

  • Wenn Sie Zusammenfassungsinformationen für einen Trace aufrufen möchten, klicken Sie in der Symbolleiste der Detailseite für eine Ausführung auf Trace-Details ansehen.

    Es wird ein Flyout mit einer Zusammenfassung der Latenzdaten geöffnet. Vollständige Informationen zum Trace und seinen Spannen finden Sie in den Daten in Cloud Trace. Klicken Sie auf In Trace ansehen, um Cloud Trace zu öffnen.

  • So rufen Sie Ihre Traces in Cloud Trace auf:

    1. Rufen Sie in der Google Cloud Console die Seite Trace Explorer auf:

      Zum Trace Explorer

      Sie können diese Seite auch über die Suchleiste finden.

    2. Wählen Sie im Streudiagramm oder in der Tabelle einen Trace aus.
    3. Für jedes Protokoll oder Ereignis, das mit einem Span verknüpft ist, wird der Span mit einem Kreis gekennzeichnet. Wenn Sie Details zum Ereignis oder Protokoll aufrufen möchten, wählen Sie den Kreis aus.

Weitere Informationen zum Analysieren von Trace-Daten finden Sie unter Traces suchen und analysieren.

API

Wir empfehlen, die Google Cloud Console zum Aufrufen von Trace-Daten zu verwenden. Wenn Sie jedoch die Cloud Trace API verwenden möchten, verwenden Sie die Methode traces.list, um die verfügbaren Traces aufzulisten, und dann die Methode traces.get, um die Details eines Traces abzurufen.

Logs und Messwerte für eine Cloud Run-Funktion aufrufen

Protokolle und Messwerte enthalten Informationen zu den Aktionen, die von Ihrer Cloud Run-Funktion ausgeführt werden. Logs, die beispielsweise ein Feld namens userAgent mit dem Wert GoogleStackdriverMonitoring-UptimeChecks enthalten, weisen darauf hin, dass Ihr Dienst eine Anfrage vom Dienst zur Verfügbarkeitsdiagnose erhalten hat.

Im restlichen Teil dieses Abschnitts wird beschrieben, wie Sie die von Cloud Run-Funktionen erfassten Protokolle und Messwerte aufrufen.

Funktionslogs ansehen

Console

So rufen Sie die Logs einer Cloud Run-Funktion auf:

  1. Klicken Sie im Bereich mit dem Namen des synthetischen Monitors auf den Namen der Cloud Run-Funktion.
  2. Wählen Sie auf der Seite Funktionsdetails den Tab Protokolle aus.

Wenn Sie die Protokolldaten in einem Diagramm genauer untersuchen möchten, maximieren Sie einen Logeintrag und wählen Sie dann Im Log-Explorer öffnen aus. Im Log-Explorer können Sie Aktionen ausführen, z. B. die Abfrage verfeinern, einen logbasierten Messwert oder eine logbasierte Benachrichtigung erstellen.

API

Informationen zum programmatischen Lesen und Schreiben von Cloud Run-Funktions-Logs finden Sie unter Logs schreiben, ansehen und beantworten.

Funktionsmesswerte ansehen

Bei synthetischen Monitoren werden Messwerte sowohl von Cloud Monitoring als auch von Cloud Run-Funktionen erfasst:

  • Cloud Monitoring erfasst Messwerte zu jeder Ausführung eines synthetischen Monitors. Dazu gehören die Latenz der Codeausführung und der Erfolgsverlauf. Informationen zum Aufrufen dieser Messwerte finden Sie unter Ausführungsverlauf für ein synthetisches Monitoring aufrufen.

  • Für Cloud Run-Funktionen werden Messwerte zu jeder Cloud Run-Funktion erfasst. Diese Messwerte erfassen die Ausführungszeit, die Arbeitsspeichernutzung, die Anzahl der Instanzen und die Anzahl der Aufrufe pro Bereich. Im restlichen Teil dieses Abschnitts wird beschrieben, wie Sie diese Messwerte aufrufen.

Console

So rufen Sie Messwerte für Cloud Run-Funktionen auf:

  1. Klicken Sie im Bereich mit dem Namen des synthetischen Monitors auf den Namen der Cloud Run-Funktion.
  2. Wählen Sie auf der Seite Funktionsdetails den Tab Messwerte aus.

So zoomen Sie auf einen bestimmten Zeitraum heran:

  1. Platzieren Sie den Mauszeiger in einem Diagramm an einem Ende des Zeitraums und klicken Sie dann mit der linken Maustaste darauf.
  2. Ziehen Sie den Mauszeiger horizontal zum anderen Ende des Zeitraums und lassen Sie die Maustaste los.

Wenn Sie die angezeigten Daten in einem Diagramm genauer untersuchen möchten, wählen Sie in der Diagrammsymbolleiste Weitere Diagrammoptionen aus und treffen Sie eine Auswahl. Folgende Optionen stehen zur Verfügung:

  • Diagramm als PNG- oder CSV-Datei herunterladen
  • Diagramm in einem benutzerdefinierten Dashboard speichern
  • Metrics Explorer öffnen
  • Diagrammlegende maximieren oder minimieren
  • Zoom zurücksetzen

API

Informationen zum programmatischen Lesen von Cloud Run-Funktionsmesswerten finden Sie unter Überwachte Messwerte aufrufen.