Gestisci monitoraggi sintetici

Questo documento descrive come gestire i monitoraggi sintetici. Puoi visualizzare un elenco dei tuoi monitoraggi sintetici e, per ogni monitoraggio sintetico, puoi 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 di esecuzione, le metriche e i log di un monitoraggio sintetico, consulta Esplorare i risultati del monitoraggio sintetico.

Prima di iniziare

• Per ottenere le autorizzazioni necessarie per visualizzare e modificare i monitor sintetici utilizzando la console Google Cloud, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto:

  • Editor di monitoraggio (roles/monitoring.editor)
  • Sviluppatore Cloud Functions (roles/cloudfunctions.developer)

  Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

  Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

• 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 i monitoraggi sintetici

Console

Per elencare i monitor sintetici nel tuo progetto Google Cloud:

1. Nella console Google Cloud, vai alla pagina  Monitoraggio sintetico:

   Vai a Monitoraggio sintetico

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. (Facoltativo) Per limitare i monitor sintetici elencati, aggiungi filtri.

   Ogni filtro è composto da un nome e 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 filtro OR. L'esempio precedente utilizza il filtro OR in modo che un controllo dell'uptime venga elencato se il nome corrisponde a default o Testing check.

La pagina Monitor sintetici mostra quanto segue per ogni monitoraggio sintetico:

• Stato dell'esecuzione più recente.
• Un link a 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 criterio di avviso, utilizza il menu Altre opzioni.

gcloud

Per elencare i controlli di uptime e i monitoraggi sintetici, esegui il comando 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:

1. Fai clic su projects.uptimeCheckConfigs.list.

2. Utilizza Explorer API.

   Imposta parent del metodo sul nome del progetto e assicurati di utilizzare il seguente formato:

   projects/PROJECT_ID
   

   Nell'espressione precedente, PROJECT_ID è l'ID del tuo 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:

1. Nella console Google Cloud, vai alla pagina  Monitoraggio sintetico:

   Vai a Monitoraggio sintetico

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. 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 funzione Cloud Run dalla pagina Dettagli funzioni fornita dalle funzioni Cloud Run, seleziona la scheda Codice e poi 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, nonché informazioni di 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, consulta Trovare l'identificatore univoco di un monitor 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 determinato monitor sintetico nel tuo progetto Google Cloud, chiama il metodo projects.uptimeCheckConfigs.get:

1. Fai clic su projects.uptimeCheckConfigs.get.

2. Utilizza Explorer API.

   Imposta parent del metodo sull'identificatore del monitor sintetico, assicurati di utilizzare il seguente formato:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Nell'espressione precedente, PROJECT_ID è l'ID del tuo progetto Google Cloud e CHECK_ID è l'ID del monitor 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 filtro displayName="MySyntheticMonitor".

Modificare un monitor sintetico o una funzione Cloud Run

Console

Nota: se vuoi modificare solo la funzione Cloud Run, puoi utilizzare Pagina Dettagli funzione o Dettagli monitoraggio sintetico. In entrambi i casi, devi selezionare l'opzione di modifica, apportare le modifiche, quindi esegui il deployment della funzione Cloud Run modificata.

Per modificare un monitoraggio sintetico o la relativa funzione Cloud Run: utilizzando la pagina Dettagli monitor sintetico, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina  Monitoraggio sintetico:

   Vai a Monitoraggio sintetico

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Individua il monitoraggio sintetico da modificare, fai clic su Altre opzioni e poi seleziona Modifica.

3. (Facoltativo) Per modificare la funzione Cloud Run, 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 funzione Cloud Run e quindi aggiorna l'oggetto options nel file index.js. Per informazioni su i campi e la sintassi di questo oggetto, consulta broken-links-ok/index.js.

4. 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 il comando 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 ed esaminando il campo name. Per ulteriori informazioni, vedi Individua l'identificatore univoco di un controllo di uptime.

• Definisci i campi che vuoi 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 inclusi in un monitoraggio sintetico e quindi non possono essere modificati 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 funzione Cloud Run, dopo aver aggiornato l'origine della funzione devi eseguire nuovamente il deployment della funzione. Per ulteriori informazioni, consulta Eseguire il deployment di una funzione Cloud Run.

Per modificare un monitoraggio sintetico, chiama il metodo projects.uptimeCheckConfigs.patch:

1. Fai clic su projects.uptimeCheckConfigs.patch.

