Configurare le notifiche per le metriche basate su log

Questo documento spiega come configurare le notifiche quando una metrica basata su log corrisponde ai criteri specificati. Queste istruzioni, che ti guidano nella creazione di un criterio di avviso e nella configurazione dei canali di notifica, sono per la Google Cloud console. Puoi anche creare criteri di avviso utilizzando l'API Cloud Monitoring e il comando gcloud alpha monitoring policies di Google Cloud CLI.

I criteri di avviso che monitorano le metriche basate su log non possono estrarre i dati dalle voci di log. Se vuoi che una notifica estragga i dati da una voce di log, crea un avviso basato su log.

Prima di iniziare

  1. Assicurati che il tuo ruolo Identity and Access Management includa le autorizzazioni necessarie per creare e visualizzare le metriche basate su log e per creare criteri di avviso. Per maggiori dettagli, consulta Autorizzazioni delle metriche basate su log.

  2. Assicurati di avere familiarità con le metriche basate su log. Per ulteriori informazioni, consulta la panoramica delle metriche basate su log.

  3. Configura i canali di notifica che vuoi utilizzare per ricevere le notifiche. Per informazioni su questi passaggi, consulta Creare e gestire i canali di notifica.

Creare un criterio di avviso per una metrica del contatore

Un criterio di avviso descrive un insieme di condizioni che vuoi monitorare. Quando crei un criterio di avviso, devi specificare anche le relative condizioni: cosa viene monitorato e quando inviare le notifiche. Le notifiche includono informazioni sull'incidente e pulsanti che ti consentono di visualizzare i log e i dettagli dell'incidente pertinenti:

Visualizzazione del pulsante per visualizzare i log in una notifica.

Per creare un criterio di avviso che confronti il valore di una metrica del contatore basata su log con una soglia:

  1. Nella Google Cloud console, vai alla pagina Metriche basate su log:

    Vai a Metriche basate su log.

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

  2. Individua la metrica da monitorare, fai clic su Altro, quindi seleziona Crea avviso da metrica.

  3. Assicurati che il campo Seleziona una metrica elenchi un metric.type e un resource.type. Se necessario, aggiungi una clausola resource.type.

    Ad esempio, il seguente filtro specifica una metrica e una risorsa:

    metric.type="logging.googleapis.com/byte_count"
AND resource.type="gce_instance"

  4. Nel menu Finestra mobile, ti consigliamo di selezionare un valore di almeno 10 minuti. In particolare, questo valore deve essere sufficientemente elevato da garantire il conteggio di più voci di log corrispondenti al filtro.

    Ad esempio, se una metrica basata su log conteggia le voci di log "heartbeat", che si verificano ogni N minuti, imposta il valore del menu Finestra mobile su 2N minuti o 10 minuti, a seconda del valore maggiore.

  5. Fai clic su Avanti, seleziona Soglia.

  6. Inserisci un Valore soglia e, facoltativamente, configura i campi Attivazione avviso e Posizione soglia.

  7. (Facoltativo) Aggiorna la finestra di nuovo test e utilizza i campi Opzioni avanzate per configurare il modo in cui il criterio di avviso gestisce i dati mancanti. In genere, l'impostazione predefinita è appropriata.

  8. Fai clic su Avanti, poi su Canali di notifica e seleziona i canali di notifica che vuoi utilizzare per il criterio di avviso.

  9. (Facoltativo) Nella sezione Documentazione, inserisci tutte le informazioni che vuoi includere nelle notifiche. In genere, le informazioni includono informazioni su come rispondere alla notifica.

    Non includere l'estrazione delle etichette dalle voci dei log nella documentazione. I criteri di avviso che monitorano una metrica basata su log non possono estrarre i dati dalle voci di log.

  10. Nel campo Assegna un nome alla policy di avviso, inserisci un nome per la policy di avviso.

  11. Fai clic su Crea criterio.

Risoluzione dei problemi

Se riscontri problemi, consulta Risolvere i problemi relativi alle metriche basate su log.

Passaggi successivi