Gestire 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

3. (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 a una corrispondenza parziale. Le corrispondenze non sono sensibili alle maiuscole. Ad esempio, per elencare tutti i monitor sintetici il cui nome contiene default, procedi nel seguente modo:

   • Fai clic su Tabella Filtro 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 tu non inserisca un filtro OR. L'esempio precedente utilizza il filtro OR in modo che un controllo dell'uptime venga elencato se il suo nome corrisponde a default o Testing check.

La pagina Monitoraggi 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 di esecuzione medio.
• Il numero di criteri di avviso.
• Per modificare, copiare o eliminare il monitor sintetico e per creare un criterio di avviso, utilizza il menu Altre opzioni more_vert.

gcloud

Per elencare i controlli di uptime e i monitoraggi sintetici, esegui il comando gcloud monitoring uptime list-configs:

gcloud monitoring uptime list-configs --project=PROJECT_ID

Prima di eseguire il comando precedente, sostituisci quanto segue:

• PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

I dati restituiti includono quanto segue:

• Nome e nome visualizzato.
• Controlla l'identificatore.
• Risorsa monitorata.
• Periodo tra i controlli.

Puoi configurare il comando Google Cloud CLI per filtrare e ordinare i risultati.

REST

Per elencare i monitor sintetici nel tuo progetto Google Cloud , inclusi i controlli di uptime, chiama il metodo projects.uptimeCheckConfigs.list:

1. Fai clic su projects.uptimeCheckConfigs.list.

2. Utilizza Explorer API.

   Imposta parent del metodo sul nome del progetto, assicurandoti di utilizzare il seguente formato:

   projects/PROJECT_ID
   

   Nell'espressione precedente, PROJECT_ID è l'ID progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

Per un monitoraggio sintetico, il risultato contiene un campo etichettato syntheticMonitor.

Console

Per visualizzare i dettagli di un monitoraggio sintetico 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

3. Per aprire la pagina Dettagli monitoraggio sintetico, individua il monitoraggio sintetico che vuoi visualizzare, quindi fai clic sul relativo nome.

   Se vuoi visualizzare la funzione Cloud Run dalla pagina Dettagli funzione fornita da Cloud Run Functions, seleziona la scheda Codice e poi fai clic sul nome della funzione. La pagina Dettagli funzioni si apre in una nuova finestra. Le schede di questa pagina consentono di visualizzare metriche e log, nonché informazioni di configurazione.

gcloud

Per elencare i dettagli di un controllo dell'uptime o di un monitor sintetico, esegui il comando gcloud monitoring uptime describe:

gcloud monitoring uptime describe CHECK_ID --project=PROJECT_ID

Prima di eseguire il comando precedente, sostituisci quanto segue:

• PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
• CHECK_ID: l'identificatore del controllo di uptime o del monitor sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per maggiori informazioni, vedi Trovare l'identificatore univoco di un monitor sintetico.

I dati restituiti per il controllo di uptime includono quanto segue:

• Nome e nome visualizzato.
• Controlla l'identificatore.
• Risorsa monitorata.
• Periodo tra i controlli.

REST

Per elencare i dettagli di un monitor sintetico specifico 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, assicurandoti di utilizzare il seguente formato:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Nell'espressione precedente:

   • PROJECT_ID è l' Google Cloud ID progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
   • CHECK_ID è l'ID del monitoraggio sintetico.

   Ad esempio, il valore del campo principale potrebbe essere:

   projects/my-project/uptimeCheckConfigs/10863117100295372627
   

   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".

Console

Per modificare un monitor sintetico o la relativa funzione Cloud Run utilizzando la pagina Dettagli monitor sintetico:

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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
3. Individua il monitor sintetico da modificare, fai clic su more_vert Altre opzioni e poi seleziona Modifica.

4. (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 non funzionanti, per modificare l'URI di origine o le opzioni che definiscono quali link vengono testati, modifica la funzione Cloud Run e poi aggiorna l'oggetto options nel file index.js. Per informazioni sui campi e sulla sintassi di questo oggetto, vedi broken-links-ok/index.js.

5. Per conservare le modifiche, fai clic su Salva. In caso contrario, fai clic su Annulla.

gcloud

Per modificare un controllo di uptime o un monitor sintetico, esegui il comando gcloud monitoring uptime update:

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS --project=PROJECT_ID

Prima di eseguire il comando precedente, sostituisci quanto segue:

• PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

• CHECK_ID: l'identificatore del controllo di uptime o del monitor sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per saperne di più, consulta Trovare l'identificatore univoco di un controllo di uptime.

• Definisci i campi che vuoi modificare. Per i monitoraggi sintetici, puoi aggiornare solo i seguenti campi:

  • Periodo
  • Nome visualizzato
  • Timeout
  • Etichette utente

Ad esempio, per impostare il periodo di un monitor sintetico su 10 minuti, esegui questo comando:

gcloud monitoring uptime update CHECK_ID --period=10 --project=PROJECT_ID

REST

I criteri e le funzioni di avviso non sono contenuti in un monitoraggio sintetico e pertanto 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 le norme di avviso tramite API.

• Per modificare una funzione Cloud Run, dopo aver aggiornato l'origine della funzione, devi eseguire nuovamente il deployment della funzione. Per maggiori 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. L'identificatore ha il seguente formato:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
      

      Nell'espressione precedente:

      • PROJECT_ID è l'ID progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
      • CHECK_ID è l'ID del monitoraggio 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 quali campi dell'oggetto vengono modificati. Ad esempio, per aggiornare il valore del parametro di ricerca displayName, procedi nel seguente modo:

      updateMask=displayName
      

Console

Per copiare un monitor sintetico 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

3. Individua il monitor sintetico da modificare, fai clic su more_vert Altre opzioni e poi seleziona Copia.

   Si apre la finestra di dialogo Copia controllo sintetico con i campi precompilati, inclusa una copia della funzione Cloud Run.

4. Fai clic su Crea funzione, aggiorna la funzione come necessario e poi fai clic su Applica funzione.

5. Per conservare le modifiche, fai clic su Crea. In caso contrario, fai clic su Annulla.

   Quando fai clic su Crea, la funzione Cloud Run viene creata ed eseguito il deployment, quindi viene creato il monitor sintetico.

gcloud

Non esiste un metodo Google Cloud CLI che ti consenta di copiare un monitor sintetico.

REST

Non esiste un metodo API che consenta di copiare un monitoraggio sintetico. Tuttavia, puoi creare una copia seguendo questi passaggi:

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

Console

Per eliminare un monitor sintetico e tutti i criteri di avviso associati, 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

3. Individua il monitor sintetico da eliminare e fai clic sul nome.

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

5. Nella pagina Dettagli monitor sintetico, fai clic su delete Elimina, quindi completa la finestra di dialogo.

   Ora hai eliminato il monitor sintetico.

6. Per eliminare la funzione Cloud Run, vai alla pagina Dettagli funzione, fai clic su delete Elimina e poi completa la finestra di dialogo.

gcloud

Per eliminare un controllo di uptime o un monitor sintetico, esegui il comando gcloud monitoring uptime delete:

gcloud monitoring uptime delete CHECK_ID  --project=PROJECT_ID

Prima di eseguire il comando precedente, sostituisci quanto segue:

• PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
• CHECK_ID: l'identificatore del controllo di uptime o del monitor sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per maggiori informazioni, vedi Trovare l'identificatore univoco di un monitor sintetico.

REST

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

1. Fai clic su projects.uptimeCheckConfigs.delete.

2. Utilizza Explorer API.

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

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Nell'espressione precedente:

   • PROJECT_ID è l'ID progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
   • CHECK_ID è l'ID del monitoraggio 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".