Panoramica degli avvisi

Questo documento descrive come ricevere una notifica quando l'applicazione non funziona o quando il rendimento di un'applicazione non soddisfa i criteri definiti.

Come funzionano gli avvisi

Il processo di avviso di Cloud Monitoring è composto da tre parti:

  • Una policy di avviso, che descrive le circostanze in cui vuoi ricevere un avviso e come vuoi ricevere una notifica relativa a un incidente. Il criterio di avviso può monitorare i dati delle serie temporali archiviati da Monitoring o i log archiviati da Cloud Logging. Quando questi dati soddisfano la condizione del criterio di avviso, Monitoring crea un incidente e invia le notifiche.

  • Ogni incidente è un record del tipo di dati monitorati e del momento in cui sono state soddisfatte le condizioni. Queste informazioni possono aiutarti a risolvere i problemi che hanno causato l'incidente.

  • Un canale di notifica definisce come ricevi le notifiche quando Monitoring crea un incidente. Ad esempio, puoi configurare una criterio di avviso per inviare un'email a my-support-team@example.com e pubblicare un messaggio Slack nel canale #my-support-team. Una criterio di avviso può contenere uno o più canali di notifica.

I criteri di avviso possono valutare tre tipi di dati:

  • Dati delle serie temporali, chiamati anche dati delle metriche, archiviati da Monitoring. Questi tipi di criteri sono chiamati criteri di avviso basati su metriche.

    Per scoprire come configurare un criterio di avviso basato su metriche, prova la guida rapida per Compute Engine.

  • Dati delle voci di log archiviati da Cloud Logging. I criteri di avviso che valutano le singole voci di log sono chiamati criteri di avviso basati su log. I criteri di avviso basati su log ti inviano una notifica quando nei log viene visualizzato un messaggio specifico. Per saperne di più, consulta Monitorare i log.

  • I risultati di una query SQL eseguita in Observability Analytics sui dati voce di log archiviati in Logging. I criteri di avviso che monitorano i risultati di una query SQL sono chiamati criteri di avviso basati su SQL. Per saperne di più, consulta Monitorare i risultati delle query SQL con un criterio di avviso.

    I criteri di avviso basati su SQL sono in anteprima pubblica.

Il processo di avviso ti aiuta a rispondere ai problemi quando il rendimento di un'applicazione non raggiunge i valori accettabili. Ad esempio, esegui il deployment di un'applicazione web su un'istanza di macchina virtuale (VM) Compute Engine. Sebbene ti aspetti che la latenza della risposta HTTP fluttui, vuoi che il tuo team di assistenza risponda quando l'applicazione ha una latenza elevata per un periodo di tempo significativo. Puoi creare un criterio di avviso basato su metriche che monitora la metrica della latenza della risposta HTTP dell'applicazione. Se la latenza della risposta è superiore a due secondi per almeno cinque minuti, Monitoring crea un incidente e invia notifiche via email al tuo team di assistenza.

Come creare una criterio di avviso

Esistono diversi modi per creare un criterio di avviso. Ad esempio, puoi utilizzare i criteri di avviso preconfigurati attivando gli avvisi consigliati dalle integrazioni o da determinate pagine della Google Cloud console. Puoi anche configurare un nuovo criterio di avviso utilizzando la Google Cloud console, l'API Cloud Monitoring, la Google Cloud CLI e Terraform.

Utilizzare le integrazioni e i criteri di avviso consigliati

Monitoring fornisce pacchetti predefiniti per consentirti di creare criteri di avviso per i tuoi Google Cloud servizi e le integrazioni di terze parti. I pacchetti includono criteri di avviso consigliati, dashboard di esempio e metriche chiave per il servizio. Questi pacchetti sono disponibili per Google Cloud servizi come Google Kubernetes Engine, Compute Engine e Cloud SQL, nonché per integrazioni di terze parti comuni come MongoDB, Kafka ed Elasticsearch.

