In diesem Dokument wird beschrieben, wie Sie synthetische Monitore verwalten. Sie können eine Liste Ihrer synthetischen Monitore aufrufen. Für jeden synthetischen Monitor können Sie die Konfiguration sowie den Ausführungsverlauf und Details zu jeder Ausführung ansehen und ändern. Sie können Ihre synthetischen Monitore mit der Google Cloud Console oder der Cloud Monitoring API verwalten.
Informationen zum Untersuchen der Ausführungsergebnisse, der Messwerte und Logs für einen synthetischen Monitor finden Sie unter Ergebnisse des synthetischen Monitors untersuchen.
Hinweise
-
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Aufrufen und Ändern synthetischer Monitore über die Google Cloud Console benötigen:
-
Monitoring-Bearbeiter (
roles/monitoring.editor
) -
Cloud Functions Developer (
roles/cloudfunctions.developer
)
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.
-
Monitoring-Bearbeiter (
Die API-Anleitungen auf dieser Seite gelten für APIs Explorer. Sie können jedoch auch einen curl-Befehl ausführen. APIs Explorer stellt die curl-Syntax bereit.
Synthetisches Monitoring auflisten
Console
So listen Sie die synthetischen Monitore in Ihrem Google Cloud-Projekt auf:
-
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.
Optional: Fügen Sie Filter hinzu, um einzuschränken, welche synthetischen Monitore aufgeführt werden.
Jeder Filter besteht aus einem Namen und einem Wert. Sie können den Wert so festlegen, dass er genau mit dem Namen eines synthetischen Monitors oder einer teilweisen Ü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 FilterOR
einfügen. Im vorherigen Beispiel wird der FilterOR
verwendet, damit eine Verfügbarkeitsdiagnose aufgelistet wird, wenn ihr Name mitdefault
oderTesting check
übereinstimmt.
Auf der Seite Synthetisches Monitoring wird für jeden synthetischen Monitor Folgendes 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.
- Verwenden Sie das Menü more_vert Weitere Optionen, um den synthetischen Monitor zu bearbeiten, zu kopieren oder zu löschen und eine Benachrichtigungsrichtlinie zu 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 zum Filtern und Sortieren der Ergebnisse konfigurieren.
API
Rufen Sie die Methode projects.uptimeCheckConfigs.list
auf, um das synthetische Monitoring einschließlich Verfügbarkeitsdiagnosen in Ihrem Google Cloud-Projekt aufzulisten:
- Klicken Sie auf
projects.uptimeCheckConfigs.list
. APIs Explorer verwenden
Legen Sie für die parent-Methode den Namen des Projekts fest. Verwenden Sie dabei das folgende Format:
projects/PROJECT_ID
Im vorherigen Ausdruck ist
PROJECT_ID
Ihre Google Cloud-Projekt-ID.
Bei einem synthetischen Monitor enthält das Ergebnis ein Feld mit dem Namen syntheticMonitor
.
Details zu einem synthetischen Monitor ansehen
Console
So rufen Sie die Details eines synthetischen Monitors in Ihrem Google Cloud-Projekt auf:
-
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.
Suchen Sie den gewünschten synthetischen Monitor und klicken Sie auf seinen Namen, um die Seite Details zum synthetischen Monitor zu öffnen.
Wenn Sie Ihre Cloud Function über die von Cloud Functions bereitgestellte Seite Funktionsdetails 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 dieser Seite können Sie Messwerte und Logs sowie Konfigurationsinformationen ansehen.
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
Bevor Sie den vorherigen Befehl ausführen, ersetzen Sie CHECK_ID durch die ID der Verfügbarkeitsdiagnose oder des synthetischen Monitors. Um die Kennung zu ermitteln, führen Sie den Befehl gcloud monitoring uptime list-configs
aus und sehen Sie sich das Feld name an. 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 Prüfungen.
API
Wenn Sie die Details eines bestimmten synthetischen Monitors in Ihrem Google Cloud-Projekt auflisten möchten, rufen Sie die Methode projects.uptimeCheckConfigs.get
auf:
- Klicken Sie auf
projects.uptimeCheckConfigs.get
. APIs Explorer verwenden
Legen Sie für das parent-Element der Methode die ID 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 undCHECK_ID
die synthetische Monitor-ID.Der Wert des übergeordneten Feldes könnte beispielsweise so aussehen:
projects/my-project/uptimeCheckConfigs/10863117100295372627
Mit der Methode
projects.uptimeCheckConfigs.list
können Sie den Wert von CHECK_ID ermitteln. Verwenden Sie einen Filter, um die Anzahl der zurückgegebenen Ergebnisse zu reduzieren. Fügen Sie beispielsweise den FilterdisplayName="MySyntheticMonitor"
hinzu.
Synthetischen Monitor oder Cloud Functions-Funktion bearbeiten
Console
So bearbeiten Sie einen synthetischen Monitor oder seine Cloud Functions-Funktion über die Seite Details zum synthetischen Monitor:
-
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.
- Suchen Sie den synthetischen Monitor, den Sie bearbeiten möchten, klicken Sie auf more_vert Weitere Optionen und wählen Sie Bearbeiten aus.
Optional: Klicken Sie zum Bearbeiten der Cloud Functions-Funktion auf Funktion bearbeiten, nehmen Sie die gewünschten Änderungen vor und klicken Sie dann auf Funktion anwenden.
Wenn Sie bei der Prüfung fehlerhafter Links den Ursprungs-URI oder die Optionen ändern möchten, die definieren, welche Links getestet werden, bearbeiten Sie die Cloud Functions-Funktion und aktualisieren Sie dann das
options
-Objekt in der Dateiindex.js
. Informationen zu den Feldern und zur Syntax dieses Objekts finden Sie unterbroken-links-ok/index.js
.Klicken Sie auf Speichern, um Ihre Änderungen beizubehalten. 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 die folgenden Schritte aus, bevor Sie den vorherigen Befehl ausführen:
Ersetzen Sie CHECK_ID durch die ID 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 einer Verfügbarkeitsdiagnose finden.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
Benachrichtigungsrichtlinien und -funktionen sind nicht in einem synthetischen Monitor enthalten und können daher nicht mit dem in diesem Abschnitt beschriebenen Verfahren bearbeitet werden:
Verwenden Sie zum Ändern einer Benachrichtigungsrichtlinie die Google Cloud Console oder rufen Sie die Methode
alertPolicies.patch
auf. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien nach API verwalten.Wenn Sie eine Cloud Functions-Funktion ändern möchten, müssen Sie die Funktion nach dem Aktualisieren der Funktionsquelle noch einmal bereitstellen. Weitere Informationen finden Sie unter Cloud Functions-Funktion bereitstellen.
Rufen Sie zum Bearbeiten eines synthetischen Monitors die Methode projects.uptimeCheckConfigs.patch
auf:
- Klicken Sie auf
projects.uptimeCheckConfigs.patch
. APIs Explorer verwenden
Legen Sie für das parent-Element der Methode die ID 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 undCHECK_ID
die synthetische Monitor-ID.Mit der Methode
projects.uptimeCheckConfigs.list
können Sie den Wert von CHECK_ID ermitteln. Verwenden Sie einen Filter, um die Anzahl der zurückgegebenen Ergebnisse zu reduzieren. Fügen Sie beispielsweise den FilterdisplayName="MySyntheticMonitor"
hinzu.Legen Sie den Abfrageparameter updateMask der Methode fest, um anzugeben, welche Felder im Objekt geändert werden. Um beispielsweise den Wert von
displayName
zu aktualisieren, lautet der Abfrageparameter:updateMask=displayName
Synthetischen Monitor kopieren
Console
So kopieren Sie einen synthetischen Monitor in Ihr Google Cloud-Projekt:
-
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.
Suchen Sie den synthetischen Monitor, den Sie bearbeiten möchten, klicken Sie auf more_vert Weitere Optionen und wählen Sie Kopieren aus.
Das Dialogfeld Synthetische Prüfung kopieren wird geöffnet. Die Felder, einschließlich einer Kopie der Cloud Functions-Funktion, sind bereits ausgefüllt.
Klicken Sie auf Funktion erstellen, aktualisieren Sie die Funktion nach Bedarf und klicken Sie dann auf Funktion anwenden.
Wenn Sie Ihre Änderungen beibehalten möchten, klicken Sie auf Erstellen. Klicken Sie andernfalls auf Abbrechen.
Wenn Sie auf Erstellen klicken, wird die Cloud Functions-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, indem Sie die folgenden Schritte ausführen:
- Rufen Sie die Methode
projects.uptimeCheckConfigs.get
auf und speichern Sie die Antwort. Weitere Informationen finden Sie unter Details zu einem synthetischen Monitor ansehen. - Bearbeiten Sie die Antwort.
- 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:
-
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.
Suchen Sie den synthetischen Monitor, den Sie löschen möchten, und klicken Sie auf den Namen.
Optional: Wenn Sie die Cloud Functions-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.
Klicken Sie auf der Seite Details zum synthetischen Monitor auf
Löschen und füllen Sie das Dialogfeld aus.Sie haben jetzt den synthetischen Monitor gelöscht.
Rufen Sie zum Löschen der Cloud Functions-Funktion die Seite Funktionsdetails auf, klicken Sie auf
Löschen und füllen Sie das Dialogfeld aus.
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
Bevor Sie den vorherigen Befehl ausführen, ersetzen Sie CHECK_ID durch die ID der Verfügbarkeitsdiagnose oder des synthetischen Monitors. Um die Kennung zu ermitteln, führen Sie den Befehl gcloud monitoring uptime list-configs
aus und sehen Sie sich das Feld name an. Weitere Informationen finden Sie unter Eindeutige Kennung eines synthetischen Monitors ermitteln.
API
Rufen Sie die Methode projects.uptimeCheckConfigs.delete
auf, um einen synthetischen Monitor und die zugehörigen Benachrichtigungsrichtlinien zu löschen:
- Klicken Sie auf
projects.uptimeCheckConfigs.delete
. APIs Explorer verwenden
Legen Sie für das parent-Element der Methode die ID 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 undCHECK_ID
die synthetische Monitor-ID.Mit der Methode
projects.uptimeCheckConfigs.list
können Sie den Wert von CHECK_ID ermitteln. Verwenden Sie einen Filter, um die Anzahl der zurückgegebenen Ergebnisse zu reduzieren. Fügen Sie beispielsweise den FilterdisplayName="MySyntheticMonitor"
hinzu.
Eindeutige Kennung eines synthetischen Monitors ermitteln
Wenn Ihr synthetischer Monitor erstellt wird, weist Monitoring ihm eine Kennung zu. Diese Kennung ist in den Ressourcennamen für den synthetischen Monitor eingebettet und hat folgende Form:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
CHECK_ID ist in der Antwort der Google Cloud CLI- und Cloud Monitoring API-Methoden enthalten, die synthetische Monitore erstellen oder auflisten.