Synthetische Monitore verwalten

Damit Ihre synthetischen Tests mit der Weiterentwicklung Ihrer Dienste Schritt halten, können Sie Ihre synthetischen Monitore auflisten, prüfen, bearbeiten, kopieren und löschen sowie die zugrunde liegenden Funktionen aktualisieren oder löschen. Sie können diese Verwaltungsaufgaben über die Google Cloud Console, die Google Cloud CLI oder die Cloud Monitoring API ausführen.

Informationen zum Aufrufen der Ausführungsergebnisse, Messwerte, Logs und Traces für einen synthetischen Monitor finden Sie unter Ergebnisse des synthetischen Monitors ansehen.

Hinweis

Führen Sie die folgenden Schritte im Google Cloud -Projekt aus, in dem Ihr synthetischer Monitor gespeichert ist. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

  • Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ansehen und Ändern von synthetischen Monitoren über die 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.

  • Die API-Anleitung auf dieser Seite bezieht sich auf den APIs Explorer. Sie können aber auch einen curl-Befehl ausführen. Der APIs Explorer bietet die curl-Syntax.

  • Wählen Sie die Schnittstelle aus, die Sie verwenden möchten:

    Console

    Wenn Sie über die Google Cloud Console auf Google Cloud -Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

    gcloud

    Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

    REST

    Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

      Installieren Sie die Google Cloud CLI.

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Synthetische Monitore auflisten

Console

So listen Sie die synthetischen Monitore in Ihrem Google Cloud Projekt auf:

  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. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

  3. Optional: Sie können Filter hinzufügen, um die angezeigten synthetischen Monitore einzuschränken.

    Jeder Filter besteht aus einem Namen und einem Wert. Sie können den Wert so festlegen, dass er genau oder teilweise mit einem Namen eines synthetischen Monitors übereinstimmt. Bei Übereinstimmungen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie beispielsweise alle synthetischen Monitore auflisten möchten, deren Name default enthält, gehen Sie so vor:

    • Klicken Sie auf Filter table (Filtertabelle) und wählen Sie Display name (Anzeigename) aus.
    • Geben Sie default ein und drücken Sie die Eingabetaste.

    Wenn Sie mehrere Filter haben, werden sie automatisch durch den logischen Wert AND verbunden, sofern Sie nicht den Filter OR einfügen.

Auf der Seite Synthetische Monitore wird für jeden synthetischen Monitor Folgendes angezeigt:

  • Status der letzten Ausführung.
  • Ein Link zu detaillierten Informationen zu diesem synthetischen Monitor.
  • Erfolgsquote und durchschnittliche Ausführungszeit.
  • Die Anzahl der Benachrichtigungsrichtlinien.
  • Ein -Menü Weitere Optionen, über das Sie den synthetischen Monitor bearbeiten, kopieren oder löschen und eine Benachrichtigungsrichtlinie erstellen können.

gcloud

Führen Sie den Befehl gcloud monitoring uptime list-configs aus, um Ihre Verfügbarkeitsdiagnosen und synthetischen Monitore aufzulisten:

gcloud monitoring uptime list-configs --project=PROJECT_ID

Ersetzen Sie vor dem Ausführen des vorherigen Befehls Folgendes:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

Die zurückgegebenen Daten enthalten Folgendes:

  • Name und Anzeigename.
  • Prüfen Sie die Kennung.
  • Überwachte Ressource.
  • Zeitraum zwischen den Prüfungen.

Sie können den Google Cloud CLI-Befehl so konfigurieren, dass die Ergebnisse gefiltert und sortiert werden.

REST

Wenn Sie die synthetischen Monitore in Ihrem Google Cloud Projekt auflisten möchten, einschließlich Verfügbarkeitsdiagnosen, rufen Sie die Methode projects.uptimeCheckConfigs.list auf:

  1. Klicken Sie auf projects.uptimeCheckConfigs.list.

  2. API Explorer verwenden

    Legen Sie parent auf den Namen des Projekts fest. Achten Sie darauf, dass Sie das folgende Format verwenden:

    projects/PROJECT_ID

    Im vorherigen Ausdruck ist PROJECT_ID Ihre Google Cloud Projekt-ID. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

