Questa pagina spiega come configurare un avviso basato su log per un'appliance di backup/ripristino di Backup e RE utilizzando Esplora log nella Google Cloud console.
L'interfaccia di Esplora log per la creazione e la modifica di avvisi basati su log ti guida nei seguenti passaggi:
- Specifica un nome e una descrizione per l'avviso.
- Scegli i log per i quali vuoi ricevere una notifica.
- Imposta l'orario tra le notifiche.
- Imposta l'orario per la chiusura automatica degli incidenti.
- Specifica a chi inviare la notifica.
Puoi scoprire di più su Esplora log in Visualizzare e analizzare i log.
Autorizzazioni e ruoli
Per creare e gestire avvisi basati su log in Esplora log, il tuo ruolo Identity and Access Management (IAM) deve includere il set di autorizzazioni descritto in Autorizzazioni per gli avvisi basati su log.
Crea un avviso basato su log per un'appliance di backup/ripristino
Per attivare un avviso, devi disporre di un canale di notifica. Puoi creare il canale di notifica prima di creare un avviso o durante la creazione di un avviso.
Per creare un avviso basato su log:
- Nella Google Cloud console, seleziona Logging e poi Esplora log.
Utilizza il riquadro Query per definire l'evento per il quale vuoi ricevere una notifica. Puoi utilizzare gli esempi di query mostrati in query di esempio nel riquadro Query per configurare gli avvisi.
Di seguito è riportata la query di esempio per ricevere una notifica su un evento con un ID evento specifico.
logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" jsonPayload.eventId=10046Nell'intestazione del riquadro Risultati query, fai clic su Crea avviso. Se la finestra è troppo stretta, l'opzione Crea avviso viene visualizzata nel menu Azioni.
Nel riquadro Dettagli avviso, assegna un nome e una descrizione all'avviso:
- Inserisci un nome per l'avviso nel campo Nome criterio di avviso. Questo nome viene visualizzato nell'intestazione della notifica.
- Nel campo Documentazione, inserisci la descrizione dell'avviso. Per informazioni su come formattare e perfezionare i contenuti di questo campo, consulta Utilizzo di Markdown e variabili nei modelli di documentazione. Includi l'URL della console di gestione dell'appliance nel campo della documentazione. Puoi anche aggiungere la soluzione alternativa per risolvere l'evento.
Fai clic su Avanti.
Nel riquadro Scegli i log da includere nell'avviso, procedi nel seguente modo:
- Controlla la query e i risultati facendo clic su Anteprima dei log. Se necessario, puoi anche modificare la query in questo riquadro.
Puoi aggiungere etichette per personalizzare le notifiche e renderle più informative. Fai clic su Aggiungi un'etichetta e procedi nel seguente modo:
- Inserisci un Nome visualizzato per l'etichetta.
- Seleziona Nome campo log dall'elenco. Questi campi vengono visualizzati in base al risultato della query selezionata.
- Inserisci Espressione regolare per estrarre un valore dal campo che deve contenere esattamente un gruppo di espressioni regolari.
Fai clic su Avanti.
Seleziona il tempo minimo tra le notifiche. Questo valore ti consente di controllare il numero di notifiche che ricevi da questo avviso se viene attivato più volte. Ad esempio, puoi selezionare 5 min dalle opzioni per limitare le notifiche a ogni cinque minuti. Se applicabile, puoi modificare la durata della chiusura automatica dell'incidente selezionando un'opzione dal menu.
Fai clic su Avanti.
Seleziona uno o più canali di notifica per l'avviso, ad esempio un canale di notifica via email. Se hai già configurato un canale di notifica via email, puoi selezionarlo dall'elenco. In caso contrario, fai clic su Gestisci canali di notifica e aggiungi un canale email. Per informazioni sulla creazione di canali di notifica, consulta Crea e gestisci i canali di notifica.
Fai clic su Salva.
È consigliabile configurare gli avvisi per gli ID evento importanti Event IDs.
Verifica l'avviso basato su log
Per verificare l'avviso basato su log che hai creato, puoi scrivere manualmente una voce di log che corrisponda alla query. Per scrivere la voce di log:
Vai alla pagina di riferimento
logEntries.writeo fai clic sul pulsante seguente:Configura la seguente voce di log modificando la PROJECT_ID variabile con l'ID progetto. Se il criterio di avviso include o esclude ID evento specifici, devi modificare anche l'ID evento:
"entries": [ { "jsonPayload": { "eventId": 10046, "errorMessage": "this is a manually generated error message created for testing" }, "resource": { "type": "backupdr.googleapis.com/BackupRecoveryAppliance", }, "severity": "ERROR", "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events", } ]Copia la voce di log che hai configurato in precedenza.
Nel riquadro Prova questa API, procedi nel seguente modo:
- Sostituisci i contenuti nel campo Corpo della richiesta in Explorer API con la voce di log che hai copiato nel passaggio precedente.
- Fai clic su Esegui. Se ti viene richiesto, segui il flusso di autenticazione.
Se la chiamata logEntries.write ha esito positivo, riceverai un codice di risposta HTTP 200 e un corpo della risposta vuoto, {}. Per ulteriori informazioni su Explorer API, consulta Utilizzare Explorer API. Explorer API funziona allo stesso modo con l'API Cloud Logging.
La voce di log corrisponde al filtro specificato per l'avviso nei seguenti modi:
- Il valore logName specifica l'accesso all'evento dell'appliance di backup/ripristino per il tuo progetto Cloud.
- Il valore di gravità per questa voce di log è ERROR.
- jsonPayload contiene un evento di pool pieno 10046.
Dopo aver scritto la voce di log, si verifica la seguente sequenza:
- La nuova voce di log viene visualizzata in "Esplora log e attiva l'avviso.
- Viene aperto un incidente in Cloud Monitoring.
- Riceverai una notifica per l'incidente. Se hai configurato un canale di notifica via email, la notifica viene visualizzata.
Puoi fare clic su Visualizza incidente nell'email per visualizzare l'incidente in Cloud Monitoring. Per ulteriori informazioni sugli incidenti, inclusa la procedura per riconoscerli e chiuderli, consulta Gestire gli incidenti per gli avvisi basati su log.
Crea più criteri di avviso
Potresti voler creare criteri di avviso in base alla priorità e all'urgenza degli eventi. Dal punto di vista degli avvisi, gli eventi possono essere suddivisi nelle seguenti categorie:
Eventi che devono essere gestiti con urgenza e che quindi richiedono notifiche più frequenti. Ad esempio, l'ID evento 43901 (job di snapshot non riuscito) deve essere segnalato ogni 30 minuti. Utilizza la seguente query per creare l'avviso.
Policyname = 'Snapshot job has failed' Notification rate limit = 30 min logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.eventId=43901Eventi meno urgenti e che quindi richiedono notifiche meno frequenti. Ad esempio, l'ID evento 10085 (violazioni del piano di backup) deve essere segnalato solo una volta al giorno. Utilizza la seguente query per creare l'avviso.
Policyname = 'Backup Plan Violation has occurred' Notification rate limit = 1 day logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.eventId=10085Eventi non impattanti che possono essere ignorati. Ad esempio, gli ID evento 10229 (errori di spazio di archiviazione superato) e 42356 (sono state rilevate modifiche ai file) possono essere ignorati, in quanto sono falsi positivi. Utilizza la seguente query per creare l'avviso.
Policyname = 'Backup/DR event has occurred' Notification rate limit = 6 hr logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND NOT jsonPayload.eventId=(10085 OR 10229 OR 42356 OR 43901)