Ergebnisse des synthetischen Monitorings untersuchen

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

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zu gewähren, um die erforderlichen Berechtigungen zum Ansehen der Ausführungsergebnisse von synthetischen Monitoren über die Google Cloud Console zu erhalten:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

Ausführungsverlauf für einen synthetischen Monitor ansehen

Den Verlauf bestandener und fehlgeschlagener Ausführungen finden Sie auf der Seite Details zum synthetischen Monitor für den synthetischen Monitor:

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

    Zur Seite Synthetisches Monitoring

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

  2. Suchen Sie den gewünschten synthetischen Monitor und klicken Sie auf seinen Namen, um die Seite Details zum synthetischen Monitor zu öffnen.

Auf der Seite Details zum synthetischen Monitor finden Sie zusammenfassende Informationen wie die Erfolgsquote, die Dauer und den aktuellen Status. Auf dieser Seite wird auch die aufgezeichnete Dauer der Ausführung dargestellt. Sie enthält eine Tabelle, in der für jede Ausführung eine Zeile angezeigt wird.

Jede Zeile der Tabelle enthält den Status, das Datum und die Dauer sowie einen Link zu einer Seite, auf der der aktuelle Code und die für diese Ausführung relevanten Logs angezeigt werden.

Logs und Traces für eine Ausführung ansehen

Klicken Sie zum Aufrufen der Logs, Traces und zusammenfassenden Informationen für eine Ausführung 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

  • Sehen Sie sich den aktuellen Code an.

  • Auf die Cloud Functions-Funktion zugreifen

  • Sehen Sie sich für einen Mocha-Test die Ergebnisse der einzelnen Tests an. Wenn Ihr synthetischer Monitor beispielsweise vier Mocha-Tests enthält, enthält der Bereich Testergebnisse vier Einträge. Jeder Eintrag in der Liste wird als bestanden oder nicht bestanden.

    Wenn Sie einen Eintrag auswählen, der als fehlgeschlagen gekennzeichnet ist, wird der fehlerhafte Code angezeigt und hervorgehoben.

Logdaten ansehen

Logs werden von Cloud Monitoring automatisch erfasst. Diese Logs enthalten Informationen über die Test- und Fehlerdetails. Die verfügbaren Logs hängen von Ihrer Cloud Functions-Funktion ab. Wenn Sie beispielsweise Mocha verwenden, enthalten die Logs Informationen darüber, ob der Test bestanden wurde oder nicht, die Testdauer und im Fall eines Fehlers einen vollständigen Stacktrace. Der Stacktrace enthält die fehlgeschlagene Codezeile, Fehlertypen und Fehlermeldungen.

Maximieren Sie im Bereich Ausführungslogs einen Logeintrag, um Details zu den zugehörigen Logs anzusehen.

Der Logeintrag wird im JSON-Format angezeigt. Wenn Sie die Logs lieber mit dem 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 Functions-Funktion ausgeführt wird. Der folgende Screenshot zeigt, welche Art von Daten bei Verwendung der generischen Vorlage von Trace erfasst werden:

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

Im vorherigen Screenshot wird in der ersten Zeile des Ggantt-Diagramms die von Cloud Monitoring initiierte HTTP-Anfrage angezeigt. Die Trace-Daten zeigen den Text an, der an den Winston-Logging übergeben wurde, sowie die ausgehende HTTP-Anfrage, die vom Axios-Aufruf get ausgegeben wurde.

Wenn Sie im Trace-Flyout auf Im Trace ansehen klicken, können Sie Ihre Trace-Daten mit dem Cloud Trace Explorer ansehen. Ihr Trace ist bereits erweitert, sodass Details angezeigt werden können. Wenn im Trace oder Span ein Kreis angezeigt wird, können Sie darauf klicken, um den Logeintrag aufzurufen. Sie können die Cloud Functions-Funktion im Feld resource.labels.service_name identifizieren.

Console