Für einen synthetischen Monitor enthält das Ergebnis ein Feld mit dem Label syntheticMonitor.

Details eines synthetischen Monitors ansehen

Console

So rufen Sie die Details eines synthetischen Monitors in Ihrem Google Cloud -Projekt auf:

  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. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

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

    Wenn Sie Ihre Cloud Run-Funktion auf der Seite Funktionsdetails von Cloud Run Functions aufrufen möchten, wählen Sie den Tab Code aus und klicken Sie dann auf den Namen der Funktion. Die Seite Funktionsdetails wird in einem neuen Fenster geöffnet. Auf den Tabs auf dieser Seite können Sie Messwerte, Logs und Konfigurationsinformationen ansehen.

gcloud

Führen Sie den Befehl gcloud monitoring uptime describe aus, um die Details einer Uptime-Prüfung oder eines synthetischen Monitors aufzulisten:

gcloud monitoring uptime describe CHECK_ID --project=PROJECT_ID

Ersetzen Sie vor dem Ausführen des vorherigen Befehls Folgendes:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  • CHECK_ID: Die Kennung der Verfügbarkeitsdiagnose oder des synthetischen Monitors. Sie können die Kennung mit dem Befehl gcloud monitoring uptime list-configs abrufen und das Feld name prüfen. Weitere Informationen finden Sie unter Eindeutige Kennung eines synthetischen Monitors ermitteln.

Die für die Verfügbarkeitsdiagnose zurückgegebenen Daten umfassen Folgendes:

  • Name und Anzeigename.
  • Prüfen Sie die Kennung.
  • Überwachte Ressource.
  • Zeitraum zwischen den Prüfungen.

REST

Wenn Sie die Details eines bestimmten synthetischen Monitors in Ihrem Google Cloud -Projekt auflisten möchten, rufen Sie die Methode projects.uptimeCheckConfigs.get auf:

  1. Klicken Sie auf projects.uptimeCheckConfigs.get.

  2. API Explorer verwenden

    Legen Sie den Namen auf die ID des synthetischen Monitors fest. Achten Sie darauf, dass Sie das folgende Format verwenden:

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    Im vorherigen Ausdruck gilt Folgendes:

    • PROJECT_ID ist Ihre Google Cloud Projekt-ID. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
    • CHECK_ID ist die ID des synthetischen Monitors.

    Der Wert des Felds name könnte beispielsweise so aussehen:

    projects/my-project/uptimeCheckConfigs/10863117100295372627

    Um den Wert von CHECK_ID zu ermitteln, können Sie die Methode projects.uptimeCheckConfigs.list ausführen. Wenn Sie die Anzahl der zurückgegebenen Ergebnisse reduzieren möchten, fügen Sie einen Filter hinzu. Fügen Sie beispielsweise den Filter displayName="MySyntheticMonitor" hinzu.

Synthetischen Monitor oder Cloud Run-Funktion bearbeiten

Console

So bearbeiten Sie einen synthetischen Monitor oder seine Cloud Run-Funktion über die Seite Details zum 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. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  3. Suchen Sie den synthetischen Monitor, den Sie bearbeiten möchten, klicken Sie auf  Weitere Optionen und wählen Sie dann Bearbeiten aus.

  4. Optional: Wenn Sie die Cloud Run-Funktion bearbeiten möchten, klicken Sie auf Funktion bearbeiten, nehmen Sie die gewünschten Änderungen vor und klicken Sie dann auf Funktion anwenden.

    Wenn Sie die Ursprungs-URI oder die Optionen ändern möchten, mit denen festgelegt wird, welche Links getestet werden, bearbeiten Sie die Cloud Run-Funktion und aktualisieren Sie dann das options-Objekt in der Datei index.js. Informationen zu den Feldern und der Syntax für dieses Objekt finden Sie unter broken-links-ok/index.js.

  5. Klicken Sie auf Speichern, um die Änderungen beizubehalten. Klicken Sie andernfalls auf Abbrechen.