Quando installi un pacchetto, puoi attivare i criteri di avviso consigliati del pacchetto. Quando attivi un criterio di avviso consigliato, configuri il relativo canale di notifica e, facoltativamente, modifichi altri valori. Dopo la configurazione, il criterio di avviso inizia immediatamente a monitorare la destinazione, senza richiedere ulteriori input utente.

I criteri di avviso consigliati sono utili quando hai eseguito il deployment di un nuovo servizio e vuoi ricevere avvisi sulle metriche importanti. Ad esempio, il pacchetto di integrazione di Cloud SQL include criteri di avviso consigliati per le istanze non riuscite e le transazioni lente:

Due delle policy di avviso consigliate per il pacchetto di integrazione di Cloud SQL.

Per saperne di più, consulta i seguenti documenti:

Creare nuovi criteri di avviso

Puoi creare criteri di avviso per monitorare diversi tipi di dati a seconda delle tue esigenze di avviso. Le sezioni seguenti elencano i diversi tipi di dati che puoi monitorare con i criteri di avviso.

Monitorare i dati delle serie temporali

Tipo di condizione Descrizione Esempio
Condizione di soglia metrica

Le condizioni di soglia metrica vengono soddisfatte quando i valori di una metrica sono maggiori o minori di una soglia per una finestra di ritest specifica.

Per saperne di più, consulta Creare criteri di avviso di soglia metrica e Creare criteri di avviso utilizzando l'API.

Vuoi una criterio di avviso che invii una notifica quando la latenza della risposta è di 500 ms o superiore per cinque controlli di uptime consecutivi in 10 minuti.
Condizione di assenza metrica

Le condizioni di assenza metrica vengono soddisfatte quando una serie temporale monitorata non ha dati per una finestra di ritest specifica. La finestra di ritest massima è 24 ore.

Per saperne di più, consulta Creare criteri di avviso di assenza metrica e Creare criteri di avviso utilizzando l'API.

Vuoi una criterio di avviso che apra un incidente con il tuo team di assistenza quando una risorsa non risponde a nessuna richiesta HTTP nell'arco di cinque minuti.
Condizione di Prometheus Query Language (PromQL)

PromQL è un linguaggio di query funzionale utilizzato per valutare i dati delle serie temporali in tempo reale. Le query PromQL possono utilizzare qualsiasi espressione valida, come combinazioni di metriche, rapporti e soglie dinamiche basate su una metrica.

Per saperne di più, consulta PromQL in Cloud Monitoring e Panoramica degli avvisi PromQL.

Vuoi utilizzare un'espressione di avviso PromQL trovata in un repository pubblico , un criterio di avviso basato su più di una metrica, ad esempio un rapporto, o un criterio di avviso che opera su più di 25 ore di dati.
Condizione di valore della metrica previsto

Le condizioni di valore della metrica previsto vengono soddisfatte quando la criterio di avviso prevede che la soglia verrà violata nella finestra di previsione imminente. La finestra di previsione può variare da 1 ora a 7 giorni.

Per saperne di più, consulta Creare criteri di avviso di valore della metrica previsto e Creare criteri di avviso utilizzando l'API.

Vuoi un criterio di avviso che apra un incidente con il tuo team di assistenza quando è probabile che una risorsa raggiunga l'80% di utilizzo dello spazio su disco nelle prossime 24 ore.

Ti consigliamo di filtrare le etichette definite sui tipi di risorse monitorate anziché le etichette definite sui tipi di metriche se possibile, soprattutto se esegui query su metriche con cardinalità elevata. Se hai un'etichetta di risorsa e un'etichetta di metrica che acquisiscono informazioni simili, utilizza l'etichetta di risorsa nelle query.

Ad esempio, se la risorsa monitorata include un'cluster etichetta e la metrica include un'kubernetes_cluster_name etichetta che acquisisce informazioni simili, filtra l'etichetta di risorsa cluster etichetta.

Quando selezioni le serie temporali per i criteri di avviso sensibili, non fare affidamento sui valori delle etichette dei metadati delle risorse definiti dal sistema o dall'utente. Utilizza invece i valori delle etichette definite dai tipi di risorse monitorate.

