Synthetische Monitore verwalten

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:

   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. Optional: Fügen Sie Filter hinzu, um die aufgeführten synthetischen Monitore einzuschränken.

   Jeder Filter besteht aus einem Namen und einem Wert. Sie können den Wert so einstellen, dass er genau mit dem Namen eines synthetischen Monitors oder einer Teilübereinstimmung übereinstimmt. Bei Übereinstimmungen wird nicht zwischen Groß- und Kleinschreibung unterschieden. So listen Sie beispielsweise alle synthetischen Monitore auf, deren Name default enthält:

   • 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. Im vorherigen Beispiel wird der Filter OR verwendet, sodass eine Verfügbarkeitsdiagnose aufgelistet wird, wenn der Name mit default oder Testing check übereinstimmt.

Auf der Seite Synthetische Monitore werden für jeden synthetischen Monitor die folgenden Informationen angezeigt:

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

gcloud

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

gcloud monitoring uptime list-configs

Die zurückgegebenen Daten umfassen Folgendes:

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

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

API

Rufen Sie die Methode projects.uptimeCheckConfigs.list auf, um die synthetischen Monitore in Ihrem Google Cloud-Projekt aufzulisten, einschließlich der Uptime-Prüfungen:

1. Klicken Sie auf projects.uptimeCheckConfigs.list.

2. Verwenden Sie den APIs Explorer.

   Legen Sie für parent der Methode den Namen des Projekts fest. Verwenden Sie dabei das folgende Format:

   projects/PROJECT_ID
   

   Im vorherigen Ausdruck ist PROJECT_ID die Google Cloud-Projekt-ID.

Bei einem synthetischen Monitor enthält das Ergebnis ein Feld mit der Bezeichnung syntheticMonitor.

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:

   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.

   Wenn Sie Ihre Cloud Run-Funktion auf der Seite Funktionsdetails aufrufen möchten, die von Cloud Run Functions bereitgestellt wird, wählen Sie den Tab Code aus und klicken Sie 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, Protokolle und Konfigurationsinformationen aufrufen.

gcloud

Führen Sie den Befehl gcloud monitoring uptime describe aus, um die Details einer Verfügbarkeitsdiagnose oder eines synthetischen Monitors aufzulisten:

gcloud monitoring uptime describe CHECK_ID

Ersetzen Sie vor der Ausführung des Befehls CHECK_ID durch 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 prüfen. Weitere Informationen finden Sie unter Eindeutige Kennung eines synthetischen Monitors ermitteln.

Die für die Betriebszeitprüfung zurückgegebenen Daten umfassen Folgendes:

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

API

Rufen Sie die Methode projects.uptimeCheckConfigs.get auf, um die Details eines bestimmten synthetischen Monitors in Ihrem Google Cloud-Projekt aufzulisten:

1. Klicken Sie auf projects.uptimeCheckConfigs.get.

2. Verwenden Sie den APIs Explorer.

   Legen Sie als parent der Methode die Kennung des synthetischen Monitors fest. Verwenden Sie dabei das folgende Format:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Im vorherigen Ausdruck ist PROJECT_ID Ihre Google Cloud-Projekt-ID und CHECK_ID die ID des synthetischen Monitors.

   Der Wert des übergeordneten Felds könnte beispielsweise so lauten:

   projects/my-project/uptimeCheckConfigs/10863117100295372627
   

   Um den Wert von CHECK_ID zu ermitteln, können Sie die Methode projects.uptimeCheckConfigs.list verwenden. 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.

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:

   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. Suchen Sie den synthetischen Monitor, den Sie bearbeiten möchten, klicken Sie auf more_vert Weitere Optionen und wählen Sie dann Bearbeiten aus.

3. 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 den Ursprungs-URI oder die Optionen ändern möchten, mit denen festgelegt wird, welche Links geprüft werden, bearbeiten Sie die Cloud Run-Funktion und aktualisieren Sie dann das options-Objekt in der index.js-Datei. Informationen zu den Feldern und zur Syntax dieses Objekts finden Sie unter broken-links-ok/index.js.

4. Klicken Sie auf Speichern, um Ihre Änderungen zu speichern. Klicken Sie andernfalls auf Abbrechen.

gcloud

Führen Sie den Befehl gcloud monitoring uptime update aus, um eine Verfügbarkeitsdiagnose oder einen synthetischen Monitor zu ändern:

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS

