Crea criteri di avviso per i valori delle metriche previsti

Le policy di avviso relative ai valori delle metriche previste in Cloud Monitoring inviano notifiche quando una previsione indica che una serie temporale supererà una soglia definita entro una finestra di previsione imminente. Puoi utilizzare la consoleGoogle Cloud per configurare una finestra di previsione da 1 ora (3600 secondi) a 2,5 giorni (216.000 secondi) in modo da avere il tempo di rispondere prima che si verifichi una violazione della soglia.

Questi contenuti non si applicano alle policy di avviso basate su log. Per informazioni sulle policy di avviso basate su log, che ti avvisano quando nei log viene visualizzato un messaggio specifico, consulta Monitoraggio dei log.

Per ricevere notifiche quando i valori delle metriche correnti superano una soglia o quando i dati non arrivano più, consulta Crea policy di avviso basate su soglie metriche e Crea policy di avviso basate sull'assenza di metriche. Per creare policy di avviso in modo programmatico utilizzando l'API Cloud Monitoring, consulta Crea policy di avviso utilizzando l'API. Per creare policy di avviso che utilizzano query Monitoring Query Language (MQL) con soglie statiche o dinamiche, consulta Policy di avviso con MQL e Crea livelli di severità dinamici utilizzando MQL.

Questa funzionalità è supportata solo per i progetti Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.

Informazioni sulle condizioni di previsione

Puoi utilizzare le previsioni durante il monitoraggio della maggior parte delle metriche. Tuttavia, quando monitori una risorsa limitata, come la quota, lo spazio su disco o la memoria utilizzata, una condizione di previsione può inviarti una notifica prima che la soglia venga violata. Questa funzionalità ti dà più tempo per rispondere al modo in cui viene consumata la risorsa limitata prima che venga violata la soglia.

Per ogni serie temporale monitorata da una condizione di previsione, la condizione crea un'istanza di un algoritmo decisionale. Una volta addestrato, l'algoritmo genera una previsione ogni volta che viene valutata la condizione. Ogni previsione è una stima che indica se la serie temporale violerà o meno la soglia entro la finestra di previsione. Se una serie temporale monitorata ha una periodicità regolare, l'algoritmo decisionale per quella serie temporale incorpora il comportamento periodico nelle sue previsioni.

Una condizione di previsione viene soddisfatta quando si verifica una o entrambe le seguenti situazioni:

  • Tutti i valori di una serie temporale durante una specifica finestra di nuovo test violano la soglia.
  • Tutte le previsioni per una serie temporale specifica effettuate in una finestra di nuovo test prevedono che la serie temporale violerà la soglia entro la finestra di previsione.

Il tempo di addestramento iniziale per un algoritmo decisionale è il doppio della durata della finestra di previsione. Ad esempio, se la finestra di previsione è di un'ora, sono necessarie due ore di addestramento. L'algoritmo decisionale per ogni serie temporale viene addestrato in modo indipendente. Durante l'addestramento di un algoritmo decisionale, la relativa serie temporale soddisfa la condizione solo quando i valori della serie temporale violano la soglia per la finestra di nuovo test specificata.

Al termine dell'addestramento iniziale, ogni algoritmo decisionale viene addestrato continuamente utilizzando dati che coprono fino a sei volte la durata della finestra di previsione. Ad esempio, quando la finestra di previsione è di un'ora, durante l'addestramento continuo vengono utilizzate le sei ore di dati più recenti.

Quando configuri una condizione di previsione e poi i dati smettono di arrivare per più di 10 minuti, la previsione viene disattivata e la condizione funziona come una condizione di soglia della metrica.

Gli avvisi vengono creati quando la previsione prevede che una serie temporale violerà la soglia della condizione entro la finestra di previsione. Monitoring chiude automaticamente l'avviso quando la previsione indica che la serie temporale non violerà la soglia all'interno della finestra di previsione.

