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, visualizzare la cronologia di esecuzione e visualizzare 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.

Questa funzionalità è supportata solo per i progetti Google Cloud.

Prima di iniziare

Completa quanto segue nel progetto Google Cloud in cui è archiviato il monitor sintetico:

  • 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:

    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 i ruoli personalizzati o altri ruoli predefiniti.

  • Le istruzioni per le API in questa pagina sono per l'API Explorer. Tuttavia, puoi anche emettere un comando curl. Explorer API fornisce la sintassi di curl.

  • Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

    REST

    Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

      Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init

    Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.

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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud.

  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 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 --project=PROJECT_ID

Prima di eseguire il comando precedente, sostituisci quanto segue:

  • PROJECT_ID: l'identificatore del progetto.

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 l'attributo 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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud.

  3. 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 da Cloud Run Functions, 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 --project=PROJECT_ID

Prima di eseguire il comando precedente, sostituisci quanto segue:

  • PROJECT_ID: l'identificatore del progetto.
  • CHECK_ID: l'identificatore del controllo dell'uptime o del monitoraggio sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs e 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.

REST

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

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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud.
  3. Individua il monitoraggio sintetico da modificare, fai clic su 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 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.

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

  • CHECK_ID: 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 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 --project=PROJECT_ID

REST

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. L'identificatore ha il seguente formato:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

      Nell'espressione precedente:

      • PROJECT_ID è l'ID progetto.
      • 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 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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud.

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

  4. Fai clic su Crea funzione, aggiorna la funzione se 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 eseguita, 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 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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud.

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

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

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

    Hai eliminato il monitoraggio sintetico.

  6. 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  --project=PROJECT_ID

Prima di eseguire il comando precedente, sostituisci quanto segue:

  • PROJECT_ID: l'identificatore del progetto.
  • CHECK_ID: l'identificatore del controllo dell'uptime o del monitoraggio sintetico. Puoi trovare l'identificatore eseguendo il comando gcloud monitoring uptime list-configs e esaminando il campo name. Per ulteriori informazioni, consulta 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, assicurati di utilizzare il seguente formato:

    projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

    Nell'espressione precedente:

    • PROJECT_ID è l'ID progetto.
    • 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".

Trovare l'identificatore univoco di un monitor sintetico

Quando viene creato il monitoraggio sintetico, Monitoring gli assegna un identificatore. 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