gcloud

Führen Sie den Befehl gcloud monitoring uptime update aus, um einen Uptime-Check oder einen synthetischen Monitor zu ändern:

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS --project=PROJECT_ID

Ersetzen Sie vor dem Ausführen des vorherigen Befehls Folgendes:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

  • CHECK_ID: Die Kennung der Verfügbarkeitsdiagnose oder des synthetischen Monitors. Sie finden die Kennung, indem Sie den Befehl gcloud monitoring uptime list-configs ausführen und das Feld name untersuchen. Weitere Informationen finden Sie unter Eindeutige Kennung eines synthetischen Monitors ermitteln.

  • Legen Sie fest, welche Felder Sie ändern möchten. Bei synthetischen Monitoren können Sie nur die folgenden Felder aktualisieren:

    • Zeitraum
    • Anzeigename
    • Zeitüberschreitung
    • Nutzerlabels

Wenn Sie beispielsweise den Zeitraum eines synthetischen Monitors auf 10 Minuten festlegen möchten, führen Sie den folgenden Befehl aus:

gcloud monitoring uptime update CHECK_ID --period=10 --project=PROJECT_ID

REST

Benachrichtigungsrichtlinien und ‑funktionen sind nicht in einem synthetischen Monitor enthalten und können daher nicht mit der in diesem Abschnitt beschriebenen Vorgehensweise bearbeitet werden:

Rufen Sie die Methode projects.uptimeCheckConfigs.patch auf, um einen synthetischen Monitor zu bearbeiten:

  1. Klicken Sie auf projects.uptimeCheckConfigs.patch.

  2. API Explorer verwenden

    1. Legen Sie den Namen auf die ID des synthetischen Monitors fest. Die ID hat folgendes Format:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

      Im vorherigen Ausdruck gilt Folgendes:

      • PROJECT_ID ist die Projekt-ID. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
      • CHECK_ID ist die ID des synthetischen Monitors.

      Um den Wert von CHECK_ID zu ermitteln, können Sie die Methode projects.uptimeCheckConfigs.list ausführen. Wenn Sie die Anzahl der zurückgegebenen Ergebnisse reduzieren möchten, fügen Sie einen Filter hinzu. Fügen Sie beispielsweise den Filter displayName="MySyntheticMonitor" hinzu.

    2. Legen Sie den Abfrageparameter updateMask fest, um anzugeben, welche Felder im Objekt geändert werden. Wenn Sie beispielsweise den Wert von displayName aktualisieren möchten, sieht der Suchparameter so aus:

      updateMask=displayName

Synthetischen Monitor kopieren

Console

So kopieren Sie einen synthetischen Monitor in Ihrem Google Cloud -Projekt:

  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. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

  3. Suchen Sie den synthetischen Monitor, den Sie kopieren möchten, klicken Sie auf  Weitere Optionen und wählen Sie Kopieren aus.

    Das Dialogfeld Synthetische Prüfung kopieren wird geöffnet. Die Felder sind bereits ausgefüllt, einschließlich einer Kopie der Cloud Run-Funktion.

  4. Klicken Sie auf Funktion erstellen, aktualisieren Sie die Funktion nach Bedarf und klicken Sie dann auf Funktion anwenden.

  5. Klicken Sie auf Erstellen, um die Änderungen beizubehalten. Klicken Sie andernfalls auf Abbrechen.

    Wenn Sie auf Erstellen klicken, wird Ihre Cloud Run-Funktion erstellt und bereitgestellt und dann der synthetische Monitor erstellt.