So rufen Sie die Trace-Daten auf:

  • Wenn Sie sich zusammenfassende Informationen zu einem Trace ansehen möchten, klicken Sie in der Symbolleiste der Detailseite für eine Ausführung auf Trace-Details ansehen.

    Ein Flyout-Menü mit einer Zusammenfassung der Latenzdaten wird geöffnet. Ausführliche Informationen zum Trace und seinen Spans finden Sie in den Daten in Cloud Trace. Klicken Sie zum Öffnen von Cloud Trace auf Im Trace ansehen.

  • Sehen Sie sich die Traces in Cloud Trace an:

    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. Jedes Log oder Ereignis, das mit einem Span verknüpft ist, wird mit einem Kreis gekennzeichnet. Wählen Sie den Kreis aus, um Details zum Ereignis oder Protokoll zu sehen.

Weitere Informationen zum Prüfen der Trace-Daten finden Sie unter Traces suchen und untersuchen.

API

Wir empfehlen, die Trace-Daten in der Google Cloud Console anzusehen. Wenn Sie jedoch die Cloud Trace API verwenden möchten, verwenden Sie die Methode traces.list, um die verfügbaren Traces aufzulisten. Verwenden Sie dann die Methode traces.get, um die Details eines Trace abzurufen.

Logs und Messwerte für eine Cloud Functions-Funktion ansehen

Logs und Messwerte liefern Ihnen Informationen zu den Aktionen, die Ihre Cloud Functions-Funktion ausführt. Beispielsweise zeigen Logs, die ein Feld namens userAgent mit dem Wert GoogleStackdriverMonitoring-UptimeChecks enthalten, dass Ihr Dienst eine Anfrage vom Verfügbarkeitsdiagnosedienst erhalten hat.

Im weiteren Verlauf dieses Abschnitts wird beschrieben, wie Sie die von Cloud Functions erfassten Logs und Messwerte aufrufen können.

Funktionslogs ansehen

Console

So rufen Sie Cloud Function-Logs auf:

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

Wenn Sie sich die Logdaten in einem Diagramm genauer ansehen möchten, maximieren Sie einen Logeintrag und wählen Sie dann Im Log-Explorer öffnen aus. Im Log-Explorer können Sie Aktionen wie die Verfeinerung der Abfrage, das Erstellen eines logbasierten Messwerts oder das Erstellen einer logbasierten Benachrichtigung ausführen.

API

Informationen zum programmatischen Lesen und Schreiben von Cloud Function-Logs finden Sie unter Logs schreiben, ansehen und darauf reagieren.

Funktionsmesswerte ansehen

Für synthetisches Monitoring werden Messwerte sowohl von Cloud Monitoring als auch von Cloud Functions erfasst:

  • Cloud Monitoring erfasst Messwerte zu jeder Ausführung eines synthetischen Monitors. Zu diesen Messwerten gehören die Latenz der Codeausführung und der Erfolgsverlauf. Informationen zum Aufrufen dieser Messwerte finden Sie unter Ausführungsverlauf für einen synthetischen Monitor ansehen.

  • Cloud Functions erfasst Messwerte zu jeder Cloud Functions-Funktion. Diese Messwerte erfassen die Ausführungszeit, die Arbeitsspeicherauslastung, die Anzahl der Instanzen und die Anzahl der Aufrufe pro Abschnitt. Im weiteren Verlauf dieses Abschnitts wird beschrieben, wie Sie diese Messwerte aufrufen.

Console

So rufen Sie Cloud Function-Messwerte auf:

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

So zoomen Sie einen bestimmten Zeitraum heran:

  1. Platzieren Sie den Zeiger in einem Diagramm an einem Ende des Zeitraums und klicken Sie dann mit der linken Maustaste auf Ihren Zeiger.
  2. Ziehen Sie den Zeiger horizontal zum anderen Ende des Zeitraums und lassen Sie dann die Zeigerschaltfläche los.

Wenn Sie sich die in einem Diagramm angezeigten Daten genauer ansehen möchten, wählen Sie in der Diagrammsymbolleiste Weitere Diagrammoptionen aus und treffen Sie eine Auswahl. Folgende Optionen sind verfügbar:

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

API

Informationen zum programmgesteuerten Lesen von Cloud Function-Messwerten finden Sie unter Überwachte Messwerte ansehen.