Questo tutorial mostra come configurare un avviso di uptime per l'app Python World in esecuzione sull'ambiente flessibile di App Engine utilizzando Cloud Monitoring. Gli avvisi di uptime ti consentono di sapere quando la tua app non pubblica traffico. Puoi anche configurare gli avvisi di uptime per le app in esecuzione su Compute Engine o Google Kubernetes Engine (GKE).
Obiettivi
- Esegui un'app Hello World di base.
- Crea un controllo di uptime che monitori se l'app restituisce un codice di stato HTTP '200'.
- Crea un avviso che ti invii un messaggio email quando il controllo di uptime non riesce.
- Riavvia l'app per attivare l'avviso.
Costi
Per generare una stima dei costi basata sull'utilizzo previsto, utilizza il Calcolatore prezzi.
Il monitoraggio è attualmente offerto agli utenti beta senza costi aggiuntivi.
Prima di iniziare
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
Clonazione dell'app di esempio
L'app di esempio è disponibile su GitHub all'indirizzo GoogleCloudPlatform/getting-started-python
.
Clona il repository.
git clone https://github.com/GoogleCloudPlatform/getting-started-python.git
Vai alla directory di esempio.
cd getting-started-python/gce
Poiché l'app restituisce solo "Hello World!", non richiede alcuna configurazione e puoi eseguirla subito.
gcloud app deploy
Per visualizzare il messaggio restituito, inserisci il seguente URL nel tuo browser:
https://PROJECT_ID.REGION_ID.r.appspot.com
Sostituisci quanto segue:
PROJECT_ID
: l'ID del tuo progetto Google CloudREGION_ID
: un codice assegnato da App Engine alla tua app
Configurazione di Cloud Monitoring per il tuo progetto
Dopo aver configurato Monitoring ed eseguito il deployment dell'app, puoi utilizzare Monitoring per creare un controllo di uptime. Questo controllo consente di inviare continuamente un ping all'app di cui hai eseguito il deployment per assicurarti che restituisca una risposta sana.
Per accedere a Cloud Monitoring, procedi nel seguente modo:- In Cloud Console, seleziona il tuo progetto Google Cloud.
Vai a Cloud Console - Nel riquadro di navigazione, seleziona Monitoraggio.
Creazione di un controllo di uptime
In Cloud Console, vai a Monitoring.
Nel riquadro di navigazione, fai clic su Controlli di uptime, quindi fai clic su Crea controllo di uptime.
Assegna un titolo al controllo, ad esempio
Check Hello World
, e fai clic su Avanti.Nella sezione Target, specifica quale controllo di uptime deve monitorare:
- Poiché hai eseguito il deployment in App Engine, modifica Tipo di risorsa in App Engine anziché in URL. URL serve per generare un URL personalizzato su un'istanza Compute Engine.
- Seleziona il Servizio da monitorare con il controllo di uptime.
- Lascia vuoto Path per impostazione predefinita sulla pagina di indice principale.
- Lascia impostata la Frequenza di controllo sul valore predefinito di 1 minuto.
- Tocca Avanti.
Lascia i campi Convalida di risposta impostati sui valori predefiniti e fai clic su Avanti.
Nella sezione Avviso e notifica, specifica in che modo vuoi ricevere una notifica se si verifica un avviso:
- Assicurati che l'etichetta del pulsante sia attivata: Avvisi.
- Lascia i valori predefiniti nei campi nome e durata.
Per aggiungere un canale di notifica al criterio di avviso, nella casella di testo Canali di notifica fai clic su Menu. Seleziona i canali da aggiungere e fai clic su OK. Le notifiche sono raggruppate in ordine alfabetico per ogni tipo di canale.
Per aggiungere una voce all'elenco di caselle di controllo, fai clic su Gestisci canali di notifica e segui le istruzioni. Quando torni a questa finestra di dialogo, fai clic su Aggiorna refresh.
Fai clic su Crea. Una volta completata l'azione, viene visualizzato il messaggio Controllo e avviso creati, quindi viene visualizzata la pagina della dashboard Controlli di uptime.
Nella dashboard dei controlli di uptime, è elencato il nuovo controllo di uptime. Se fai clic sul nome del controllo, apri la visualizzazione dei dettagli per tale controllo di uptime. Questa visualizzazione mostra diversi grafici, la percentuale di uptime e le informazioni di configurazione ed elenca i criteri di avviso configurati. Per visualizzare una norma, fai clic sul nome.
Puoi visualizzare il criterio di avviso anche nella pagina Avvisi. Nella pagina degli avvisi, il riquadro Criteri elenca un sottoinsieme di criteri. Per visualizzare un elenco di tutte le norme, fai clic su Visualizza tutte le norme.
Simulazione di un'interruzione
Ora che hai creato il controllo di uptime, puoi simulare un'interruzione modificando
la tua app per rispondere con un errore HTTP 404 Sorry, we can't find that page
anziché una risposta HTTP 200 OK
.
Il seguente codice mostra dove l'app Hello World restituisce solo un messaggio 'Hello World!' e che il codice di stato della risposta è predefinito su
200 OK
. Per visualizzare questo codice nell'app Hello World, utilizza la funzione di visualizzazione.Per fare in modo che l'app Hello World restituisca un codice di errore HTTP
404
, modifica la riga di reso aggiungendo un valore404
alla seconda parte del valore restituito.return 'Hello World', 404
Esegui il deployment della nuova app intenzionalmente inaccessibile.
gcloud app deploy
Entro mezz'ora, riceverai un messaggio email che indica che il controllo di uptime non è riuscito.
Esegui la pulizia
Per evitare che al tuo Account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.
Il modo più semplice per eliminare la fatturazione è eliminare il progetto che hai creato per il tutorial.
Per eliminare il progetto:
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.