Prima di iniziare

  1. Per ottenere le autorizzazioni necessarie per creare e modificare le policy di avviso utilizzando la console Google Cloud , chiedi all'amministratore di concederti il ruolo IAM Monitoring Editor (roles/monitoring.editor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

    Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

    Per saperne di più sui ruoli di Cloud Monitoring, consulta Controlla l'accesso con Identity and Access Management.

  2. Assicurati di avere familiarità con i concetti generali delle policy di avviso. Per informazioni su questi argomenti, consulta la Panoramica degli avvisi.

  3. Configura i canali di notifica che vuoi utilizzare per ricevere le notifiche. Per garantire la ridondanza, ti consigliamo di creare più tipi di canali di notifica. Per saperne di più, consulta la pagina Crea e gestisci canali di notifica.

Crea policy di avviso

Per creare una criterio di avviso che invia una notifica in base a una previsione:

  1. Nella Google Cloud console, vai alla pagina  Avvisi:

    Vai ad Avvisi

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

  2. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host o il progetto di gestione di App Hub.
  3. Seleziona Crea policy.
  4. Seleziona le serie temporali da monitorare:

    1. Fai clic su Seleziona una metrica, scorri i menu per selezionare un tipo di risorsa e un tipo di metrica, quindi fai clic su Applica.

      Il menu Seleziona una metrica contiene funzionalità che ti aiutano a trovare i tipi di metriche disponibili:

      • Per trovare un tipo di metrica specifico, utilizza la barra dei filtri. Ad esempio, se inserisci util, il menu mostrerà solo le voci che includono util. Le voci vengono visualizzate quando superano un test "contiene" senza distinzione tra maiuscole e minuscole.
      • Per mostrare tutti i tipi di metriche, anche quelli senza dati, fai clic su Attive. Per impostazione predefinita, i menu mostrano solo i tipi di metriche con dati. Per saperne di più, consulta Metrica non elencata nel menu.

      Puoi monitorare qualsiasi metrica integrata o qualsiasi tipo di metrica definita dall'utente che abbia un tipo di valore double o int64, che sia una metrica di vincolo e che non sia una metrica per un'istanza VM Amazon.

      Se selezioni un tipo di metrica che comporta il monitoraggio di più di 64 serie temporali, Monitoring effettua previsioni per le 64 serie temporali i cui valori sono più vicini alla soglia o che la violano già. Per altre serie temporali, i valori vengono confrontati con la soglia.

    2. (Facoltativo) Per monitorare un sottoinsieme delle serie temporali che corrispondono ai tipi di metrica e risorsa selezionati nel passaggio precedente, fai clic su Aggiungi filtro. Nella finestra di dialogo del filtro, seleziona l'etichetta in base alla quale filtrare, un comparatore e poi il valore del filtro. Ad esempio, il filtro zone =~ ^us.*.a$ utilizza un'espressione regolare per trovare corrispondenze in tutti i dati delle serie temporali il cui nome della zona inizia con us e termina con a. Per saperne di più, vedi Filtrare la serie temporale selezionata.

    3. (Facoltativo) Per modificare l'allineamento dei punti in una serie temporale, imposta i campi Finestra mobile e Funzione finestra mobile nella sezione Trasforma i dati.

      Se monitori una metrica basata sui log, ti consigliamo di impostare il menu Finestra mobile su almeno 10 minuti.

      Questi campi specificano il modo in cui vengono combinati i punti registrati in una finestra. Ad esempio, supponiamo che la finestra sia di 15 minuti e che la funzione finestra sia max. Il punto allineato è il valore massimo di tutti i punti negli ultimi 15 minuti. Per saperne di più, consulta Allineamento: regolarizzazione all'interno delle serie.

      Puoi anche monitorare la frequenza con cui cambia il valore di una metrica impostando il campo Funzione finestra mobile su Variazione percentuale. Per saperne di più, consulta Monitora un tasso di variazione.

    4. (Facoltativo) Combina le serie temporali quando vuoi ridurre il numero di serie temporali monitorate da una policy o quando vuoi monitorare solo una raccolta di serie temporali. Ad esempio, anziché monitorare l'utilizzo della CPU di ogni istanza VM, potresti voler calcolare la media dell'utilizzo della CPU per tutte le VM in una zona e poi monitorare questa media. Per impostazione predefinita, le serie temporali non vengono combinate. Per informazioni generali, consulta Riduzione: combinazione di serie temporali.

      Per combinare tutte le serie temporali:

      1. Nella sezione Tra serie temporali, fai clic su Espandi.
      2. Imposta il campo Aggregazione serie temporale su un valore diverso da none. Ad esempio, per visualizzare il valore medio della serie temporale, seleziona mean.
      3. Assicurati che il campo Raggruppa serie temporali per sia vuoto.

      Per combinare o raggruppare le serie temporali in base ai valori delle etichette:

      1. Nella sezione Nelle serie temporali, fai clic su Espandi.
      2. Imposta il campo Aggregazione delle serie temporali su un valore diverso da none.
      3. Nel campo Raggruppa serie temporali per, seleziona le etichette in base alle quali raggruppare.

      Ad esempio, se raggruppi per l'etichetta zone e poi imposti il campo di aggregazione su un valore di mean, il grafico mostra una serie temporale per ogni zona per cui sono presenti dati. La serie temporale mostrata per una zona specifica è la media di tutte le serie temporali con quella zona.

    5. Fai clic su Avanti.

  5. Configura il trigger di condizione:

    1. Seleziona Previsione per il tipo di condizione.

    2. (Facoltativo) Aggiorna il menu Trigger di avviso, che contiene i seguenti valori:

      • Una serie temporale è in violazione: impostazione predefinita. Qualsiasi serie temporale che viola la soglia o per cui è prevista una violazione della soglia per l'intera finestra di nuovo test fa sì che la condizione venga soddisfatta.

      • Percentuale di serie temporali in violazione: una percentuale di serie temporali deve violare la soglia o essere prevista per violare la soglia per l'intera finestra di nuovo test prima che la condizione venga soddisfatta. Ad esempio, potresti ricevere una notifica quando il 50% delle serie temporali monitorate viola la soglia per l'intera finestra di nuovo test.

      • Numero di serie temporali in violazione: un numero specifico di serie temporali deve violare la soglia o essere previsto per violare la soglia per l'intera finestra di nuovo test prima che la condizione venga soddisfatta. Ad esempio, potresti ricevere una notifica quando 32 delle serie temporali monitorate violano la soglia per l'intera finestra di nuovo test.

      • Tutte le serie temporali sono in violazione: tutte le serie temporali devono violare la soglia o essere previste per violare la soglia per l'intera finestra di nuovo test prima che la condizione venga soddisfatta.

      Per informazioni sugli intervalli utilizzati da Monitoring per allineare e misurare i dati delle serie temporali, consulta Periodi di allineamento e finestre di riapprovazione.

    3. Seleziona un valore per la Finestra di previsione. Il valore selezionato corrisponde al periodo di tempo futuro per la previsione. Devi impostare questo valore su almeno 1 ora (3600 secondi) e su un massimo di 2,5 giorni (216.000 secondi).

    4. Inserisci quando il valore previsto della metrica selezionata viola la soglia utilizzando i campi Posizione soglia e Valore soglia. Ad esempio, se imposti questi valori su Sopra la soglia e 10, qualsiasi valore previsto superiore a 10 viola la soglia.

    5. (Facoltativo) Espandi Opzioni avanzate e imposta il valore della Finestra di ripetizione test. Il valore predefinito di questo campo è Nessun nuovo test.

      Ti consigliamo di impostare questo campo su almeno 10 minuti.

      Ad esempio, supponiamo di configurare la condizione di previsione in modo che qualsiasi serie temporale possa soddisfare la condizione. Supponi inoltre che la Finestra di ripetizione test sia impostata su 15 minuti, la Finestra di previsione sia impostata su 1 ora e che si verifichi una violazione quando il valore della serie temporale è superiore alla Soglia, impostata su 10. La condizione è soddisfatta se si verifica una delle seguenti condizioni:

      • Tutti i valori di una serie temporale diventano superiori a 10 e rimangono tali per almeno 15 minuti.
      • In un intervallo di 15 minuti, ogni previsione per una serie temporale prevede che il suo valore supererà la soglia di 10 entro l'ora successiva.
    6. (Facoltativo) Per specificare in che modo Monitoring valuta la condizione quando i dati smettono di arrivare, espandi Opzioni avanzate e poi utilizza il menu Valutazione dati mancanti.

      Il menu Dati mancanti nella valutazione è disabilitato quando il valore della Finestra di ripetizione del test è Nessuna ripetizione del test.

      Quando mancano dati per più di 10 minuti, una condizione di previsione smette di fare previsioni e utilizza invece il valore del campo Valutazione dati mancanti per determinare come gestire gli avvisi. Quando le osservazioni riprendono, viene riavviata la previsione.

      Google Cloud console
      Campo "Valutazione dei dati mancanti"
      Riepilogo Dettagli
      Dati mancanti vuoti Gli avvisi aperti rimangono aperti.
      I nuovi avvisi non vengono aperti.

      Le condizioni soddisfatte continuano a essere soddisfatte quando i dati smettono di arrivare. Se è aperto un avviso per questa condizione, l'avviso rimane aperto. Quando un avviso è aperto e non arrivano dati, il timer di chiusura automatica si avvia dopo un ritardo di almeno 15 minuti. Se il timer scade, l'avviso viene chiuso.

      Le condizioni non soddisfatte continuano a non essere soddisfatte quando i dati smettono di arrivare.

      Punti dati mancanti considerati come valori che violano la condizione della policy Gli avvisi aperti rimangono aperti.
      È possibile aprire nuovi avvisi.

      Per le condizioni soddisfatte, la condizione continua a essere soddisfatta quando i dati smettono di arrivare. Se è aperto un avviso per questa condizione, l'avviso rimane aperto. Quando un avviso è aperto e non arrivano dati per la durata della chiusura automatica più 24 ore, l'avviso viene chiuso.

      Per le condizioni non soddisfatte, questa impostazione fa sì che la condizione di soglia della metrica si comporti come un metric-absence condition. Se i dati non arrivano nel periodo di tempo specificato dalla finestra di ri-test, la condizione viene valutata come soddisfatta. Per una criterio di avviso con una condizione, il soddisfacimento della condizione comporta l'apertura di un avviso.

      Punti dati mancanti considerati come valori che non violano la condizione della policy Gli avvisi aperti vengono chiusi.
      Non vengono aperti nuovi avvisi.

      Le condizioni soddisfatte non vengono più soddisfatte quando i dati smettono di arrivare. Se è aperto un avviso per questa condizione, l'avviso viene chiuso.

      Le condizioni non soddisfatte continuano a non essere soddisfatte quando i dati smettono di arrivare.

    7. Fai clic su Avanti.

  6. (Facoltativo) Crea una criterio di avviso con più condizioni.

    La maggior parte delle policy monitora un singolo tipo di metrica, ad esempio il numero di byte scritti in un'istanza VM. Se vuoi monitorare più tipi di metriche, crea una policy con più condizioni. Ogni condizione monitora un tipo di metrica. Dopo aver creato le condizioni, specifica come vengono combinate. Per informazioni, vedi Policy con più condizioni.

    Per creare una criterio di avviso con più condizioni, segui questi passaggi:

    1. Per ogni condizione aggiuntiva, fai clic su Aggiungi condizione di avviso e poi configura la condizione.
    2. Fai clic su Avanti e configura la modalità di combinazione delle condizioni.
    3. Fai clic su Avanti per passare alla configurazione delle notifiche e della documentazione.
  7. Configura la notifica e aggiungi le etichette utente:

    1. Espandi il menu Notifiche e nome e seleziona i canali di notifica. Ai fini della ridondanza, ti consigliamo di aggiungere più tipi di canali di notifica a una criterio di avviso. Per saperne di più, consulta Gestire i canali di notifica.

    2. (Facoltativo) Per utilizzare un oggetto personalizzato nella notifica anziché quello predefinito, aggiorna il campo Oggetto della notifica.

    3. (Facoltativo) Per ricevere una notifica quando un avviso viene chiuso, seleziona Notifica alla chiusura dell'avviso. Per impostazione predefinita, quando crei una criterio di avviso con la console Google Cloud , viene inviata una notifica solo quando viene creato un avviso.

    4. (Facoltativo) Per modificare il tempo di attesa di Monitoring prima di chiudere un avviso dopo l'interruzione dell'invio dei dati, seleziona un'opzione dal menu Durata della chiusura automatica dell'avviso. Per impostazione predefinita, quando i dati smettono di arrivare, Monitoring attende sette giorni prima di chiudere un avviso aperto.

    5. (Facoltativo) Per associare la criterio di avviso a un'applicazione App Hub, nella sezione Etichette applicazione, seleziona un'applicazione e un servizio o un workload. Gli avvisi e le notifiche mostrano queste etichette.

    6. (Facoltativo) Seleziona un'opzione dal menu Livello di gravità della policy. Avvisi e notifiche mostrano il livello di gravità.

    7. (Facoltativo) Per aggiungere etichette personalizzate alla criterio di avviso, nella sezione Etichette utente policy, segui questi passaggi:

      1. Fai clic su Aggiungi etichetta e nel campo Chiave inserisci un nome per l'etichetta. I nomi delle etichette devono iniziare con una lettera minuscola e possono contenere lettere minuscole, numeri, trattini bassi e trattini. Ad esempio, inserisci severity.
      2. Fai clic su Valore e inserisci un valore per l'etichetta. I valori delle etichette possono contenere lettere minuscole, numeri, trattini bassi e trattini. Ad esempio, inserisci critical.

      Per informazioni su come utilizzare le etichette delle norme per gestire le notifiche, consulta Annotare gli avvisi con etichette.

  8. (Facoltativo) Nella sezione Documentazione, inserisci i contenuti che vuoi includere nella notifica.

    Per formattare la documentazione, puoi utilizzare testo normale, Markdown e variabili. Puoi anche includere link per aiutare gli utenti a eseguire il debug dell'avviso, ad esempio link a playbook interni, dashboard Google Cloud e pagine esterne. Ad esempio, il seguente modello di documentazione descrive un avviso di utilizzo della CPU per una risorsa gce_instance e include diverse variabili per fare riferimento alle risorse REST della condizione e della criterio di avviso. Il modello di documentazione indirizza poi i lettori a pagine esterne per aiutarli con il debug.

    Quando vengono create le notifiche, Monitoring sostituisce le variabili della documentazione con i relativi valori. I valori sostituiscono le variabili solo nelle notifiche. Il riquadro di anteprima e altri punti della console Google Cloud mostrano solo la formattazione Markdown.

    Anteprima

    ## CPU utilization exceeded
    
    ### Summary
    
    The ${metric.display_name} of the ${resource.type}
    ${resource.label.instance_id} in the project ${resource.project} has
    exceeded 90% for over 15 minutes.
    
    ### Additional resource information
    
    Condition resource name: ${condition.name}  
    Alerting policy resource name: ${policy.name}  
    
    ### Troubleshooting and Debug References
    
    Repository with debug scripts: example.com  
    Internal troubleshooting guide: example.com  
    ${resource.type} dashboard: example.com
    

    Formato nella notifica

    Esempio di come viene visualizzata la documentazione in una notifica.

    Per saperne di più, consulta Annota le notifiche con la documentazione definita dall'utente e Utilizzo dei controlli del canale.

  9. Fai clic su Nome avviso e inserisci un nome per la policy di avviso.

  10. Fai clic su Crea policy.

