In diesem Dokument wird beschrieben, wie Sie synthetische Monitore verwalten. Sie können Ihre synthetischen Monitore an. Für jeden synthetischen Monitor kann die Konfiguration aufrufen und ändern, den Ausführungsverlauf ansehen und Details zu jeder Ausführung. Sie können Ihre synthetischen Monitore mit der in der Google Cloud Console oder mithilfe der Cloud Monitoring API.
Informationen zum Prüfen der Ausführungsergebnisse und der Messwerte und Logs für einen synthetischen Monitor, siehe Ergebnisse des synthetischen Monitorings untersuchen
Hinweise
-
So erhalten Sie die Berechtigungen, die Sie zum Aufrufen und Ändern synthetischer Monitore mithilfe der Google Cloud Console benötigen: bitten Sie Ihren Administrator, Ihnen folgende IAM-Rollen für Ihr Projekt:
-
Monitoring-Bearbeiter (
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-Bearbeiter (
Die API-Anleitungen auf dieser Seite gelten für APIs Explorer. Sie können jedoch können Sie auch einen "curl"-Befehl ausführen. APIs Explorer stellt die curl- Syntax.
Synthetisches Monitoring auflisten
Console
So rufen Sie die synthetischen Monitore in Ihrem Google Cloud-Projekt auf:
-
Wechseln Sie in der Google Cloud Console zur Seite Synthetisches Monitoring:
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 festlegen, dass der Wert genau mit dem Namen eines synthetischen Monitors übereinstimmt oder eine teilweise Übereinstimmung. Bei Übereinstimmungen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Um beispielsweise alle wenn synthetische Monitore erstellt werden, 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 aufgeführt, wenn der Name mitdefault
oderTesting 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.
- So bearbeiten, kopieren oder löschen Sie den synthetischen Monitor und erstellen einen Benachrichtigungsrichtlinie, verwenden Sie die more_vert Menü Weitere Optionen.
gcloud
Führen Sie den folgenden Befehl aus, um eine Liste Ihrer Verfügbarkeitsdiagnosen und synthetischen Monitore zu erstellen:
gcloud monitoring uptime list-configs
Befehl:
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
Zum Auflisten der synthetischen Monitore in Ihrem Google Cloud-Projekt, einschließlich
Verfügbarkeitsdiagnosen, rufen Sie die
projects.uptimeCheckConfigs.list
-Methode:
- Klicken Sie auf
projects.uptimeCheckConfigs.list
. APIs Explorer verwenden
Legen Sie für das parent-Element der Methode den Namen des Projekts fest. verwenden Sie 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 der Bezeichnung syntheticMonitor
.
Details zu einem synthetischen Monitor ansehen
Console
So rufen Sie die Details eines synthetischen Monitors in Ihrem Google Cloud-Projekt auf:
-
Wechseln Sie in der Google Cloud Console zur Seite Synthetisches Monitoring:
Zur Seite Synthetisches Monitoring
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
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 aufrufen möchten, wählen Sie den Tab Code aus und klicken Sie dann auf den Namen der Funktion. Die Seite Funktionsdetails wird geöffnet. in einem neuen Fenster öffnen. 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 Details zu einer Verfügbarkeitsdiagnose oder einem synthetischen Monitor aufzulisten:
gcloud monitoring uptime describe CHECK_ID
Bevor Sie den vorherigen Befehl ausführen, ersetzen Sie CHECK_ID durch
Die Kennung der Verfügbarkeitsdiagnose oder des synthetischen Monitors. Sie finden die
ID mit dem Befehl gcloud monitoring uptime list-configs
und
untersuchen wir das Feld name. 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
So listen Sie die Details eines bestimmten synthetischen Monitors in Ihrem Google Cloud-Projekt auf:
ruf die
projects.uptimeCheckConfigs.get
-Methode:
- 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 das folgende Format:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Im vorherigen Ausdruck ist
PROJECT_ID
Ihre Google Cloud-Projekt-ID. undCHECK_ID
ist die synthetische Monitor-ID.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 den
projects.uptimeCheckConfigs.list
-Methode. 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 Run-Funktion bearbeiten
Console
So bearbeiten Sie einen synthetischen Monitor oder seine Cloud Run-Funktion, indem Sie Führen Sie auf der Seite Details zum synthetischen Monitor folgende Schritte aus:
-
Wechseln Sie in der Google Cloud Console zur Seite Synthetisches Monitoring:
Gehen Sie zu 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 Run-Funktion auf Funktion bearbeiten. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Funktion anwenden.
Um bei der Prüfung fehlerhafter Links den Ursprungs-URI oder die Optionen zu ändern, definieren, welche Verknüpfungen getestet werden, bearbeiten die Cloud Run-Funktion und Aktualisieren Sie 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. Andernfalls klicken Sie 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 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 ermittelnLegen Sie fest, welche Felder Sie ändern möchten. Für synthetisches Monitoring können Sie Folgendes tun: nur die folgenden Felder aktualisieren:
- Zeitraum
- Anzeigename
- Zeitlimit
- Nutzerlabels
Um beispielsweise den Zeitraum eines synthetischen Monitors auf 10 Minuten festzulegen, 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. daher können sie nicht wie in diesem Abschnitt beschrieben bearbeitet werden:
Verwenden Sie zum Ändern einer Benachrichtigungsrichtlinie die Google Cloud Console oder rufen Sie die Methode
alertPolicies.patch
-Methode. Weitere Informationen Siehe Benachrichtigungsrichtlinien nach API verwalten.So ändern Sie eine Cloud Run-Funktion, nachdem Sie die Funktionsquelle aktualisiert haben müssen Sie die Funktion noch einmal bereitstellen. Weitere Informationen finden Sie unter Cloud Run-Funktion bereitstellen
Rufen Sie zum Bearbeiten eines synthetischen Monitors die Methode
projects.uptimeCheckConfigs.patch
-Methode:
- 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 das folgende Format:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Im vorherigen Ausdruck ist
PROJECT_ID
Ihre Google Cloud-Projekt-ID. undCHECK_ID
ist die synthetische Monitor-ID.Um den Wert von CHECK_ID zu ermitteln, können Sie den
projects.uptimeCheckConfigs.list
-Methode. Verwenden Sie einen Filter, um die Anzahl der zurückgegebenen Ergebnisse zu reduzieren. Fügen Sie beispielsweise den FilterdisplayName="MySyntheticMonitor"
hinzu.Legen Sie mit dem Abfrageparameter updateMask der Methode fest, welche -Felder im Objekt werden geändert. Um beispielsweise die
displayName
lautet, dann lautet der Abfrageparameter:updateMask=displayName
Synthetischen Monitor kopieren
Console
So kopieren Sie einen synthetischen Monitor in Ihr Google Cloud-Projekt:
-
Wechseln Sie in der Google Cloud Console zur Seite Synthetisches Monitoring:
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 sind bereits ausgefüllt. einschließlich einer Kopie der Cloud Run-Funktion.
Klicken Sie auf Funktion erstellen, aktualisieren Sie die Funktion nach Bedarf und Klicken Sie 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 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 So erstellen Sie eine Kopie:
- 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 ihr die bearbeitete Antwort.
Synthetischen Monitor löschen
Console
So löschen Sie einen synthetischen Monitor und alle zugehörigen Benachrichtigungsrichtlinien: Gehen Sie so vor:
-
Wechseln Sie in der Google Cloud Console zur Seite Synthetisches Monitoring:
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 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.
Gehen Sie auf der Seite Details zum synthetischen Monitor so vor: Klicken Sie 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 Run-Funktion die Seite Funktionsdetails auf. Klicken Sie auf
Löschen und füllen Sie das Dialogfeld aus.
gcloud
So löschen Sie eine Verfügbarkeitsdiagnose oder
einen synthetischen Monitor:
gcloud monitoring uptime delete
ausführen
Befehl:
gcloud monitoring uptime delete CHECK_ID
Bevor Sie den vorherigen Befehl ausführen, ersetzen Sie CHECK_ID durch
Die Kennung der Verfügbarkeitsdiagnose oder des synthetischen Monitors. Sie finden die
ID mit dem Befehl gcloud monitoring uptime list-configs
und
untersuchen wir das Feld name. Weitere Informationen finden Sie unter
Eindeutige ID eines synthetischen Monitors ermitteln
API
Rufen Sie zum Löschen eines synthetischen Monitors und der zugehörigen Benachrichtigungsrichtlinien die Methode
projects.uptimeCheckConfigs.delete
-Methode:
- 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 das folgende Format:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Im vorherigen Ausdruck ist
PROJECT_ID
Ihre Google Cloud-Projekt-ID. undCHECK_ID
ist die synthetische Monitor-ID.Um den Wert von CHECK_ID zu ermitteln, können Sie die Methode
projects.uptimeCheckConfigs.list
verwenden. 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
Beim Erstellen des synthetischen Monitors wird ihm von Monitoring ein Kennung. Diese Kennung ist in Ressourcenname für den synthetischen Monitor und hat folgendes Format:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Die CHECK_ID ist in der Antwort der Google Cloud CLI und der Cloud Monitoring API-Methoden enthalten, mit denen synthetische Monitore erstellt oder aufgelistet werden.