Gestisci monitor sintetici

Questo documento descrive come gestire i monitor sintetici. Puoi visualizzare un elenco dei monitor sintetici e, per ogni monitoraggio sintetico, puoi visualizzare e modificare la configurazione, la cronologia delle esecuzioni 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 dell'esecuzione e le metriche e i 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 monitor sintetici utilizzando la console Google Cloud, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:

    Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

    Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

  • Le istruzioni dell'API in questa pagina si riferiscono a Explorer API. Tuttavia, puoi anche inviare un comando curl. L'Explorer API fornisce la sintassi curl.

Elenca monitor sintetici

Console

Per elencare i monitor sintetici nel tuo progetto Google Cloud:

  1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi  Monitoraggio sintetico:

    Vai a Monitoraggio sintetico

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

    Ciascun filtro è composto da un nome e da un valore. Puoi impostare il valore in modo che sia una corrispondenza esatta per il nome di un monitoraggio sintetico o una corrispondenza parziale. Le corrispondenze non fanno distinzione tra maiuscole e minuscole. Ad esempio, per elencare tutti i monitor sintetici il cui nome contiene default:

    • Fai clic su Filtra tabella e seleziona Nome visualizzato.
    • Inserisci default e premi il tasto Invio.

    Se disponi di 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 venga elencato un controllo di uptime 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 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 per creare un criterio di avviso, utilizza il menu Altre opzioni.

gcloud

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

gcloud monitoring uptime list-configs

I dati restituiti includono:

  • Nome e nome visualizzato.
  • Controlla 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 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 il valore parent del metodo sul nome del progetto, 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. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi  Monitoraggio sintetico:

    Vai a Monitoraggio sintetico

  2. Per aprire la pagina Dettagli monitoraggio sintetico, individua il monitor sintetico che vuoi visualizzare e fai clic sul suo nome.

    Se vuoi visualizzare la Cloud Function dalla pagina Dettagli funzioni fornita da Cloud Functions, seleziona la scheda Codice e fai clic sul nome della funzione. La pagina Dettagli funzioni si apre in una nuova finestra. Le schede in questa pagina consentono di visualizzare metriche, log e 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 di uptime o del monitoraggio sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per maggiori informazioni, consulta Trovare l'identificatore univoco di un monitoraggio sintetico.

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

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

  1. Fai clic su projects.uptimeCheckConfigs.get.

  2. Utilizza Explorer API.

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

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    Nell'espressione precedente, PROJECT_ID è l'ID progetto Google Cloud e CHECK_ID è l'ID 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".

Modifica un monitor sintetico o una Cloud Function

Console

Per modificare un monitoraggio sintetico o la relativa Cloud Function utilizzando la pagina Dettagli monitoraggio sintetico, procedi nel seguente modo:

  1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi  Monitoraggio sintetico:

    Vai a Monitoraggio sintetico

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

  3. (Facoltativo) Per modificare la Cloud Function, fai clic su Modifica funzione, apporta le modifiche e poi fai clic su Applica funzione.

    Per quanto riguarda la verifica dei link inaccessibili, per modificare l'URI di origine o le opzioni che definiscono i link da testare, modifica la Cloud Function, quindi aggiorna l'oggetto options nel file index.js. Per informazioni sui campi e sulla sintassi di questo oggetto, vedi 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:

  • Sostituisci CHECK_ID con l'identificatore del controllo di uptime o del monitoraggio sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per maggiori informazioni, consulta Trovare l'identificatore univoco di un controllo di uptime.

  • Definisci i campi da modificare. Per i monitor 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 questo comando:

gcloud monitoring uptime update CHECK_ID --period=10

API

I criteri e le funzioni di avviso non sono contenuti da un monitoraggio sintetico e, pertanto, non possono essere modificati tramite 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 il valore parent del metodo sull'identificatore del monitoraggio sintetico, assicurati di utilizzare il seguente formato:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

      Nell'espressione precedente, PROJECT_ID è l'ID progetto Google Cloud e CHECK_ID è l'ID 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 i campi dell'oggetto che vengono modificati. Ad esempio, per aggiornare il valore di displayName, il parametro di query è il seguente:

      updateMask=displayName

Copia un monitoraggio sintetico

Console

Per copiare un monitoraggio sintetico nel tuo progetto Google Cloud:

  1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi  Monitoraggio sintetico:

    Vai a Monitoraggio sintetico

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

    Viene visualizzata la finestra di dialogo Copia controllo sintetico con campi precompilati, compresa una copia della Cloud Function.

  3. Fai clic su Crea funzione, aggiorna la funzione in base alle tue 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 e sottoposta a deployment la Cloud Function e poi viene creato il monitoraggio sintetico.

gcloud

Non esiste un metodo di Google Cloud CLI che consente di copiare un monitoraggio sintetico.

API

Non esiste un metodo API che consenta di copiare un monitoraggio sintetico. Tuttavia, puoi crearne una copia svolgendo i seguenti passaggi:

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

Elimina un monitoraggio sintetico

Console

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

  1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring, quindi  Monitoraggio sintetico:

    Vai a Monitoraggio sintetico

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

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

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

    Hai eliminato il monitoraggio sintetico.

  5. 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 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 di uptime o del monitoraggio sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs ed esaminando il campo name. Per maggiori informazioni, consulta Trovare l'identificatore univoco di un monitoraggio 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 il valore parent del metodo sull'identificatore del monitoraggio sintetico, assicurati di utilizzare il seguente formato:

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    Nell'espressione precedente, PROJECT_ID è l'ID progetto Google Cloud e CHECK_ID è l'ID 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".

Trovare l'identificatore univoco di un monitoraggio sintetico

Quando viene creato il monitoraggio sintetico, Monitoring gli assegna un identificatore. Questo identificatore è incorporato nel nome della risorsa per il monitoraggio sintetico e ha il formato:

projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

CHECK_ID è incluso nella risposta dei metodi dell'interfaccia a riga di comando di Google Cloud CLI e dell'API Cloud Monitoring che creano o elencano monitor sintetici.

Passaggi successivi