Prüftool für fehlerhafte Links erstellen

Console

Wenn Sie einen synthetischen Monitor mit der Google Cloud Console erstellen, wird eine neue Cloud Run-Funktion (2. Generation) bereitgestellt und der Monitor für diese Cloud Run-Funktion erstellt. Sie können keinen synthetischen Monitor erstellen, der eine vorhandene Cloud Run-Funktion überwacht.

1. Achten Sie darauf, dass Sie die erforderlichen APIs aktiviert haben, dass Ihr Projekt ein Compute Engine-Standarddienstkonto enthält und dass diesem Konto die Rolle „Bearbeiter“ (roles/editor) zugewiesen wurde. Weitere Informationen finden Sie unter Vorab.

2. 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.

3. Wählen Sie Synthetischen Monitor erstellen aus.
4. Wählen Sie als Vorlage Broken link checker aus.
5. Geben Sie einen Namen für den synthetischen Monitor ein.

6. Optional: Aktualisieren Sie die Antwortzeitüberschreitung und die Prüfzeitraum und fügen Sie benutzerdefinierte Labels hinzu.

7. Konfigurieren Sie die URI und die zu testenden Elemente:

   1. Klicken Sie auf Quell-URI und geben Sie einen URI ein, den Sie testen möchten. Der eingegebene Wert muss ein HTTP- oder HTTPS-Endpunkt sein. Sie können beispielsweise https://mywebsite.example.com eingeben.

   2. Optional: Aktualisieren Sie unter Anzahl der Links, denen gefolgt werden soll die maximale Anzahl der getesteten Links. Der Standardwert dieses Felds ist 10.

   3. Optional: Geben Sie im Feld HTML-Element-Selektor das HTML-Element, das abgeglichen werden soll, als durch Kommas getrennte Liste ein. Der eingegebene Wert wird in einen String umgewandelt und dann an die Methode Document: querySelectorAll() übergeben.

      Standardmäßig ist dieses Feld auf a gesetzt, was Ankern entspricht. Sie können Werte wie a, img eingeben, wenn Sie sowohl Anker als auch Bilder abgleichen möchten.

   4. Optional: Geben Sie im Feld HTML-Attribute, denen gefolgt werden soll die HTML-Attribute ein, die abgeglichen werden sollen. Die von Ihnen eingegebenen kommagetrennten Werte werden einzeln an die Methode getAttribute() übergeben.

      Standardmäßig ist dieses Feld auf href gesetzt. Dies ist der URI für den Link. Sie können mehrere Attribute eingeben, z. B. href, src. In diesem Beispiel wird im Code nach dem Attribut href und dann nach dem Attribut src gesucht.

   5. Optional: Konfigurieren Sie „Warten auf Selector“, Zeitüberschreitung pro URI, Wiederholungen und erwartete Statuscodes:

      1. Klicken Sie auf Weitere Optionen anzeigen.

      2. Wenn Sie die Prüfung auf fehlerhafte Links so konfigurieren möchten, dass gewartet wird, bis ein bestimmter Selektor im URI erscheint, bevor Links gescrapt werden, geben Sie die CSS-Selektoren in das Feld Auf Element-Selektor warten ein. Der eingegebene Wert wird in einen String konvertiert und dann an die Methode page.waitForSelector() übergeben.

         Wenn die Auswahl vor Ablauf der Zeitüberschreitung nicht angezeigt wird, wird der Fehler in den Protokollen aufgezeichnet.

      3. Aktualisieren Sie die Reihenfolge, in der Links für den Test ausgewählt werden.

      4. Konfigurieren Sie Wiederholungsversuche.

         Standardmäßig wird an jeden Link eine Anfrage gesendet. Wenn die erste Anfrage aus irgendeinem Grund fehlschlägt, z. B. wenn der Befehl abläuft oder der HTTP-Statuscode nicht 200 ist, wird der Link als fehlgeschlagen markiert.

         In diesem Feld wird angegeben, wie oft der Prüfer für fehlerhafte Links eine HTTP-Anfrage an einen Link senden kann, bevor der Link als fehlerhaft markiert wird.

      5. Konfigurieren Sie ein Zeitlimit, das auf jeden URI angewendet wird. Standardmäßig ist dieser Wert auf 30 Sekunden festgelegt.

      6. Wenn Sie den erwarteten Statuscode und die Zeitüberschreitung für einen bestimmten URI angeben möchten, klicken Sie auf Option pro Link hinzufügen und füllen Sie das Dialogfeld aus.

8. Optional: Konfigurieren Sie, ob Screenshots von Antworten erfasst und gespeichert werden. Wenn Sie die Standardeinstellungen verwenden, werden Screenshots nicht gespeichert. Wenn Sie die Screenshot-Erfassung aktivieren, können Sie Screenshots für alle Tests oder nur für fehlgeschlagene Tests erfassen. In Cloud Monitoring wird der Cloud Storage-Bucket folgendermaßen benannt:

   gcm-PROJECT_ID-synthetics-LOCATION
   

   Im vorherigen Ausdruck:

   • PROJECT_ID: ID Ihres Google Cloud-Projekts.
   • LOCATION: Der Speicherort Ihres Cloud Storage-Bucket.

   Sie können einen vorhandenen Cloud Storage-Bucket verwenden.

