Configurare avvisi con query pianificate

Questo documento descrive come configurare un avviso utilizzando una query pianificata BigQuery. Questo approccio supporta i casi d'uso personalizzati definiti dalla logica delle query.

Prima di iniziare

Prima di utilizzare Cloud Monitoring, assicurati di disporre di quanto segue:

• Un account di fatturazione Cloud.
• Un progetto BigQuery con fatturazione abilitata.

Un modo per assicurarti di avere entrambi è completare la guida rapida all'utilizzo della console. Trusted Cloud

Crea una query SQL

Crea ed esegui una query SQL in BigQuery che generi l'output per l'avviso. La query acquisisce la logica che vuoi monitorare. Per maggiori informazioni, vedi Eseguire una query.

Configurare una query programmata

Puoi pianificare l'esecuzione delle query su base ricorrente, da ogni 15 minuti a ogni diversi mesi. Puoi scrivere qualsiasi query sui bucket di log. Per ulteriori informazioni, consulta la sezione Pianificazione delle query.

Informazioni sulla metrica Conteggio righe

Le query pianificate creano automaticamente una metrica in Cloud Monitoring. Questa metrica registra il numero di righe restituite dalla query SQL durante l'ultima valutazione. Puoi creare un criterio di avviso che monitora questa metrica del conteggio delle righe in Monitoring.

La seguente metrica è un indicatore che contiene il conteggio delle righe più recente di una query pianificata:

bigquerydatatransfer.googleapis.com/transfer_config/last_execution_job_rows

Tutte le query pianificate scrivono il conteggio delle righe in questa metrica, utilizzando etichette diverse. Quando definisci un criterio di avviso, devi utilizzare l'etichetta config_id. Per trovare l'etichetta config_id, segui questi passaggi:

1. Nella console Trusted Cloud , vai alla pagina Query programmate:

   Vai a Query programmate

2. Fai clic sulla query programmata per cui vuoi creare un avviso.

3. Vai alla scheda Dettagli.

4. Controlla l'ultima stringa in Nome risorsa, come mostrato nello screenshot seguente:

   

Se si verifica un problema con la query pianificata, viene visualizzato un messaggio di errore nella scheda Cronologia esecuzioni della query pianificata.

Monitorare le query pianificate

Monitora le query pianificate per assicurarti che vengano eseguite correttamente:

• Controlla la presenza di errori nella scheda Cronologia esecuzioni della query pianificata.
• Controlla lo stato finale di ogni esecuzione pianificata memorizzata nel campo completion_state della metrica bigquerydatatransfer.googleapis.com/transfer_config/completed_runs.
• Cerca errori nei log di BigQuery Data Transfer Service.

Crea una policy di avviso

Utilizza un avviso di superamento della soglia di una metrica per rilevare quando il numero di righe restituite dalla query pianificata differisce da una soglia.

Per configurare un avviso sul numero di righe restituite da una query pianificata:

1. Nella Trusted Cloud console, vai alla pagina notifications Avvisi:

   Vai ad Avvisi

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

2. Fai clic su Crea criterio.

3. Seleziona la metrica del conteggio delle righe per la query pianificata. Nel menu Seleziona una metrica, fai clic su Configurazione DTS BigQuery > Transfer_config > Conteggio righe dell'ultimo job eseguito.

4. In Aggiungi filtri, fai clic su Aggiungi un filtro.

5. Nel menu Filtro, seleziona config_id.

6. Nel menu Valore, seleziona il config_id della query pianificata per cui vuoi creare un avviso:

   

   Se non imposti un filtro, l'avviso verifica l'output di ogni query pianificata. Per trovare il config_id della query pianificata, consulta Informazioni sulla metrica Conteggio righe.

7. Mantieni le impostazioni predefinite di Trasforma i dati e fai clic su Avanti.

8. Per Tipi di condizione, seleziona Soglia.

9. Seleziona la condizione che preferisci. Ad esempio, per attivare il trigger quando la query restituisce righe, imposta la seguente condizione:

   1. Per Attivatore di avvisi, seleziona Qualsiasi violazione della serie temporale.
   2. In Posizione soglia, seleziona Sopra la soglia.
   3. In Valore soglia, inserisci 0.

10. Mantieni le Opzioni avanzate predefinite e fai clic su Avanti.

11. (Facoltativo) Per configurare le notifiche per l'avviso, fai clic sul pulsante di attivazione/disattivazione Usa canale di notifica, quindi imposta i canali e l'oggetto per le notifiche. Puoi anche impostare notifiche per la chiusura degli incidenti.

    Se non vuoi ricevere notifiche, deseleziona il pulsante di attivazione/disattivazione Usa canale di notifica.

12. (Facoltativo) Se hai molte norme di avviso, puoi annotare le etichette per indicare che derivano da query pianificate.

13. (Facoltativo) Nel campo Documentazione, puoi aggiungere link che aiutano a interpretare l'avviso. Ad esempio, puoi aggiungere un link alla pagina Esplora log con una query simile, in modo da poter esplorare i dati che hanno generato l'avviso. Puoi anche inserire un link alla pagina dei dettagli della query di pianificazione specifica.

14. In Assegna un nome alla policy di avviso, inserisci un nome per l'avviso.

15. Fai clic su Crea criterio.

Limitazioni

I criteri di avviso per le query pianificate sono soggetti alle seguenti limitazioni:

• La frequenza di esecuzione delle query pianificate e il ritardo di importazione influiscono sul tempo totale dall'emissione del log all'avviso. Ad esempio, se la query viene eseguita ogni 30 minuti e aggiungi un ritardo di 15 minuti per l'importazione, l'avviso viene attivato circa 15 minuti dopo l'emissione di una voce di log incriminata. In alcuni casi, l'operazione potrebbe richiedere fino a 45 minuti.
• La configurazione tra una query pianificata e un criterio di avviso non è collegata o sincronizzata. La modifica della configurazione in un'unica posizione potrebbe interrompere la relazione che attiva la funzione di avviso.

Passaggi successivi

• Scopri come creare ed eseguire query pianificate.