Gestisci monitoraggi sintetici

Questo documento descrive come gestire i monitoraggi sintetici. Puoi visualizzare un elenco dei tuoi monitor sintetici e, per ogni monitor sintetico, può 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 dell'esecuzione metriche e 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 monitoraggi 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 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 monitoraggi sintetici

Console

Per elencare i monitor sintetici 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 Monitoraggio.

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

    Ogni filtro è composto da un nome e da 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 per consentire 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 creare un utilizza Menu Altre opzioni.

gcloud

Per elencare i controlli di uptime e i monitoraggi sintetici, esegui 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. Utilizzare Explorer API.

    Imposta l'elemento parent del metodo sul nome del progetto e assicurati di utilizza il seguente formato:

    projects/PROJECT_ID

    Nell'espressione precedente, PROJECT_ID è il tuo ID 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, procedi nel seguente modo:

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

  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 Cloud Function dal Pagina Dettagli funzioni fornita da Cloud Functions, seleziona la scheda Codice e infine 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, e 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, vedi Trova l'identificatore univoco di un monitoraggio 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 monitoraggio sintetico specifico nel tuo progetto Google Cloud, chiama il Metodo projects.uptimeCheckConfigs.get:

  1. Fai clic su projects.uptimeCheckConfigs.get.

  2. Utilizzare Explorer API.

    Imposta il campo parent del metodo sull'identificatore del monitoraggio sintetico, utilizza 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.

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

Modifica un monitoraggio sintetico o una Cloud Function

Console

Per modificare un monitoraggio sintetico o la relativa Cloud Function 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 Monitoraggio.

  2. Individua il monitor sintetico che vuoi 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 i controlli dei link inaccessibili, modificare l'URI di origine o le opzioni che definire quali link vengono testati, modificare la Cloud Function aggiorna l'oggetto options nel file index.js. Per informazioni su campi e sintassi dell'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 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 e esaminando il campo name. Per ulteriori informazioni, vedi Individua l'identificatore univoco di un controllo di uptime.

  • Definisci i campi da 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 contenuti in un monitoraggio sintetico e pertanto non possono essere modificate con la procedura descritta in questa sezione:

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

  1. Fai clic su projects.uptimeCheckConfigs.patch.

  2. Utilizzare Explorer API.

    1. Imposta il campo parent del metodo sull'identificatore del monitoraggio sintetico, utilizza 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".

    2. Imposta il parametro di query del metodo, updateMask, per identificare gli dei campi dell'oggetto. Ad esempio, per aggiornare valore di displayName, il parametro di query sarà il seguente:

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

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

    Si apre la finestra di dialogo Copia controllo sintetico con campi precompilati. inclusa una copia della Cloud Function.

  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 tua funzione Cloud Function 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 crea una copia seguendo questa procedura:

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

Elimina un monitoraggio sintetico

Console

Per eliminare un monitoraggio sintetico e gli eventuali criteri di avviso associati, procedi nel seguente modo:

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

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

  3. (Facoltativo) Se vuoi eliminare la Cloud Function, 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 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 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 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

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 il campo parent del metodo sull'identificatore del monitoraggio sintetico, utilizza 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 monitoraggio sintetico

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

Passaggi successivi