Impostazione di un avviso di tempo di attività

Questo tutorial mostra come configurare un avviso di uptime per l' app Python Hello World in esecuzione nell'ambiente flessibile di App Engine utilizzando Cloud Monitoring. Gli avvisi di uptime ti informano quando la tua app non gestisce il traffico. Puoi anche impostare avvisi di uptime per le app in esecuzione su Compute Engine o Google Kubernetes Engine (GKE).

Obiettivi

  • Eseguire un'app Hello World di base.
  • Creare un controllo di uptime che monitori se l'app restituisce un codice di stato HTTP "200".
  • Creare un avviso che ti invii un messaggio email quando il controllo di uptime non viene superato.
  • Riavviare l'app per attivare l'avviso.

Costi

Al momento, Monitoring viene offerto agli utenti beta senza costi.

Prima di iniziare

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify 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.

  1. Clona il repository.

    git clone https://github.com/GoogleCloudPlatform/getting-started-python.git

  2. Vai alla directory di esempio.

    cd getting-started-python/gce

  3. Poiché l'app restituisce solo "Hello World!", non richiede alcuna configurazione e puoi eseguirla immediatamente.

    gcloud app deploy

  4. Per visualizzare il messaggio restituito, inserisci il seguente URL nel browser:

    https://PROJECT_ID.REGION_ID.r.appspot.com

    Sostituisci quanto segue:

Creazione di un controllo di uptime

Dopo aver eseguito il deployment dell'app, puoi utilizzare Monitoring per creare un controllo di uptime. Il controllo esegue continuamente il ping dell'app di cui è stato eseguito il deployment per assicurarsi che restituisca una risposta integra.

  1. Nella Google Cloud console, vai alla pagina  Controlli di uptime:

    Vai a Controlli di uptime

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Fai clic su Crea controllo di uptime.

  3. Assegna un titolo al controllo, ad esempio Check Hello World, quindi fai clic su Avanti.

  4. Nella sezione Destinazione, specifica cosa deve monitorare il controllo di uptime:

    1. Poiché hai eseguito il deployment in App Engine, modifica Tipo di risorsa in App Engine anziché URL. (URL serve per generare un URL personalizzato su un'istanza Compute Engine.)
    2. Seleziona il Servizio da monitorare con il controllo di uptime.
    3. Lascia vuoto il campo Percorso per utilizzare la pagina di indice principale come impostazione predefinita.
    4. Lascia il valore predefinito di Frequenza di controllo su 1 minuto.
    5. Fai clic su Avanti.

  5. Lascia invariati i valori predefiniti dei campi Convalida della risposta e fai clic su Avanti.

  6. Nella sezione Avviso e notifica, specifica come ricevere una notifica in caso di avviso:

    • Assicurati che l'etichetta dell'opzione di attivazione/disattivazione sia Avvisi attivati.
    • Lascia invariati i valori predefiniti dei campi relativi al nome e alla durata.

    • Per aggiungere un canale di notifica al criterio di avviso, fai clic su Menu nella casella di testo Canali di notifica. 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 delle 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 .

  7. Fai clic su Crea. Se l'azione di creazione va a buon fine, 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, si apre la visualizzazione dei dettagli del 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 un criterio, fai clic sul relativo nome.

    Puoi anche visualizzare il criterio di avviso dalla pagina Avvisi. Nella pagina degli avvisi, il riquadro Criteri elenca un sottoinsieme di criteri. Per visualizzare un elenco di tutti i criteri, fai clic su Visualizza tutti i criteri.

Simulazione di un'interruzione del servizio

Ora che hai creato il controllo di uptime, puoi simulare un'interruzione del servizio modificando l'app in modo che risponda con un errore HTTP 404 Sorry, we can't find that page anziché con una risposta HTTP 200 OK.

  1. Il seguente codice mostra dove l'app Hello World restituisce solo il messaggio "Hello World!" e che il codice di stato della risposta è impostato per impostazione predefinita su 200 OK. Per visualizzare questo codice nell'app Hello World, utilizza la funzione di visualizzazione.

    # Copyright 2019 Google LLC All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

from flask import Flask
app = Flask(__name__)


@app.route('/', methods=['GET'])
def say_hello():
    return "Hello, world!"


if __name__ == '__main__':
    app.run(host='127.0.0.1', port=8080, debug=True)

  2. Per fare in modo che l'app Hello World restituisca un codice di errore HTTP 404, modifica la riga di restituzione aggiungendo un valore 404 alla seconda parte del valore restituito.

    return 'Hello World', 404

  3. Esegui il deployment della nuova app, intenzionalmente non funzionante.

    gcloud app deploy

    Entro mezz'ora riceverai un messaggio email che indica che il controllo di uptime non viene superato.

Libera spazio

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:

  1. Nella Google Cloud console, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
  3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.