Le etichette dei metadati delle risorse vengono aggiunte in modo asincrono alle serie temporali e non sono soggette alle stesse aspettative di latenza dei valori delle etichette definite dai tipi di metriche o dai tipi di risorse monitorate. Di conseguenza, un criterio di avviso che dipende dai valori dei metadati per attivare un'azione può comportarsi in modo irregolare se la popolazione delle etichette dei metadati delle risorse è ritardata.

Monitorare i dati voce di log

Per monitorare le singole voci di log, utilizza un criterio di avviso basato su log. Una condizione di una criterio di avviso basata su log viene soddisfatta quando la policy di avviso rileva che una frase di una voce di log corrisponde ai criteri della criterio di avviso. Ad esempio, vuoi un criterio di avviso che apra un incidente con il tuo team di assistenza quando una voce di log message contiene product_ids=['tier_1_support', 'tier_2_support'].

Per saperne di più, consulta Configurare i criteri di avviso basati su log nella documentazione di Logging.

Monitorare i risultati delle query SQL

Per monitorare i risultati delle query SQL, utilizza una criterio di avviso basata su SQL. La condizione di un criterio di avviso basato su SQL analizza periodicamente i dati voce di log e crea incidenti quando la tabella dei risultati delle query soddisfa determinati criteri. Questo tipo di criterio di avviso è utile quando hai bisogno di un criterio di avviso che monitori le aggregazioni di dati o pattern complessi in più voci di log. Ad esempio, vuoi ricevere una notifica quando più di 50 voci di log negli ultimi 60 minuti hanno una gravità di WARNING.

Per saperne di più, consulta Monitorare i risultati delle query SQL con un criterio di avviso nella documentazione di Logging.

Componenti delle policy di avviso

Ogni criterio di avviso ha i seguenti componenti:

  • Una condizione che descrive quando una risorsa o un gruppo di risorse si trova in uno stato che richiede una risposta. La condizione include l'origine dati, una soglia statica o dinamica e metodi di aggregazione dei dati come filtri e raggruppamenti. Le condizioni possono monitorare una singola metrica, più metriche o un rapporto di metriche. Puoi anche utilizzare Prometheus Query Language (PromQL) per includere espressioni complesse come soglie dinamiche e logica condizionale.

    Se utilizzi un'integrazione per attivare un criterio di avviso consigliato, la condizione del criterio di avviso viene precompilata.

  • Un elenco di canali di notifica che descrivono a chi inviare una notifica quando è richiesta un'azione. Per saperne di più, consulta Crea e gestisci canali di notifica.

  • Documentazione visualizzata nelle notifiche e nelle pagine degli incidenti. Puoi configurare la riga dell'oggetto di una notifica e puoi aggiungere informazioni utili al corpo della notifica. Ad esempio, puoi configurare la notifica in modo che visualizzi i link ai playbook interni o a Google Cloud pagine, ad esempio le dashboard personalizzate. Per saperne di più sulla documentazione, inclusi esempi, consulta Annotare gli incidenti con la documentazione definita dall'utente.

Gestire i criteri di avviso e gli incidenti

Dopo l'attivazione di una criterio di avviso, Monitoring monitora continuamente le condizioni di tale policy. Non puoi configurare il criterio di avviso in modo che monitori le condizioni solo per determinati periodi di tempo. Se vuoi disattivare la criterio di avviso per un determinato periodo di tempo, crea un' opzione di posticipo.

Se un incidente è aperto e Monitoring determina che le condizioni del criterio basato su metriche non sono più soddisfatte, Monitoring chiude automaticamente l'incidente e invia una notifica relativa alla chiusura.

Prezzi

Per scoprire i prezzi di Cloud Monitoring, consulta la pagina dei prezzi di Google Cloud Observability.

Per informazioni su come monitorare il numero di intervalli di traccia o log importati o su come ricevere una notifica quando contenuti specifici sono inclusi in una voce di log, consulta i seguenti documenti:

Passaggi successivi