Configurare le notifiche per le metriche basate su log

Questo documento spiega come configurare le notifiche quando una metrica basata sui 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 console Google Cloud . Puoi anche creare policy di avviso utilizzando l'API Cloud Monitoring e il comando Google Cloud CLI gcloud alpha monitoring policies.

I criteri di avviso che monitorano le metriche basate su log non possono estrarre 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. Verifica che il tuo ruolo Identity and Access Management includa le autorizzazioni necessarie per creare e visualizzare metriche basate su log e per creare policy di avviso. Per maggiori dettagli, vedi Autorizzazioni per le metriche basate su log.

  2. Verifica di avere familiarità con le metriche basate su log. Per saperne di più, 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, vedi Creare e gestire i canali di notifica.

Crea un criterio di avviso su una metrica di conteggio

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

Visualizzazione del pulsante Visualizza log su una notifica.

Per creare un criterio di avviso che confronta il valore di una metrica di conteggio basata su log con una soglia:

  1. Nella console Google Cloud , 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. Trova la metrica che vuoi monitorare, fai clic su Altro, quindi seleziona Crea avviso da metrica.

  3. Verifica che nel campo Seleziona una metrica siano elencati 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 grande da garantire che vengano conteggiate più voci di log che corrispondono al tuo filtro.

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

  5. Fai clic su Avanti e seleziona Soglia.

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

  7. (Facoltativo) Aggiorna la Finestra di ritest e utilizza i campi Opzioni avanzate per configurare il modo in cui lacriterio di avvisoo 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 di log nella documentazione. I criteri di avviso che monitorano una metrica basata su log non possono estrarre dati dalle voci di log.

  10. Nel campo Assegna un nome alla policy di avviso, inserisci un nome per la criterio 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