gcloud

Es gibt keine Google Cloud CLI-Methode, mit der Sie einen synthetischen Monitor kopieren können.

REST

Es gibt keine API-Methode, mit der Sie einen synthetischen Monitor kopieren können. Sie können jedoch eine Kopie erstellen. Gehen Sie dazu so vor:

  1. Rufen Sie die Methode projects.uptimeCheckConfigs.get auf und speichern Sie die Antwort. Weitere Informationen finden Sie unter Details zu einem synthetischen Monitor ansehen.
  2. Bearbeiten Sie die Antwort.
  3. Rufen Sie die Methode projects.uptimeCheckConfigs.create auf und übergeben Sie die bearbeitete Antwort an die Methode.

Synthetischen Monitor löschen

Console

So löschen Sie einen synthetischen Monitor und alle zugehörigen Benachrichtigungsrichtlinien:

  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. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

  3. Suchen Sie nach dem synthetischen Monitor, den Sie löschen möchten, und klicken Sie dann auf den Namen.

  4. Optional: Wenn Sie die Cloud Run-Funktion löschen möchten, wählen Sie den Tab Code aus und klicken Sie dann auf den Namen der Funktion. Die Seite Funktionsdetails wird in einem neuen Fenster geöffnet.

  5. Klicken Sie auf der Seite Details zum synthetischen Monitor auf  Löschen und füllen Sie das Dialogfeld aus.

    Sie haben den synthetischen Monitor jetzt gelöscht.

  6. Wenn Sie die Cloud Run-Funktion löschen möchten, rufen Sie die Seite Funktionsdetails auf, klicken Sie auf  Löschen und schließen Sie das Dialogfeld ab.

gcloud

Führen Sie den Befehl gcloud monitoring uptime delete aus, um eine Verfügbarkeitsdiagnose oder einen synthetischen Monitor zu löschen:

gcloud monitoring uptime delete CHECK_ID --project=PROJECT_ID

Ersetzen Sie vor dem Ausführen des vorherigen Befehls Folgendes:

  • PROJECT_ID: Die Kennung des Projekts. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
  • CHECK_ID: Die Kennung der Verfügbarkeitsdiagnose oder des synthetischen Monitors. Sie können die Kennung mit dem Befehl gcloud monitoring uptime list-configs abrufen und das Feld name prüfen. Weitere Informationen finden Sie unter Eindeutige Kennung eines synthetischen Monitors ermitteln.

REST

Rufen Sie zum Löschen eines synthetischen Monitors die Methode projects.uptimeCheckConfigs.delete auf:

  1. Klicken Sie auf projects.uptimeCheckConfigs.delete.

  2. API Explorer verwenden

    Legen Sie den Namen auf die ID des synthetischen Monitors fest. Achten Sie darauf, dass Sie das folgende Format verwenden:

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    Im vorherigen Ausdruck gilt Folgendes:

    • PROJECT_ID ist die Projekt-ID. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.
    • CHECK_ID ist die ID des synthetischen Monitors.

    Um den Wert von CHECK_ID zu ermitteln, können Sie die Methode projects.uptimeCheckConfigs.list ausführen. Wenn Sie die Anzahl der zurückgegebenen Ergebnisse reduzieren möchten, fügen Sie einen Filter hinzu. Fügen Sie beispielsweise den Filter displayName="MySyntheticMonitor" hinzu.

Eindeutige Kennung eines synthetischen Monitors finden

Wenn Ihr synthetischer Monitor erstellt wird, weist Monitoring ihm eine Kennung zu. Diese Kennung ist im Ressourcennamen für den synthetischen Monitor eingebettet und hat das folgende Format:

projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

CHECK_ID ist in der Antwort der Google Cloud CLI- und Cloud Monitoring API-Methoden enthalten, mit denen synthetische Monitore erstellt oder aufgelistet werden.

Nächste Schritte