2. Utilizza Explorer API.

   1. Imposta parent del metodo sull'identificatore del monitor sintetico, assicurati di utilizzare il seguente formato:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
      

      Nell'espressione precedente, PROJECT_ID è l'ID del tuo progetto Google Cloud e CHECK_ID è l'ID del monitor sintetico.

      Per trovare il valore di CHECK_ID, puoi emettere il metodo projects.uptimeCheckConfigs.list. Per ridurre il numero di risultati restituiti, includi un filtro. Ad esempio, aggiungi il filtro displayName="MySyntheticMonitor".

   2. Imposta il parametro di query del metodo, updateMask, per identificare i campi dell'oggetto che vengono modificati. Ad esempio, per aggiornare il valore del parametro di query displayName:

      updateMask=displayName
      

Copia un monitor sintetico

Console

Per copiare un monitoraggio sintetico nel tuo progetto Google Cloud, segui questi passaggi:

1. Nella console Google Cloud, vai alla Pagina Monitoraggio sintetico:

   Vai a Monitoraggio sintetico

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Individua il monitor sintetico che vuoi modificare. fai clic su Altre opzioni, quindi seleziona Copia.

   Viene visualizzata la finestra di dialogo Copia controllo sintetico con i campi precompilati, tra cui una copia della funzione Cloud Run.

3. Fai clic su Crea funzione, aggiorna la funzione in base alle esigenze e poi Fai clic su Applica funzione.

4. Per mantenere le modifiche, fai clic su Crea. In caso contrario, fai clic su Annulla.

   Quando fai clic su Crea, viene creata la funzione Cloud Run e 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 crearne una copia seguendo questi passaggi:

1. Chiama il metodo projects.uptimeCheckConfigs.get e salva la risposta. Per ulteriori informazioni, consulta Visualizzare i dettagli di un monitor sintetico.
2. Modifica la risposta.
3. Chiama il projects.uptimeCheckConfigs.create e passare al metodo la risposta modificata.

Eliminare un monitoraggio sintetico

Console

Nota: quando elimini un controllo di uptime o un monitoraggio sintetico utilizzando nella console Google Cloud, elimini anche i criteri di avviso associati. Tuttavia, l'eliminazione di un monitoraggio sintetico non comporta l'eliminazione della funzione Cloud Run.

Per eliminare un monitoraggio sintetico e gli eventuali criteri di avviso associati:

1. Nella console Google Cloud, vai alla pagina  Monitoraggio sintetico:

   Vai a Monitoraggio sintetico

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Individua il monitoraggio sintetico che vuoi eliminare e fai clic sul pulsante nome.

3. (Facoltativo) Se vuoi eliminare la funzione Cloud Run, quindi seleziona la scheda Codice e fai clic sul nome della funzione. Si apre la pagina Dettagli funzioni in una nuova finestra.

4. Nella pagina Dettagli del monitoraggio sintetico, fai clic su Elimina, quindi completa la finestra di dialogo.

   Ora hai eliminato il monitoraggio sintetico.

5. Per eliminare la funzione Cloud Run, vai alla pagina Dettagli funzioni, fai clic su Elimina, quindi completa la finestra di dialogo.

gcloud

Nota: non puoi eliminare un controllo dell'uptime o un monitoraggio sintetico utilizzando Google Cloud CLI o l'API Cloud Monitoring se esiste un criterio di avviso associato al controllo dell'uptime o al monitoraggio sintetico. Devi prima eliminare il criterio di avviso. L'eliminazione di un monitoraggio sintetico non elimina la funzione Cloud Run.

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 dell'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

Nota: non puoi eliminare un controllo dell'uptime o un monitoraggio sintetico utilizzando Google Cloud CLI o l'API Cloud Monitoring se esiste un criterio di avviso associato al controllo dell'uptime o al monitoraggio sintetico. Devi prima eliminare il criterio di avviso. L'eliminazione di un monitor sintetico non comporta l'eliminazione della funzione Cloud Run.

Per eliminare un monitoraggio sintetico e i criteri di avviso associati, chiama il metodo Metodo projects.uptimeCheckConfigs.delete:

1. Fai clic su projects.uptimeCheckConfigs.delete.

2. Utilizzare Explorer API.

   Imposta parent del metodo sull'identificatore del monitor sintetico, assicurati di utilizzare il seguente formato:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Nell'espressione precedente, PROJECT_ID è il tuo ID progetto Google Cloud e CHECK_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 filtro displayName="MySyntheticMonitor".

Trovare l'identificatore univoco di un monitor sintetico

Quando viene creato il monitoraggio sintetico, Monitoring gli assegna un identificatore. 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 dei metodi Google Cloud CLI e dell'API Cloud Monitoring che creano o elencano i monitor sintetici.

Passaggi successivi

• Crea un monitoraggio sintetico
• Esplora i risultati del monitoraggio sintetico