Questo documento descrive come gestire i controlli di uptime utilizzando la console Google Cloud, Google Cloud CLI, l'API Cloud Monitoring e le librerie client.
Elenco di tutti i controlli di uptime
Console
-
Nella console Google Cloud, vai alla pagina Controlli di uptime:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
L'esempio seguente mostra una pagina di Controlli di uptime di esempio:
(Facoltativo) Per limitare i controlli di uptime 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 controllo dell'uptime o a una corrispondenza parziale. Le corrispondenze non sono sensibili alle maiuscole. Ad esempio, per elencare tutti i controlli di uptime 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 filtroOR
. L'esempio precedente utilizza il filtroOR
in modo che un controllo dell'uptime venga elencato se il nome corrisponde adefault
oTesting check
.
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 controlli di uptime e i monitoraggi sintetici, chiama il metodo
projects.uptimeCheckConfigs.list
. Specifica i seguenti parametri:
parent: il progetto di cui vuoi elencare i controlli di uptime. Il formato è:
projects/PROJECT_ID
Per eseguire un controllo di uptime specifico, chiama il metodo
projects.uptimeCheckConfigs.get
. Specifica il seguente parametro:
name: il nome completo della configurazione del controllo di uptime.
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Per saperne di più sull'identificatore del controllo di uptime, consulta Trovare l'identificatore univoco di un controllo di uptime.
C#
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Visualizzare i dettagli di un controllo di uptime
Console
-
Nella console Google Cloud, vai alla pagina Controlli di uptime:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Individua il controllo di uptime che vuoi visualizzare e fai clic sul relativo nome.
Lo screenshot seguente mostra i dettagli sull'uptime di un controllo di uptime con il nome "Il mio controllo di uptime":
La pagina Dettagli tempo di attività contiene le seguenti informazioni:
- L'intervallo di tempo selezionato. Per impostazione predefinita, l'intervallo è 1 ora.
- Il nome del controllo di uptime. Nel campione, il nome è Il mio controllo di uptime.
- Le etichette che hai aggiunto al controllo dell'uptime.
La percentuale di attività e la latenza media. Il valore Percentuale di tempo di attività è una percentuale calcolata come
(S/T)*100
, doveS
è il numero di risposte al controllo riuscite eT
è il numero totale di risposte al controllo da tutte le località. Per i controlli di gruppo, i valori diS
eT
vengono sommati per tutti i membri del gruppo attuali.Ad esempio, in un periodo di 25 minuti, un controllo dell'uptime con un periodo di un minuto eseguito in tutte le regioni riceverebbe 25 richieste da ciascuna delle sei località, per un totale di 150 richieste. Se la dashboard indica un tempo di attività dell'83,3%, significa che 125 su 150 richieste sono andate a buon fine.
I riquadri Controlli superati e Latenza del controllo di uptime mostrano in modo grafico il numero di controlli superati e la latenza di ciascun controllo in funzione del tempo.
Il riquadro Stato corrente mostra lo stato dei controlli più recenti. Un cerchio verde con un segno di spunta accanto a una regione indica che l'ultima esecuzione del controllo in quella regione è riuscita; un cerchio rosso con una X indica un errore.
Il riquadro Configurazione mostra la configurazione del controllo di uptime. Questi dati vengono assegnati al momento della creazione del controllo di uptime. Il valore Check Id corrisponde al valore
CHECK_ID
nelle chiamate API.Il riquadro Criteri di avviso elenca le informazioni relative ai criteri di avviso associati. Nella dashboard di esempio è configurato un criterio di avviso.
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 controllo di uptime.
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 controllo di uptime o di un monitoraggio sintetico, chiama il metodo
projects.uptimeCheckConfigs.get
. Specifica il seguente parametro:
name: il nome completo della configurazione del controllo di uptime.
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Per saperne di più sull'identificatore del controllo di uptime, consulta Trovare l'identificatore univoco di un controllo di uptime.
C#
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Modificare un controllo di uptime
Puoi modificare alcuni campi di un controllo dell'uptime. Ad esempio, potresti volere che il controllo venga eseguito più di frequente o aumentare il timeout associato alla convalida della risposta. Tuttavia, se il controllo dell'uptime non è configurato con il protocollo, il tipo di risorsa o la risorsa corretti, elimina il controllo dell'uptime corrente e creane uno nuovo.
Per informazioni su come modificare un criterio di avviso che monitora un controllo di uptime, consulta i seguenti documenti:
- Gestisci i criteri utilizzando la console Google Cloud.
- Gestione dei criteri di avviso tramite API .
Per modificare un controllo di uptime pubblico, puoi utilizzare la procedura in una delle seguenti schede. Per modificare un controllo dell'uptime privato, utilizza la scheda Console o API:
Console
-
Nella console Google Cloud, vai alla pagina Controlli di uptime:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Individua il controllo di uptime da modificare, quindi esegui una delle seguenti operazioni:
- Fai clic su Altro more_vert e seleziona Modifica.
- Visualizza i dettagli del controllo dell'uptime e poi fai clic su Modifica.
Modifica i valori dei campi in base alle necessità. Non puoi modificare tutti i campi. Se i valori di intestazione personalizzati di un controllo sono nascosti, non puoi renderli visibili.
Per verificare se il controllo funziona, fai clic su Test. Se il test non va a buon fine, consulta la sezione Controlli non riusciti per conoscere le possibili cause.
Fai clic su Salva.
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.
Ad esempio, per impostare il periodo di un controllo di uptime su 10 minuti, esegui il seguente comando:
gcloud monitoring uptime update CHECK_ID --period=10
API
Chiama il metodo projects.uptimeCheckConfigs.patch
. Imposta i parametri del metodo come segue:
uptimeCheckConfig.name: obbligatorio. Questa è parte dell'URL REST. Si tratta del nome della risorsa del controllo di uptime da modificare:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Per saperne di più sull'identificatore del controllo di uptime, consulta Trovare l'identificatore univoco di un controllo di uptime.
updateMask: facoltativo. Questo è un parametro di query:
?updateMask=[FIELD_LIST]
.[FIELD_LIST]
è un elenco separato da virgole di campi nell'oggettoUptimeCheckConfig
che devono essere modificati. Ad esempio:"resource.type,httpCheck.path"
Il corpo della richiesta deve contenere un
UptimeCheckConfig
con i nuovi valori di campo.
Se updateMask
è impostato, solo i campi elencati in updateMask
sostituiranno
i campi corrispondenti nella configurazione esistente. Se un campo ha
subcampi e il campo è elencato nella maschera di campo, ma nessuno dei suoi
subcampi è elencato, tutti i subcampi di quel campo sostituiscono i campi corrispondenti.
Se updateMask
non è impostato, la configurazione nel corpo della richiesta
sostituisce l'intera configurazione esistente.
Il metodo patch
restituisce l'oggetto
UptimeCheckConfig
per la configurazione modificata.
C#
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Potrebbe essere necessario attendere fino a 5 minuti prima di visualizzare i risultati del nuovo controllo del tempo di attività. Durante questo periodo, i risultati del precedente controllo di uptime vengono visualizzati nelle dashboard e utilizzati nei criteri di avviso.
Eliminazione di un controllo di uptime
Ti consigliamo di eliminare un controllo di uptime quando disattivi il servizio o la risorsa che monitora. Nota: prima di eliminare un controllo di uptime, assicurati che non siano presenti criteri di avviso che lo monitorano. Quando un criterio di avviso monitora un controllo di uptime, la console Google Cloud impedisce l'eliminazione di questo controllo. Tuttavia, l'API Cloud Monitoring non genera un errore né impedisce l'eliminazione. Non viene creato alcun incidente per il controllo mancante.
Per eliminare un controllo di uptime:
Console
-
Nella console Google Cloud, vai alla pagina Controlli di uptime:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Individua il controllo di uptime da modificare, quindi esegui una delle seguenti operazioni:
- Fai clic su Altro more_vert e seleziona Elimina.
- Visualizza i dettagli del controllo di uptime e poi fai clic su Elimina.
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 controllo di uptime.
API
Per eliminare un controllo di uptime o un monitoraggio sintetico, chiama il metodo
projects.uptimeCheckConfigs.delete
. Compila il parametro come segue:
name: obbligatorio. Si tratta del nome della risorsa della configurazione del controllo di uptime da eliminare:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Per saperne di più sull'identificatore del controllo di uptime, consulta Trovare l'identificatore univoco di un controllo di uptime.
C#
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per autenticarti in Monitoraggio, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Monitorare un controllo di uptime
Ti consigliamo di creare un criterio di avviso per ricevere una notifica quando il controllo di uptime non va a buon fine. Per saperne di più, consulta Creare criteri di avviso per i controlli di uptime.
Trovare l'identificatore univoco di un controllo di uptime
Quando viene creato il controllo di uptime, Monitoring gli assegna un identificativo, chiamato ID controllo di uptime. Questo identificatore è incorporato nel nome della risorsa per il controllo di uptime:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
L'ID controllo-uptime è incluso nella risposta dei metodi dell'API Cloud Monitoring che creano o elencano i controlli di uptime. Puoi trovare l'ID del controllo dell'uptime anche nel riquadro Configurazione della pagina Dettagli sull'uptime nella console Google Cloud. Per informazioni su come visualizzare la pagina Dettagli uptime, consulta la sezione Visualizzare i dettagli di un controllo di uptime di questo documento.
Passaggi successivi
- Elenco degli indirizzi IP dei server di controllo dell'uptime
- Creare criteri di avviso per i controlli di uptime
- Graficare le metriche dei controlli di uptime