Visualizzare gli audit log per i backup automatici

In questa pagina viene descritto come visualizzare un log di controllo per un backup automatico di Cloud SQL.

Puoi utilizzare i log di controllo per:

  • Visualizza un log di controllo per verificare se il backup è stato completato correttamente.
  • Configura un avviso basato su log per ricevere una notifica sullo stato del backup.

Visualizza un audit log

Puoi utilizzare la console Google Cloud, gcloud CLI oppure API per visualizzare un audit log e verificare se un backup è stato completato correttamente in una finestra di backup.

Console

  1. Nella console Google Cloud, seleziona Logging, quindi Esplora log.

    Vai a Esplora log

  2. Per filtrare i log di controllo per backup automatici delle istanze Cloud SQL, esegui questa 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 finali delle espressioni per gli audit log per le istanze Cloud SQL.

    Per saperne di più su come utilizzare la console Google Cloud per eseguire query sui log di controllo, consulta Visualizzare i log.

  3. Visualizza lo stato di un backup creato durante la finestra di backup. Questo stato è visualizzato nel campo windowStatus. Per visualizzare questo campo:

    1. Fai clic sul log di controllo.
    2. Fai clic sul campo metadata.

gcloud

  1. Per filtrare i log di controllo per backup automatici delle istanze Cloud SQL, esegui questa 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 per gli audit log degli eventi di sistema. La seconda espressione filtra i log di controllo per i backup automatici. L'espressione finale filtra gli audit log per le istanze Cloud SQL.

    Per ulteriori informazioni su come utilizzare gcloud per eseguire query sui log di controllo, consulta Visualizzare i log.

  2. 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, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID del tuo progetto Google Cloud.

Per il corpo JSON della richiesta, la prima espressione filtra per 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 l'API per eseguire query per i controlli log, consulta 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, consulta LogEntry.

Visualizza lo stato di un backup creato durante la finestra di backup. Questo stato è visualizzato nel campo windowStatus.

Stati dei backup automatici

  • STATUS_SUCCEEDED: il backup automatico è stato completato correttamente.

  • STATUS_ATTEMPT_FAILED: Cloud SQL ha provato a creare il backup, ma non è stato avviato oppure non è riuscito. Ecco alcuni motivi per cui viene visualizzato questo stato:

    • Nell'istanza è in esecuzione un altro backup.
    • La località di backup è limitata dal criterio dell'organizzazione.
    • Il backup dell'istanza è stato completato, ma si è verificato un errore.
    • L'istanza non era in esecuzione quando Cloud SQL ha provato a 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 abilitato i backup automatici e pianificato la finestra di backup tra le ore 1:00 e le ore 5:00, potrebbero non riuscire se ci sono molte operazioni EXPORT durante questo intervallo di tempo. I backup automatici potrebbero non riuscire anche se esistono troppi conflitti con un'operazione EXPORT eseguita per molto tempo.

    Se Cloud SQL tenta di creare un backup più volte durante un ma non è possibile creare il backup per i motivi elencati per STATUS_ATTEMPT_FAILED, Cloud SQL genera un altro audit log Il campo windowStatus è stato impostato su STATUS_FAILED.

  • STATUS_SKIPPED: l'istanza Cloud SQL è stata interrotta dall'ultimo backup riuscito. Pertanto, un nuovo backup automatico non è stato creato.

configura un avviso basato su log

Puoi configurare un avviso basato su log per informarti dello stato del backup.

  • Se lo stato di un backup è STATUS_SUCCEEDED, possono essere avvisati a scopo di monitoraggio.
  • Se un backup ha lo stato STATUS_FAILED o STATUS_ATTEMPT_FAILED, puoi ricevere una notifica per intraprendere un'azione correttiva, in base al messaggio visualizzato nella voce del log. Puoi anche eseguire un backup on demand prima della finestra del prossimo backup pianificato.
  • Se lo stato di un backup è STATUS_SKIPPED, puoi: una notifica per riavviare l'istanza Cloud SQL.

Passaggi successivi