Gestire i monitoraggi sintetici

Questo documento descrive come gestire i monitor sintetici. Puoi visualizzare un elenco dei tuoi monitoraggi sintetici e, per ogni monitoraggio sintetico, puoi visualizzare e modificare la configurazione, la cronologia di esecuzione e i dettagli di ogni esecuzione. Puoi gestire i monitor sintetici utilizzando la console Google Cloud o 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

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 al nome di un 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 dei filtri 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 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 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 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.

API

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

Visualizzare i dettagli di un monitoraggio sintetico

Console

Per visualizzare i dettagli di un monitor sintetico nel tuo progetto Google Cloud, effettua le seguenti operazioni:

  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 monitoraggio sintetico, individua il monitoraggio sintetico che vuoi visualizzare e 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. Viene visualizzata 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 il comando gcloud monitoring uptime describe:

gcloud monitoring uptime describe CHECK_ID

Prima di eseguire il comando precedente, sostituisci CHECK_ID con l'identificatore del controllo dell'uptime o del monitoraggio sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per ulteriori informazioni, consulta Trovare l'identificatore univoco di un monitor sintetico.

I dati restituiti per il controllo dell'uptime includono quanto segue:

  • Nome e nome visualizzato.
  • Controlla 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 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".

Modificare un monitor sintetico o una funzione Cloud Run

Console

Per modificare un monitor sintetico o la relativa funzione Cloud Run utilizzando la pagina Dettagli del 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. 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 interrotti, per modificare l'URI di origine o le opzioni che definiscono i link da testare, modifica la funzione Cloud Run e poi 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 conservare 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 o del monitor sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per ulteriori informazioni, 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 monitoraggio sintetico su 10 minuti, esegui il seguente 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 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

Copiare un monitoraggio sintetico

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. Individua il monitoraggio sintetico da modificare, fai clic su Altre opzioni e poi 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 se necessario e poi fai clic su Applica funzione.

  4. 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 e eseguita il deployment, quindi viene creato il monitor sintetico.

gcloud

Non esiste un metodo Google Cloud CLI che ti consenta di copiare un monitor 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 metodo projects.uptimeCheckConfigs.create e passa al metodo la risposta modificata.

Eliminare un monitoraggio sintetico

Console

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 da eliminare e fai clic sul nome.

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

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

    Hai eliminato il monitoraggio sintetico.

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

gcloud

Per eliminare un controllo di uptime o un monitoraggio sintetico, esegui il comando 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 l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per ulteriori informazioni, consulta Trovare l'identificatore univoco di un monitor sintetico.

API

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

Trovare l'identificatore univoco di un monitor sintetico

Quando viene creato il monitoraggio sintetico, Monitoring gli assegna un identificativo. Questo identificatore è incorporato nel nome della risorsa del monitor sintetico e ha il seguente 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