Questo documento descrive come gestire i monitoraggi sintetici. Puoi visualizzare un elenco dei tuoi monitor sintetici e, per ogni monitor sintetico, può visualizzare e modificare la configurazione, visualizzare la cronologia di esecuzione e visualizzare i dettagli di ogni esecuzione. Puoi gestire i monitoraggi sintetici utilizzando dalla console Google Cloud o utilizzando l'API Cloud Monitoring.
Per informazioni su come esplorare i risultati dell'esecuzione metriche e log per un monitoraggio sintetico, consulta Esplora i risultati del monitoraggio sintetico.
Prima di iniziare
-
Per ottenere le autorizzazioni necessarie per visualizzare e modificare i monitoraggi sintetici utilizzando la console Google Cloud, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:
-
Editor di Monitoring (
roles/monitoring.editor
) -
Sviluppatore Cloud Functions (
roles/cloudfunctions.developer
)
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.
-
Editor di Monitoring (
Le istruzioni API riportate in questa pagina sono relative a Explorer API. Tuttavia, puoi anche inviare un comando curl. L'Explorer API fornisce il metodo curl a riga di comando.
Elenca monitoraggi sintetici
Console
Per elencare i monitor sintetici nel tuo progetto Google Cloud, segui questi passaggi:
-
Nella console Google Cloud, vai alla Pagina Monitoraggio sintetico:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
(Facoltativo) Per limitare i monitoraggi sintetici elencati, aggiungi filtri.
Ogni filtro è composto da un nome e da un valore. Puoi impostare il valore in modo che corrisponda esattamente a un nome di monitor sintetico o una corrispondenza parziale. Le corrispondenze non sono sensibili alle maiuscole. Ad esempio, per elencare tutte monitor sintetici il cui nome contiene
default
, segui questi passaggi:- Fai clic su Filtra tabella e seleziona Nome visualizzato.
- Inserisci
default
e premi il tasto Invio.
Se hai più filtri, questi vengono uniti automaticamente da un
AND
logico, a meno che non inserisci un filtroOR
. L'esempio precedente utilizza il filtroOR
per consentire un controllo di uptime se il nome corrisponde adefault
oTesting check
.
La pagina Monitor sintetici mostra quanto segue per ogni monitoraggio sintetico:
- Stato dell'esecuzione più recente.
- Un link alle informazioni dettagliate sul monitoraggio sintetico.
- La percentuale di successo e il tempo medio di esecuzione.
- Il numero di criteri di avviso.
- Per modificare, copiare o eliminare il monitoraggio sintetico e creare un utilizza more_vert Menu Altre opzioni.
gcloud
Per elencare i controlli di uptime e i monitoraggi sintetici, esegui
gcloud monitoring uptime list-configs
:
gcloud monitoring uptime list-configs
I dati restituiti includono:
- Nome e nome visualizzato.
- Verifica l'identificatore.
- Risorsa monitorata.
- Periodo tra i controlli.
Puoi configurare il comando Google Cloud CLI per filtrare e ordinare i risultati.
API
Per elencare i monitoraggi sintetici nel tuo progetto Google Cloud, inclusi
i controlli di uptime, chiama
Metodo projects.uptimeCheckConfigs.list
:
- Fai clic su
projects.uptimeCheckConfigs.list
. Utilizzare Explorer API.
Imposta l'elemento parent del metodo sul nome del progetto e assicurati di utilizza il seguente formato:
projects/PROJECT_ID
Nell'espressione precedente,
PROJECT_ID
è il tuo ID progetto Google Cloud.
Per un monitoraggio sintetico, il risultato contiene un campo denominato syntheticMonitor
.
Visualizza i dettagli di un monitoraggio sintetico
Console
Per visualizzare i dettagli di un monitoraggio sintetico nel tuo progetto Google Cloud, segui questi passaggi:
-
Nella console Google Cloud, vai alla Pagina Monitoraggio sintetico:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Per aprire la pagina Dettagli monitor sintetico, individua l'icona monitor sintetico che vuoi visualizzare, quindi fai clic sul relativo nome.
Se vuoi visualizzare la Cloud Function dal Pagina Dettagli funzioni fornita da Cloud Functions, seleziona la scheda Codice e infine fai clic sul nome della funzione. Si apre la pagina Dettagli funzioni in una nuova finestra. Le schede di questa pagina ti consentono di visualizzare metriche e log, e configurazione.
gcloud
Per elencare i dettagli di un controllo di uptime o di un monitoraggio sintetico,
esegui gcloud monitoring uptime describe
:
gcloud monitoring uptime describe CHECK_ID
Prima di eseguire il comando precedente, sostituisci CHECK_ID con
l'identificatore del controllo di uptime o del monitoraggio sintetico. Puoi trovare
dell'identificatore eseguendo il comando gcloud monitoring uptime list-configs
esaminando il campo name. Per ulteriori informazioni, vedi
Trova l'identificatore univoco di un monitoraggio sintetico.
I dati restituiti per il controllo di uptime includono:
- Nome e nome visualizzato.
- Verifica l'identificatore.
- Risorsa monitorata.
- Periodo tra i controlli.
API
Per elencare i dettagli di un monitoraggio sintetico specifico nel tuo progetto Google Cloud,
chiama il
Metodo projects.uptimeCheckConfigs.get
:
- Fai clic su
projects.uptimeCheckConfigs.get
. Utilizzare Explorer API.
Imposta il campo parent del metodo sull'identificatore del monitoraggio sintetico, utilizza il formato seguente:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Nell'espressione precedente,
PROJECT_ID
è il tuo ID progetto Google Cloud eCHECK_ID
è l'ID monitoraggio sintetico.Ad esempio, il valore del campo principale potrebbe essere:
projects/my-project/uptimeCheckConfigs/10863117100295372627
Per trovare il valore dell'attributo CHECK_ID, puoi inviare il metodo
projects.uptimeCheckConfigs.list
. Per ridurre il numero di risultati restituiti, includi un filtro. Ad esempio, aggiungi il filtrodisplayName="MySyntheticMonitor"
.
Modifica un monitoraggio sintetico o una Cloud Function
Console
Per modificare un monitoraggio sintetico o la relativa Cloud Function utilizzando la pagina Dettagli monitor sintetico, segui questi passaggi:
-
Nella console Google Cloud, vai alla Pagina Monitoraggio sintetico:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Individua il monitor sintetico che vuoi modificare. fai clic su more_vert Altre opzioni, poi seleziona Modifica.
(Facoltativo) Per modificare la Cloud Function, fai clic su Modifica funzione. apporta le modifiche e poi fai clic su Applica funzione.
Per i controlli dei link inaccessibili, modificare l'URI di origine o le opzioni che definire quali link vengono testati, modificare la Cloud Function e quindi aggiorna l'oggetto
options
nel fileindex.js
. Per informazioni su campi e sintassi dell'oggetto, vedibroken-links-ok/index.js
Per mantenere le modifiche, fai clic su Salva. In caso contrario, fai clic su Annulla.
gcloud
Per modificare un controllo di uptime o un monitoraggio sintetico,
esegui gcloud monitoring uptime update
:
gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS
Prima di eseguire il comando precedente, segui questi passaggi:
Sostituisci CHECK_ID con l'identificatore del controllo di uptime oppure monitoraggio sintetico. Puoi trovare l'identificatore eseguendo il comando
gcloud monitoring uptime list-configs
e esaminando il campo name. Per ulteriori informazioni, vedi Individua l'identificatore univoco di un controllo di uptime.Definisci i campi da modificare. Per i monitoraggi sintetici, puoi: aggiorna solo i seguenti campi:
- Periodo
- Nome visualizzato
- Timeout
- Etichette utente
Ad esempio, per impostare un periodo di 10 minuti per il monitoraggio sintetico: esegui questo comando:
gcloud monitoring uptime update CHECK_ID --period=10
API
I criteri e le funzioni di avviso non sono contenuti in un monitoraggio sintetico e pertanto non possono essere modificate con la procedura descritta in questa sezione:
Per modificare un criterio di avviso, utilizza la console Google Cloud o chiama il metodo
alertPolicies.patch
. Per ulteriori informazioni, consulta Gestire i criteri di avviso in base all'API.Per modificare una Cloud Function, dopo aver aggiornato l'origine della funzione devi eseguire nuovamente il deployment della funzione. Per ulteriori informazioni, vedi Esegui il deployment di una funzione Cloud Functions.
Per modificare un monitoraggio sintetico, richiama il metodo
Metodo projects.uptimeCheckConfigs.patch
:
- Fai clic su
projects.uptimeCheckConfigs.patch
. Utilizzare Explorer API.
Imposta il campo parent del metodo sull'identificatore del monitoraggio sintetico, utilizza il formato seguente:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Nell'espressione precedente,
PROJECT_ID
è il tuo ID progetto Google Cloud eCHECK_ID
è l'ID monitoraggio sintetico.Per trovare il valore dell'attributo CHECK_ID, puoi inviare il metodo
projects.uptimeCheckConfigs.list
. Per ridurre il numero di risultati restituiti, includi un filtro. Ad esempio, aggiungi il filtrodisplayName="MySyntheticMonitor"
.Imposta il parametro di query del metodo, updateMask, per identificare dei campi dell'oggetto. Ad esempio, per aggiornare valore di
displayName
, il parametro di query sarà il seguente:updateMask=displayName
Copia un monitor sintetico
Console
Per copiare un monitoraggio sintetico nel tuo progetto Google Cloud, segui questi passaggi:
-
Nella console Google Cloud, vai alla Pagina Monitoraggio sintetico:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Individua il monitor sintetico che vuoi modificare. fai clic su more_vert Altre opzioni, quindi seleziona Copia.
Si apre la finestra di dialogo Copia controllo sintetico con campi precompilati. inclusa una copia della Cloud Function.
Fai clic su Crea funzione, aggiorna la funzione in base alle esigenze e poi fai clic su Applica funzione.
Per mantenere le modifiche, fai clic su Crea. In caso contrario, fai clic su Annulla.
Quando fai clic su Crea, viene creata la tua funzione Cloud Function di cui viene eseguito il deployment, quindi viene creato il monitoraggio sintetico.
gcloud
Non esiste un metodo Google Cloud CLI che ti consenta di copiare un monitoraggio sintetico.
API
Non esiste un metodo API che ti consenta di copiare un monitoraggio sintetico. Tuttavia, puoi crea una copia seguendo questa procedura:
- Chiama il metodo
projects.uptimeCheckConfigs.get
e salvare la risposta. Per ulteriori informazioni, vedi Visualizza i dettagli di un monitor sintetico. - Modifica la risposta.
- Chiama il
projects.uptimeCheckConfigs.create
e passare al metodo la risposta modificata.
Elimina un monitoraggio sintetico
Console
Per eliminare un monitoraggio sintetico e gli eventuali criteri di avviso associati, segui questi passaggi:
-
Nella console Google Cloud, vai alla Pagina Monitoraggio sintetico:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Individua il monitoraggio sintetico che vuoi eliminare e fai clic sul pulsante nome.
(Facoltativo) Se vuoi eliminare la Cloud Function, quindi seleziona la scheda Codice e fai clic sul nome della funzione. Si apre la pagina Dettagli funzioni in una nuova finestra.
Nella pagina Dettagli del monitoraggio sintetico, fai clic su
Elimina, quindi completa la finestra di dialogo.Ora hai eliminato il monitoraggio sintetico.
Per eliminare la Cloud Function, vai alla pagina Dettagli funzioni, fai clic su
Elimina, quindi completa la finestra di dialogo.
gcloud
Per eliminare un controllo di uptime o un monitoraggio sintetico,
esegui gcloud monitoring uptime delete
:
gcloud monitoring uptime delete CHECK_ID
Prima di eseguire il comando precedente, sostituisci CHECK_ID con
l'identificatore del controllo di uptime o del monitoraggio sintetico. Puoi trovare
dell'identificatore eseguendo il comando gcloud monitoring uptime list-configs
esaminando il campo name. Per ulteriori informazioni, vedi
Trova l'identificatore univoco di un monitoraggio sintetico.
API
Per eliminare un monitoraggio sintetico e i criteri di avviso associati, chiama il metodo
Metodo projects.uptimeCheckConfigs.delete
:
- Fai clic su
projects.uptimeCheckConfigs.delete
. Utilizzare Explorer API.
Imposta il campo parent del metodo sull'identificatore del monitoraggio sintetico, utilizza il formato seguente:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Nell'espressione precedente,
PROJECT_ID
è il tuo ID progetto Google Cloud eCHECK_ID
è l'ID monitoraggio sintetico.Per trovare il valore dell'attributo CHECK_ID, puoi inviare il metodo
projects.uptimeCheckConfigs.list
. Per ridurre il numero di risultati restituiti, includi un filtro. Ad esempio, aggiungi il filtrodisplayName="MySyntheticMonitor"
.
Trovare l'identificatore univoco di un monitoraggio sintetico
Quando viene creato il monitoraggio sintetico, Monitoring gli assegna un identificativo dell'utente. Questo identificatore è incorporato in il nome della risorsa per il monitoraggio sintetico e ha il formato:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
CHECK_ID è incluso nella risposta di Google Cloud CLI e i metodi dell'API Cloud Monitoring che creano o elencano i monitoraggi sintetici.