Führen Sie vor dem Ausführen des vorherigen Befehls die folgenden Schritte aus:

• Ersetzen Sie CHECK_ID durch die Kennung der Uptime-Prüfung oder des synthetischen Monitors. Sie finden die Kennung, indem Sie den Befehl gcloud monitoring uptime list-configs ausführen und das Feld name prüfen. Weitere Informationen finden Sie unter Eindeutige Kennung einer Verfügbarkeitsdiagnose ermitteln.

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

  • Zeitraum
  • Anzeigename
  • Zeitlimit
  • 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

API

Richtlinien und Funktionen für Benachrichtigungen sind nicht in einem synthetischen Monitor enthalten und können daher nicht mit dem in diesem Abschnitt beschriebenen Verfahren bearbeitet werden:

• Verwenden Sie die Google Cloud Console oder rufen Sie die Methode alertPolicies.patch auf, um eine Benachrichtigungsrichtlinie zu ändern. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien über API verwalten.

• Wenn Sie eine Cloud Run-Funktion ändern möchten, müssen Sie sie nach dem Aktualisieren der Funktionsquelle noch einmal bereitstellen. Weitere Informationen finden Sie unter Cloud Run-Funktion bereitstellen.

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

1. Klicken Sie auf projects.uptimeCheckConfigs.patch.

2. Verwenden Sie den APIs Explorer.

   1. Legen Sie als parent der Methode die Kennung des synthetischen Monitors fest. Verwenden Sie dabei das folgende Format:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
      

      Im vorherigen Ausdruck ist PROJECT_ID Ihre Google Cloud-Projekt-ID und CHECK_ID die ID des synthetischen Monitors.

      Um den Wert von CHECK_ID zu ermitteln, können Sie die Methode projects.uptimeCheckConfigs.list verwenden. 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 der Methode updateMask fest, um anzugeben, welche Felder im Objekt geändert werden. Wenn Sie beispielsweise den Wert des displayName-Abfrageparameters aktualisieren möchten, lautet er so:

      updateMask=displayName
      

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:

   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. Suchen Sie den synthetischen Monitor, den Sie bearbeiten möchten, klicken Sie auf more_vert Mehr Optionen und wählen Sie dann Kopieren aus.

   Das Dialogfeld Synthetische Prüfung kopieren wird mit vorausgefüllten Feldern geöffnet, darunter eine Kopie der Cloud Run-Funktion.

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

4. Klicken Sie auf Erstellen, um Ihre Änderungen zu speichern. Klicken Sie andernfalls auf Abbrechen.

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

gcloud

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

API

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 aufrufen.
2. Bearbeiten Sie die Antwort.
3. Rufen Sie die Methode projects.uptimeCheckConfigs.create auf und übergeben Sie ihr die bearbeitete Antwort.

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:

   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. Suchen Sie den synthetischen Monitor, den Sie löschen möchten, und klicken Sie auf den Namen.

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

4. Klicken Sie auf der Seite Details zum synthetischen Monitor auf delete Löschen und schließen Sie das Dialogfeld ab.

   Sie haben den synthetischen Monitor jetzt gelöscht.

5. Wenn Sie die Cloud Run-Funktion löschen möchten, rufen Sie die Seite Funktionsdetails auf, klicken Sie auf delete 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

Ersetzen Sie vor der Ausführung des Befehls CHECK_ID durch 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 prüfen. Weitere Informationen finden Sie unter Eindeutige Kennung eines synthetischen Monitors ermitteln.

API

Wenn Sie einen synthetischen Monitor und die zugehörigen Benachrichtigungsrichtlinien löschen möchten, rufen Sie die Methode projects.uptimeCheckConfigs.delete auf:

1. Klicken Sie auf projects.uptimeCheckConfigs.delete.

2. Verwenden Sie den APIs Explorer.

   Legen Sie als parent der Methode die Kennung des synthetischen Monitors fest. Verwenden Sie dabei das folgende Format:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Im vorherigen Ausdruck ist PROJECT_ID Ihre Google Cloud-Projekt-ID und CHECK_ID die ID des synthetischen Monitors.

   Um den Wert von CHECK_ID zu ermitteln, können Sie die Methode projects.uptimeCheckConfigs.list verwenden. 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.