Ergebnisse des synthetischen Monitoring ansehen

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

Hinweise

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zu gewähren, damit Sie die erforderlichen Berechtigungen zum Ansehen der Ausführungsergebnisse von synthetischen Monitorings in der Google Cloud Console 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 der bestandenen und fehlgeschlagenen Ausführungen finden Sie auf der Seite Details des synthetischen Monitors für den synthetischen Monitor:

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

    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 Monitor öffnen möchten, suchen Sie den synthetischen Monitor, den Sie anzeigen möchten, und klicken Sie auf seinen Namen.

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

Jede Zeile in der Tabelle enthält Status, Datum und Dauer und ist mit einer Seite verknüpft, auf der der aktuelle Code und die relevanten Logs für diese Ausführung angezeigt werden.

Logs und Traces für eine Ausführung ansehen

Klicken Sie auf der Seite Details zum synthetischen Monitor auf den Link zur Ausführung, um die Logs, Traces und zusammenfassenden Informationen für eine Ausführung anzusehen. 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 den Mocha-Test die Ergebnisse der einzelnen Tests an. Wenn der synthetische Monitor beispielsweise vier Mocha-Tests enthält, enthält der Bereich Testergebnisse vier Einträge. Jeder Eintrag in der Liste wird als bestanden oder als fehlgeschlagen gekennzeichnet.

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

Logdaten ansehen

Logs werden von Cloud Monitoring automatisch erfasst. Diese Logs enthalten Informationen zu den 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 fehlgeschlagen ist, die Testdauer und im Fall eines Fehlers einen vollständigen Stacktrace. Der Stacktrace enthält die fehlgeschlagene Codezeile, die Fehlertypen und die Fehlermeldungen.

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

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 bei der Ausführung Ihrer Cloud Functions-Funktion automatisch erfasst. Der folgende Screenshot zeigt die Art von Daten, die Trace erfasst, wenn Sie die generische Vorlage verwenden:

Cloud Trace mit Details eines Trace für eine Cloud Functions-Funktion

Im vorherigen Screenshot wird in der ersten Zeile des Gant-Diagramms die von Cloud Monitoring initiierte HTTP-Anfrage angezeigt. Die Trace-Daten zeigen den Text an, der an den Winston-Logger übergeben wurde, und die ausgehende HTTP-Anfrage, die durch den get-Aufruf von axios ausgegeben wurde.

Wenn Sie im Trace-Flyout auf In Trace ansehen klicken, können Sie Ihre Trace-Daten mit dem Cloud Trace Explorer ansehen. Der Trace ist bereits erweitert und zeigt Details an. Wenn in Ihrem Trace oder Span ein Kreis angezeigt wird, können Sie auf den Kreis klicken, um den Logeintrag anzuzeigen. Die Cloud Functions-Funktion kann im Feld resource.labels.service_name identifiziert werden.

Console

Führen Sie einen der folgenden Schritte aus, um Ihre Trace-Daten aufzurufen:

  • Klicken Sie zum Aufrufen von zusammenfassenden Informationen für einen Trace in der Symbolleiste der Detailseite für eine Ausführung auf Trace-Details anzeigen.

    Es öffnet sich ein Flyout mit einer Zusammenfassung der Latenzdaten. Vollständige Informationen zum Trace und seinen Spans finden Sie in den Daten in Cloud Trace. Klicken Sie zum Öffnen von Cloud Trace auf In Trace ansehen.

  • Traces in Cloud Trace ansehen:

    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 einem Span zugeordnet ist, wird mit einem Kreis gekennzeichnet. Wählen Sie den Kreis aus, um Details zum Ereignis oder Protokoll zu erhalten.

Weitere Informationen zum Untersuchen von Trace-Daten finden Sie unter Traces suchen und untersuchen.

API

Wir empfehlen, die Trace-Daten mit 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, und 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. Logs, die ein Feld namens userAgent mit dem Wert GoogleStackdriverMonitoring-UptimeChecks enthalten, weisen beispielsweise darauf hin, dass Ihr Dienst eine Anfrage vom Verfügbarkeitsdiagnose-Dienst erhalten hat.

Im Rest 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 die Logdaten 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 und unter anderem die Abfrage verfeinern, einen logbasierten Messwert oder eine logbasierte Benachrichtigung erstellen.

API

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

Funktionsmesswerte ansehen

Für synthetische Monitore 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 zeichnen die Ausführungszeit, die Arbeitsspeicherauslastung, die Instanzanzahl und die Anzahl der Aufrufe pro Abschnitt auf. Im weiteren Verlauf dieses Abschnitts wird beschrieben, wie Sie diese Messwerte aufrufen können.

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 darauf.
  2. Ziehen Sie den Mauszeiger horizontal zum anderen Ende des Zeitraums und lassen Sie die Zeigerschaltfläche 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 dann eine Auswahl. Folgende Optionen sind verfügbar:

  • 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 Function-Messwerten finden Sie unter Überwachte Messwerte ansehen.