In diesem Dokument wird beschrieben, wie Sie Ihre synthetischen Monitore verwalten. Sie können eine Liste Ihrer synthetischen Monitore aufrufen und für jeden synthetischen Monitor die Konfiguration aufrufen und ändern, den Ausführungsverlauf aufrufen und Details zu jeder Ausführung aufrufen. Sie können Ihre synthetischen Monitore über die Google Cloud Konsole oder die Cloud Monitoring API verwalten.
Informationen dazu, wie Sie die Ausführungsergebnisse sowie die Messwerte und Logs für einen synthetischen Monitor ansehen, finden Sie unter Ergebnisse des synthetischen Monitors ansehen.
Diese Funktion wird nur für Google Cloud -Projekte unterstützt. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.
Hinweise
Führen Sie die folgenden Schritte im Google Cloud -Projekt aus, in dem sich Ihr synthetischer Monitor befindet:
-
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen und Ändern von synthetischen Monitoren über die Google Cloud Console benötigen:
-
Monitoring-Editor (
roles/monitoring.editor
) -
Cloud Functions Developer (
roles/cloudfunctions.developer
)
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.
-
Monitoring-Editor (
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 stellt die curl-Syntax zur Verfügung.
-
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
REST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, nutzen Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
gcloud init
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
Konsole
So rufen Sie eine Liste der synthetischen Monitore in Ihrem Google Cloud -Projekt auf:
-
Rufen Sie in der Google Cloud Console die Seite Synthetisches Monitoring auf:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- 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 des für Apps aktivierten Ordners aus.
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. Um beispielsweise alle synthetischen Monitore aufzulisten, 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 FilterOR
einfügen. Im vorherigen Beispiel wird der FilterOR
verwendet, sodass eine Verfügbarkeitsdiagnose aufgelistet wird, wenn der 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 Erfolgsrate und die durchschnittliche Ausführungszeit.
- Die Anzahl der Benachrichtigungsrichtlinien.
- Wenn Sie den synthetischen Monitor bearbeiten, kopieren oder löschen und eine Benachrichtigungsrichtlinie erstellen möchten, verwenden Sie das more_vert Dreipunkt-Menü.
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 des für Apps aktivierten Ordners aus.
Die zurückgegebenen Daten umfassen Folgendes:
- Name und Anzeigename
- ID prüfen.
- Überwachte Ressource.
- Zeitraum zwischen Prüfungen.
Sie können den Google Cloud CLI-Befehl so konfigurieren, dass die Ergebnisse gefiltert und sortiert werden.
REST
Rufen Sie die Methode
projects.uptimeCheckConfigs.list
auf, um die synthetischen Monitore in Ihrem Google Cloud -Projekt aufzulisten, einschließlich Verfügbarkeitsdiagnosen:- Klicken Sie auf
projects.uptimeCheckConfigs.list
. Verwenden Sie den APIs Explorer.
Legen Sie parent der Methode auf den Namen des Projekts fest und achten Sie darauf, dass Sie das folgende Format verwenden:
projects/PROJECT_ID
Im vorherigen Ausdruck ist
PROJECT_ID
die ID Ihres Projekts in Google Cloud . Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.
Bei einem synthetischen Monitor enthält das Ergebnis ein Feld mit dem Label
syntheticMonitor
.Details eines synthetischen Monitors ansehen
Konsole
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:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- 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 des für Apps aktivierten Ordners aus.
Suchen Sie nach dem synthetischen Monitor, den Sie ansehen möchten, und klicken Sie auf seinen Namen, um die Seite Details zum synthetischen Monitor zu öffnen.
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 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 --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 des für Apps aktivierten Ordners 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.
Die für die Betriebszeitprüfung zurückgegebenen Daten umfassen Folgendes:
- Name und Anzeigename
- ID prüfen.
- Überwachte Ressource.
- Zeitraum zwischen 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:- Klicken Sie auf
projects.uptimeCheckConfigs.get
. Verwenden Sie den APIs Explorer.
Legen Sie parent der Methode 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:
- PROJECT_ID ist die Projekt-ID Ihres Google Cloud . Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.
- CHECK_ID ist die ID des synthetischen Monitors.
Der Wert des übergeordneten Felds 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 FilterdisplayName="MySyntheticMonitor"
hinzu.
Synthetischen Monitor oder Cloud Run-Funktion bearbeiten
Konsole
So bearbeiten Sie einen synthetischen Monitor oder seine Cloud Run-Funktion über die Seite Details zum synthetischen Monitor:
-
Rufen Sie in der Google Cloud Console die Seite Synthetisches Monitoring auf:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- 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 des für Apps aktivierten Ordners aus.
- Suchen Sie nach dem synthetischen Monitor, den Sie bearbeiten möchten, klicken Sie auf more_vert Weitere Optionen und wählen Sie dann Bearbeiten aus.
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 definiert wird, welche Links getestet werden, bearbeiten Sie die Cloud Run-Funktion und aktualisieren Sie dann das
options
-Objekt in derindex.js
-Datei. Informationen zu den Feldern und der Syntax für dieses Objekt finden Sie unterbroken-links-ok/index.js
.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 eine Verfügbarkeitsdiagnose 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 des für Apps aktivierten Ordners aus.
CHECK_ID: Die Kennung der Verfügbarkeitsdiagnose oder des synthetischen Monitors. Sie können die Kennung ermitteln, indem Sie den Befehl
gcloud monitoring uptime list-configs
ausführen und das Feld name untersuchen. Weitere Informationen finden Sie unter Eindeutige Kennzeichnung einer Verfügbarkeitsdiagnose ermitteln.Geben Sie an, 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 --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:
Ändern Sie eine Benachrichtigungsrichtlinie in der Google Cloud -Konsole oder rufen Sie die Methode
alertPolicies.patch
auf. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien über API verwalten.Wenn Sie eine Cloud Run-Funktion ändern möchten, müssen Sie die Funktion neu bereitstellen, nachdem Sie die Funktionsquelle aktualisiert haben. Weitere Informationen finden Sie unter Cloud Run-Funktion bereitstellen.
Rufen Sie zum Bearbeiten eines synthetischen Monitors die Methode
projects.uptimeCheckConfigs.patch
auf:- Klicken Sie auf
projects.uptimeCheckConfigs.patch
. Verwenden Sie den APIs Explorer.
Legen Sie parent der Methode auf die ID des synthetischen Monitors fest. Die ID hat das folgende Format:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Im vorherigen Ausdruck gilt:
- PROJECT_ID ist die Projekt-ID. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners 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 FilterdisplayName="MySyntheticMonitor"
hinzu.Legen Sie den Abfrageparameter updateMask der Methode fest, um anzugeben, welche Felder im Objekt geändert werden. Wenn Sie beispielsweise den Wert des Abfrageparameters
displayName
aktualisieren möchten, gehen Sie so vor:updateMask=displayName
Synthetischen Monitor kopieren
Konsole
So kopieren Sie einen synthetischen Monitor in Ihrem Google Cloud -Projekt:
-
Rufen Sie in der Google Cloud Console die Seite Synthetisches Monitoring auf:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- 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 des für Apps aktivierten Ordners aus.
Suchen Sie nach dem 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 mit vorausgefüllten Feldern geöffnet, einschließlich einer Kopie der Cloud Run-Funktion.
Klicken Sie auf Funktion erstellen, aktualisieren Sie die Funktion nach Bedarf und klicken Sie dann auf Funktion anwenden.
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, indem Sie so vorgehen:
- Rufen Sie die Methode
projects.uptimeCheckConfigs.get
auf und speichern Sie die Antwort. Weitere Informationen finden Sie unter Details eines synthetischen Monitors 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
Konsole
So löschen Sie einen synthetischen Monitor und alle zugehörigen Benachrichtigungsrichtlinien:
-
Rufen Sie in der Google Cloud Console die Seite Synthetisches Monitoring auf:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- 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 des für Apps aktivierten Ordners aus.
Suchen Sie den synthetischen Monitor, den Sie löschen möchten, und klicken Sie dann auf den Namen.
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.
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.
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 des für Apps aktivierten Ordners 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.
REST
Wenn Sie einen synthetischen Monitor und die zugehörigen Benachrichtigungsrichtlinien löschen möchten, rufen Sie die Methode
projects.uptimeCheckConfigs.delete
auf:- Klicken Sie auf
projects.uptimeCheckConfigs.delete
. Verwenden Sie den APIs Explorer.
Legen Sie parent der Methode 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:
- PROJECT_ID ist die Projekt-ID. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners 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 FilterdisplayName="MySyntheticMonitor"
hinzu.
Eindeutige ID eines synthetischen Monitors ermitteln
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
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-09-04 (UTC).
-