Questa pagina descrive come visualizzare un log di controllo per un backup automatico dell'istanza Cloud SQL.
Puoi utilizzare i log di controllo per:
- Visualizza un audit log per verificare se il backup è stato completato correttamente.
- Configura un avviso basato su log per ricevere una notifica sullo stato del backup.
Visualizzare un audit log
Puoi utilizzare la console Google Cloud , gcloud CLI
o l'API per visualizzare un log di controllo e verificare se un backup è stato completato correttamente entro una finestra di backup.
Console
Nella console Google Cloud , seleziona Logging e poi Esplora log.
Per filtrare i log di controllo per i backup automatici delle istanze Cloud SQL, esegui la seguente query:
logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event" protoPayload.methodName="cloudsql.instances.automatedBackup" resource.type="cloudsql_database"
Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud .
La prima espressione filtra gli audit log degli eventi di sistema. La seconda espressione filtra i log di controllo per i backup automatici. I filtri di espressione finali per gli audit log per le istanze Cloud SQL.
Per maggiori informazioni su come utilizzare la console Google Cloud per eseguire query per i log di controllo, vedi Visualizzare i log.
Visualizza lo stato di un backup creato durante la finestra di backup. Questo stato viene visualizzato nel campo
windowStatus
. Per visualizzare questo campo, completa i seguenti passaggi:- Fai clic sul log di controllo.
- Fai clic sul campo
metadata
.
gcloud
Per filtrare i log di controllo per i backup automatici delle istanze Cloud SQL, esegui la seguente query:
gcloud logging read \ "logName=projects/PROJECT_NAME/logs/cloudaudit.googleapis.com%2Fsystem_event AND protoPayload.methodName=cloudsql.instances.automatedBackup AND resource.type=cloudsql_database" \ --project=PROJECT_NAME
Sostituisci PROJECT_NAME con il nome del tuo progetto Google Cloud .
La prima espressione filtra gli audit log degli eventi di sistema. La seconda espressione filtra i log di controllo per i backup automatici. I filtri di espressione finali per gli audit log per le istanze Cloud SQL.
Per ulteriori informazioni su come utilizzare
gcloud
per eseguire query per i log di controllo, vedi Visualizzare i log.Visualizza lo stato di un backup creato durante la finestra di backup. Questo stato viene visualizzato nel campo
windowStatus
.
API
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo Google Cloud progetto.
Per il corpo JSON della richiesta, la prima espressione filtra i log di controllo degli eventi di sistema. La seconda espressione filtra i log di controllo per i backup automatici. I filtri di espressione finali per gli audit log per le istanze Cloud SQL.
Per ulteriori informazioni su come utilizzare l'API per eseguire query sui log di controllo, vedi Visualizzare i log.
Metodo HTTP e URL:
POST https://logging.googleapis.com/v2/entries:list
Corpo JSON della richiesta:
{ "resourceNames": [ "projects/PROJECT_ID" ], "pageSize": 5, "filter": "logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event AND protoPayload.methodName = cloudsql.instances.automatedBackup AND resource.type=cloudsql_database", "orderBy": "timestamp desc" }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
Per ulteriori informazioni su LOG_ENTRY_UNIQUE_IDENTIFIER
per il campo insertId
, vedi
LogEntry.
Visualizza lo stato di un backup creato durante la finestra di backup. Questo stato viene visualizzato nel campo windowStatus
.
Stati dei backup automatici
STATUS_SUCCEEDED
: Il backup automatico è stato completato correttamente.STATUS_ATTEMPT_FAILED
: Cloud SQL ha tentato di creare il backup, ma il backup non è stato avviato o non è riuscito. I motivi di questo stato includono:- È in corso un altro backup sull'istanza.
- La posizione di backup è limitata dai criteri della tua organizzazione.
- Il backup dell'istanza è stato completato, ma si è verificato un errore.
- L'istanza non era in esecuzione quando Cloud SQL ha tentato di creare il backup.
STATUS_FAILED
: il backup automatico dell'istanza non è stato completato correttamente o non può essere completato entro la finestra di backup.Ad esempio, se hai attivato i backup automatici e hai pianificato la finestra di backup tra le 01:00 e le 05:00, il backup potrebbe non riuscire se hai molte operazioni
EXPORT
durante questo periodo di tempo. I backup automatici potrebbero non riuscire anche se si verificano troppi conflitti con un'operazioneEXPORT
in esecuzione per un lungo periodo di tempo.Se Cloud SQL tenta di creare un backup più volte durante una finestra di backup, ma il backup non può essere creato per i motivi elencati per
STATUS_ATTEMPT_FAILED
, Cloud SQL genera un altro log di controllo con il campowindowStatus
impostato suSTATUS_FAILED
.STATUS_SKIPPED
: l'istanza Cloud SQL ha smesso di funzionare dall'ultimo backup riuscito. Pertanto, non è stato creato un nuovo backup automatico.
Configurare un avviso basato su log
Puoi configurare un avviso basato su log per ricevere una notifica sullo stato del backup.
- Se un backup ha lo stato
STATUS_SUCCEEDED
, puoi ricevere una notifica a scopo di monitoraggio. - Se un backup ha lo stato
STATUS_FAILED
oSTATUS_ATTEMPT_FAILED
, puoi ricevere una notifica per intraprendere un'azione correttiva, in base al messaggio visualizzato nella voce di log. Puoi anche eseguire un backup on demand prima della successiva finestra di backup pianificata. - Se un backup ha lo stato
STATUS_SKIPPED
, puoi ricevere una notifica per riavviare l'istanza Cloud SQL.
Passaggi successivi
- Scopri di più sul backup dei dati.
- Scopri di più sulla creazione e la gestione dei backup.
- Scopri di più sul ripristino dei dati.
- Scopri di più sul recupero point-in-time.
- Scopri come ripristinare i dati da un backup.
- Scopri come eseguire un recupero point-in-time.