Filtra la serie temporale selezionata

I filtri assicurano che vengano monitorate solo le serie temporali che soddisfano un insieme di criteri. Quando applichi i filtri, potresti ridurre il numero di righe del grafico, il che può migliorare le prestazioni del grafico. Puoi anche ridurre la quantità di dati monitorati applicando l'aggregazione. I filtri assicurano che vengano utilizzate solo le serie temporali che soddisfano un insieme di criteri. Quando applichi i filtri, ci sono meno serie temporali da valutare, il che può migliorare il rendimento dell'avviso.

Un filtro è composto da un'etichetta, un comparatore e un valore. Ad esempio, per trovare tutte le serie temporali la cui etichetta zone inizia con "us-central1", puoi utilizzare il filtro zone=~"us-central1.*", che utilizza un'espressione regolare per eseguire il confronto.

Quando filtri in base all'ID progetto o al container di risorse, devi utilizzare l'operatore di uguaglianza (=). Quando filtri in base ad altre etichette, puoi utilizzare qualsiasi comparatore supportato. In genere, puoi filtrare le etichette delle metriche e delle risorse e per gruppo di risorse.

Quando fornisci più criteri di filtro, vengono monitorate solo le serie temporali che soddisfano tutti i criteri.

Per aggiungere un filtro, fai clic su Aggiungi filtro, completa la finestra di dialogo e poi fai clic su Fine. Nella finestra di dialogo, utilizza il campo Filtro per selezionare il criterio in base al quale filtrare, seleziona l'operatore di confronto e poi seleziona o inserisci il valore. Il menu a discesa elenca solo i valori visualizzati nell'ultima settimana, ma puoi inserire qualsiasi valore. Ogni riga della tabella seguente elenca un operatore di confronto, il relativo significato e un esempio:

OperatoreSignificatoEsempio
= Uguaglianza resource.labels.zone = "us-central1-a"
!= Disuguaglianza resource.labels.zone != "us-central1-a"
=~ Uguaglianza di espressione regolare2 monitoring.regex.full_match("^us.*")
!=~ Disuguaglianza Espressione regolare2 monitoring.regex.full_match("^us.*")
starts_with Il valore inizia con resource.labels.zone = starts_with("us")
ends_with Il valore termina con resource.labels.zone = ends_with("b")
has_substring Il valore contiene resource.labels.zone = has_substring("east")
one_of Una tra resource.labels.zone = one_of("asia-east1-b", "europe-north1-a")
!starts_with Il valore non inizia con resource.labels.zone != starts_with("us")
!ends_with Il valore non termina con resource.labels.zone != ends_with("b")
!has_substring Il valore non contiene resource.labels.zone != has_substring("east")
!one_of Il valore non è uno dei seguenti resource.labels.zone != one_of("asia-east1-b", "europe-north1-a")

Risoluzione dei problemi

Questa sezione contiene suggerimenti per la risoluzione dei problemi.

Metrica non elencata nel menu delle metriche disponibili

Per monitorare una metrica non elencata nel menu Seleziona una metrica, esegui una delle seguenti operazioni:

  • Per creare un criterio di avviso che monitora una metrica Google Cloud , espandi il menu Seleziona una metrica e poi fai clic su Attivo. Quando è disabilitato, il menu elenca tutte le metriche per i serviziGoogle Cloud e tutte le metriche con dati.

  • Per configurare una condizione per un tipo di metrica personalizzata prima che questo tipo di metrica generi dati, devi specificare il tipo di metrica utilizzando un filtro di monitoraggio:

    1. Seleziona ? nell'intestazione della sezione Seleziona metrica, quindi seleziona Modalità filtro diretto nella descrizione comando.
    2. Inserisci un filtro di monitoraggio o un selettore di serie temporali. Per informazioni sulla sintassi, consulta i seguenti documenti:

Monitora un tasso di variazione

Per monitorare il tasso di variazione di un valore della metrica, imposta il campo Funzione finestra mobile su variazione percentuale. Quando la condizione viene valutata, Monitoring calcola il tasso di variazione della metrica come percentuale e poi confronta questa percentuale con la soglia della condizione. Questo processo di confronto prevede due passaggi:

  1. Se la serie temporale ha un tipo di metrica DELTA o CUMULATIVE, viene convertita in una con tipo di metrica GAUGE. Per informazioni sulla conversione, consulta Kind, tipi e conversioni.
  2. Monitoring calcola la variazione percentuale confrontando il valore medio nella finestra temporale scorrevole di 10 minuti più recente con il valore medio della finestra temporale scorrevole di 10 minuti prima dell'inizio del periodo di allineamento.

Non puoi modificare la finestra mobile di 10 minuti utilizzata per i confronti in un criterio di avviso sul tasso di variazione. Tuttavia, devi specificare il periodo di allineamento quando crei la condizione.

Limitazioni

  • Puoi configurare la condizione utilizzando l'interfaccia basata su menu della consoleGoogle Cloud o utilizzando i filtri di Monitoring. Non puoi configurare la condizione utilizzando Monitoring Query Language o PromQL.
  • Sono supportate tutte le metriche con un tipo di valore double o int64, ad eccezione di quelle delle istanze VM di Amazon.

Passaggi successivi