9. Prüfen Sie Ihre Konfiguration und achten Sie darauf, dass sie korrekt und vollständig ist. Erstellen Sie dann Ihre Cloud Run-Funktion:

   1. Klicken Sie auf Funktion erstellen.

      Die Werte in den Feldern der URI-Konfiguration werden in das Options-Objekt in der index.js-Datei kopiert, wenn Sie auf Funktion erstellen klicken. Nachdem Sie auf Funktion erstellen geklickt haben, bearbeiten Sie das Options-Objekt, um die Konfiguration zu ändern.

   2. Geben Sie einen Anzeigenamen ein und wählen Sie eine Region aus. Namen müssen innerhalb einer Region eindeutig sein.

   3. Führen Sie im Abschnitt Laufzeit, Build, Verbindungen und Sicherheitseinstellungen die folgenden Schritte aus:

      • Achten Sie darauf, dass auf dem Tab Verbindungen die Option Gesamten Traffic zulassen ausgewählt ist.

      • Prüfen Sie die Standardeinstellungen und aktualisieren Sie sie bei Bedarf.

      • Wählen Sie im Feld Laufzeitdienstkonto ein Dienstkonto aus.

   4. Klicken Sie auf Funktion anwenden.

10. Konfigurieren Sie die Benachrichtigungsrichtlinie:

    1. Optional: Aktualisieren Sie den Namen der Benachrichtigungsrichtlinie und die Dauer des Fehlers, bevor Benachrichtigungen gesendet werden.

    2. Fügen Sie die Benachrichtigungskanäle hinzu.

11. Klicken Sie auf Erstellen.

    Die von Ihnen definierte Cloud Run-Funktion wird als Cloud Run-Funktion der 2. Generation erstellt und bereitgestellt. Der synthetische Monitor wird erstellt.

API

Das Erstellen einer Prüfung auf fehlerhafte Links mit der Cloud Monitoring API entspricht dem Erstellen eines anderen synthetischen Monitors. Informationen zum Erstellen eines synthetischen Monitors mit der Cloud Monitoring API finden Sie unter Synthetisches Monitoring erstellen. Wählen Sie dazu den Tab „Cloud Monitoring“ aus.

Für die Prüfung auf fehlerhafte Links wird die Vorlage broken-links-ok verwendet. Die Konfiguration für einen Checker für fehlerhafte Links wird durch das options-Objekt der index.js-Datei angegeben.

Wenn die options.screenshot_options-Struktur definiert ist, erfasst die Prüfung auf fehlerhafte Links Screenshots und speichert sie in einem Cloud Storage-Bucket. Wenn das Feld screenshot_options.storage_location nicht definiert ist oder der Wert ein leerer String ist, wird von Monitoring ein Cloud Storage-Bucket erstellt und Screenshots werden in diesem Bucket gespeichert. Für den Cloud Storage-Bucket wird bei der Überwachung die folgende Namenskonvention verwendet:

gcm-PROJECT_ID-synthetics-LOCATION

Im vorherigen Ausdruck:

• PROJECT_ID: ID Ihres Google Cloud-Projekts.
• LOCATION: Der Speicherort Ihres Cloud Storage-Bucket.

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle. Weitere Informationen finden Sie in der Anbieterreferenzdokumentation zu Terraform.

Das Erstellen eines Checker für fehlerhafte Links mit Terraform entspricht dem Erstellen eines anderen synthetischen Monitors. Informationen zum Erstellen eines synthetischen Monitors mit Terraform finden Sie unter Synthetischen Monitor erstellen. Wählen Sie dazu den Tab „Terraform“ aus.

Für die Überprüfung von fehlerhaften Links wird die Vorlage broken-links-ok verwendet. Die Konfiguration für einen Checker für fehlerhafte Links wird durch das options-Objekt der index.js-Datei angegeben.

Wenn die options.screenshot_options-Struktur definiert ist, erfasst die Prüfung auf fehlerhafte Links Screenshots und speichert sie in einem Cloud Storage-Bucket. Wenn das Feld screenshot_options.storage_location nicht definiert ist oder der Wert ein leerer String ist, wird von Monitoring ein Cloud Storage-Bucket erstellt und Screenshots werden in diesem Bucket gespeichert. Für den Cloud Storage-Bucket wird bei der Überwachung die folgende Namenskonvention verwendet:

gcm-PROJECT_ID-synthetics-LOCATION

Im vorherigen Ausdruck:

• PROJECT_ID: ID Ihres Google Cloud-Projekts.
• LOCATION: Der Speicherort Ihres Cloud Storage-Bucket.