Questo documento descrive come gestire i controlli di uptime utilizzando Console Google Cloud, Google Cloud CLI, l'API Cloud Monitoring e il client librerie.
Elenca 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 Monitoraggio.
Nell'esempio seguente viene mostrata una pagina Controlli di uptime di esempio:
(Facoltativo) Aggiungi filtri per limitare i controlli di uptime elencati.
Ogni filtro è composto da un nome e da un valore. Puoi impostare il valore in modo che corrisponda esatta al nome di un controllo di uptime, o una corrispondenza parziale. Le corrispondenze non sono sensibili alle maiuscole. Ad esempio, per elencare tutte i controlli di uptime il cui nome contiene
default
:- 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 filtroOR
. L'esempio precedente utilizza il filtroOR
per consentire un controllo di uptime se il nome corrisponde adefault
oTesting check
.
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 controlli di uptime e i monitoraggi sintetici, chiama il
projects.uptimeCheckConfigs.list
. Specifica i seguenti parametri:
parent: il progetto di cui vuoi elencare i controlli di uptime. Il formato è:
projects/PROJECT_ID
Per ottenere un controllo di uptime specifico, chiama il
projects.uptimeCheckConfigs.get
. Specifica il seguente parametro:
name: il nome completo della configurazione del controllo di uptime.
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Per ulteriori informazioni sull'identificatore del controllo di uptime, consulta Individua l'identificatore univoco di un controllo di uptime.
C#
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Visualizza 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 Monitoraggio.
Individua il controllo di uptime che vuoi visualizzare e fai clic sul suo nome.
Il seguente screenshot mostra i dettagli di uptime per un controllo di uptime con il nome "My Uptime Check":
La pagina Dettagli uptime contiene le seguenti informazioni:
- L'intervallo di tempo selezionato. Per impostazione predefinita, l'intervallo è 1 ora.
- Il nome del controllo di uptime. Nell'esempio, il nome è My Uptime Check.
- Le etichette che hai aggiunto al controllo di uptime.
La percentuale di uptime e la latenza media. Il valore di Tempo di attività percentuale è una percentuale calcolata come:
(S/T)*100
, doveS
è il numero di risposte di verifica andate a buon fine eT
è il numero totale di risposte ai controlli, da tutte le posizioni. Per i controlli di gruppo, i valori diS
eT
vengono sommati per tutti i valori attuali membri del gruppo.Ad esempio, su un periodo di 25 minuti, un controllo di uptime con un periodo di un minuto in esecuzione da tutte le regioni riceverebbe 25 richieste da ciascuna delle sei località, per un totale di 150 richieste. Se la dashboard riporta un tempo di attività dell'83,3%, 125 di 150 richieste riuscite.
I riquadri Controlli superati e Latenza del controllo di uptime mostrano graficamente il numero di controlli superati e la latenza di ogni controllo in funzione del tempo.
Il riquadro Stato attuale mostra lo stato dei controlli più recenti. Un cerchio verde con un segno di spunta accanto a una regione indica l'ultima esecuzione del il controllo della regione è andato a buon fine; 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 (ID controllo) corrisponde a
CHECK_ID
nelle chiamate API.Il riquadro Criteri di avviso elenca le informazioni relative ai criteri di avviso. Nella dashboard di esempio, un criterio di avviso configurato.
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
Individua l'identificatore univoco di un controllo di uptime.
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 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 ulteriori informazioni sull'identificatore del controllo di uptime, consulta Individua l'identificatore univoco di un controllo di uptime.
C#
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Modifica un controllo di uptime
Puoi modificare alcuni campi di un controllo di uptime. Ad esempio, potresti volere che il controllo si verifichi più spesso o potresti voler aumentare il timeout associato alla convalida della risposta. Tuttavia, se le tue controllo di uptime non è configurato con il protocollo, il tipo di risorsa o ed eliminare l'attuale controllo di uptime e crearne uno nuovo.
Per informazioni su come modificare un criterio di avviso che monitora un 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 qualsiasi delle seguenti schede. Per modificare un controllo di 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 Monitoraggio.
Individua il controllo di uptime che vuoi modificare, quindi effettua una delle seguenti operazioni:
- Fai clic su Altro more_vert e seleziona Modifica.
- Visualizza i dettagli del controllo di uptime, quindi fai clic su Modifica.
Modifica i valori dei campi in base alle esigenze. Non puoi modificare tutti i campi. Se valori di intestazione personalizzati di un controllo sono nascosti, non puoi visibili.
Per verificare se il controllo funziona, fai clic su Prova. Se il test non riesce, consulta Controlli non riusciti per verificare le possibili cause.
Fai clic su Salva.
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.
Ad esempio, per impostare il periodo di un controllo di uptime su 10 minuti, esegui questo comando:
gcloud monitoring uptime update CHECK_ID --period=10
API
Chiama il projects.uptimeCheckConfigs.patch
. Imposta i parametri per il metodo come segue:
uptimeCheckConfig.name: obbligatorio. Fa parte dell'URL REST. it è il nome della risorsa del controllo di uptime da modificare:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Per ulteriori informazioni sull'identificatore del controllo di uptime, consulta Individua l'identificatore univoco di un controllo di uptime.
updateMask: facoltativo. Questo è un parametro di query:
?updateMask=[FIELD_LIST]
.[FIELD_LIST]
è un elenco di campi separati da virgole inUptimeCheckConfig
che deve essere modificato. Ad esempio:"resource.type,httpCheck.path"
Il corpo della richiesta deve contenere un parametro
UptimeCheckConfig
con i nuovi valori del campo.
Se il criterio updateMask
è impostato, vengono sostituiti solo i campi elencati in updateMask
ai campi corrispondenti nella configurazione esistente. Se un campo contiene
e il campo viene elencato nella maschera del campo ma nessuno dei suoi sottocampi
tutti i campi secondari 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 il valore
UptimeCheckConfig
per la configurazione modificata.
C#
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Potrebbe verificarsi un ritardo di massimo 5 minuti prima che venga visualizzato il nuovo controllo di uptime che consentono di analizzare i dati e visualizzare i risultati. Durante questo periodo, vengono visualizzati i risultati del precedente controllo di uptime nelle dashboard e utilizzate nei criteri di avviso.
Eliminazione di un controllo di uptime
Ti consigliamo di eliminare un controllo di uptime quando disattivi il servizio o risorsa che monitora. Nota: prima di eliminare un controllo di uptime, assicurati che non siano presenti avvisi che monitorano il controllo di uptime. Quando un criterio di avviso monitora un controllo di uptime, la console Google Cloud impedisce l'eliminazione di quel controllo. Tuttavia, l'API Cloud Monitoring non genera un errore né impedisce l'eliminazione dei dati. Non viene creato alcun incidente per il controllo mancante.
Per eliminare un controllo di uptime, segui questi passaggi:
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 Monitoraggio.
Individua il controllo di uptime che vuoi modificare, quindi effettua una delle seguenti operazioni:
- Fai clic su Altro more_vert e seleziona Elimina.
- Visualizza i dettagli del controllo di uptime, quindi fai clic su Elimina.
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
Individua 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. Questo è il nome risorsa del controllo di uptime configurazione da eliminare:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Per ulteriori informazioni sull'identificatore del controllo di uptime, consulta Individua l'identificatore univoco di un controllo di uptime.
C#
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per autenticarti a Monitoring, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Monitora 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 ulteriori informazioni, vedi Crea 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 noto come ID controllo di uptime. Questo identificatore è incorporato in il nome della risorsa per il controllo di uptime:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
L'ID del controllo di uptime è incluso nella risposta dei metodi dell'API Cloud Monitoring che creano o elencano i controlli di uptime. Puoi anche trovare l'ID del controllo di uptime Nel riquadro Configurazione della pagina Dettagli uptime nel nella console Google Cloud. Per informazioni su come visualizzare l'uptime dettagli, consulta la sezione Visualizzare i dettagli di un controllo di uptime di questo documento.
Passaggi successivi
- Elenca gli indirizzi IP dei server per il controllo di uptime
- Crea criteri di avviso per i controlli di uptime
- Creare un grafico delle metriche relative al controllo di uptime