Questa pagina spiega come visualizzare i log dei job di backup e ripristino per i backup protetti in Cloud Logging. Questi backup riguardano le risorse protette utilizzando i piani di backup. Se vuoi visualizzare i log dei job di backup e ripristino protetti utilizzando il modello di backup nella console di gestione, consulta Log dei job di backup e ripristino.
Autorizzazioni e ruoli
Per visualizzare i log dei job di backup e ripristino, devi disporre dell'autorizzazione IAM roles/logging.viewer
. Il ruolo Logs Viewer
ti consente di accedere in sola lettura per visualizzare i log dei job di backup e ripristino di tutte le risorse protette dal piano di backup nel progetto specificato. Se le operazioni di backup e ripristino vengono eseguite in un progetto diverso, chiedi all'amministratore di assegnare l'autorizzazione roles/logging.viewer
nel progetto in cui vuoi visualizzare i log. Per ulteriori informazioni su ruoli e autorizzazioni IAM per controllare l'accesso ai dati dei log, consulta Controllo dell'accesso con IAM.
Visualizzare i log dei job di backup e ripristino
Puoi visualizzare i log dei job di backup e ripristino per i backup protetti in Cloud Logging utilizzando la console Google Cloud e Google Cloud CLI. Per visualizzare i job di backup, seleziona il progetto del vault di backup o il progetto della risorsa in cui viene eseguito il backup. Per visualizzare i job di ripristino, seleziona il progetto del vault di backup o il progetto in cui viene ripristinata la risorsa.
Console
Nella console Google Cloud , puoi utilizzare Esplora log per recuperare le voci dei log di backup e ripristino per i backup archiviati:
- Nella console Google Cloud , vai a Logging > Esplora log.
- Seleziona un progetto cloud esistente.
- Nel riquadro Generatore di query, seleziona bdr_backup_restore_jobs dal menu a discesa Seleziona nome log.
gcloud
Google Cloud CLI fornisce un'interfaccia a riga di comando per l'API Logging. Per leggere le voci di log di backup e ripristino di un progetto, esegui questo comando:
```none
gcloud logging read "logName:bdr_backup_restore_jobs" --project=PROJECT_ID
```
Sostituisci quanto segue:
PROJECT_ID
: il nome del progetto. Per visualizzare i job di backup, puoi inserire il progetto del backup vault o il progetto della risorsa in cui viene eseguito il backup. Per visualizzare i job di ripristino, puoi inserire il progetto del vault di backup o il progetto in cui viene ripristinata la risorsa.
Formato del log dei job di backup e ripristino
Le voci di log di backup e ripristino includono i seguenti campi:
Campo | Descrizione |
---|---|
jobId |
L'ID associato al job. |
sourceResourceName |
Il nome relativo della risorsa protetta. |
jobCategory |
La categoria di lavoro, che può essere SCHEDULED_BACKUP , ON_DEMAND_BACKUP o RESTORE . |
sourceResourceId |
L'ID della risorsa protetta. |
resourceType |
Il tipo di risorsa. Ad esempio, un'istanza Compute Engine. |
jobStatus |
Lo stato del job, che può essere SUCCESSFUL , FAILED , RUNNING , SKIPPED . |
backupRule |
Il nome della regola di backup che ha attivato il job di backup. |
backupVaultName |
Il nome relativo del vault di backup in cui sono archiviati i backup. |
startTime |
L'ora di inizio del job, nel formato UTC YYYY-MM-DD HH:MM:SS.SSS . |
backupPlanName |
Il nome relativo del piano di backup associato alla risorsa. Per i job di ripristino, il campo del nome del piano di backup rimane Null . |
errorCode |
Il codice di errore associato al job non riuscito. Il codice di errore viene visualizzato come Null se non si è verificato alcun errore per il job. |
errorType |
Il nome del tipo di errore. Ad esempio, PERMISSION_DENIED . Il tipo di errore viene visualizzato come Null se non si è verificato alcun errore per il job. |
errorMessage |
Il messaggio di errore per il job non riuscito. Il messaggio di errore viene visualizzato come Null se non si è verificato alcun errore per il job. |
restoreResourceName |
Il nome relativo della risorsa creata dopo il ripristino riuscito. |
backupName |
Per i job di backup, il nome del backup è un nome generato dal sistema per il backup nel formato UUID. Per i job di ripristino, il nome del backup è il nome del backup utilizzato per eseguire il ripristino. |
Il seguente esempio mostra una voce di log per un backup pianificato su un'istanza Compute Engine.
{
"insertId": "696883be-582d-4af4-b2b8-a4c497e49489",
"jsonPayload": {
"jobId": "696883be-582d-4af4-b2b8-a4c497e49489",
"@type": "type.googleapis.com/google.cloud.backupdr.logging.v1.BDRBackupRestoreJobLog",
"sourceResourceName": "projects/Source_project_ID/zones/asia-east1-c/instances/Instance_name",
"jobCategory": "SCHEDULED_BACKUP",
"sourceResourceId": "6114243930178522357",
"resourceType": "Compute Engine",
"jobStatus": "RUNNING",
"backupRule": "backup-rule-1",
"backupVaultName": "projects/Backupvault_project_ID/locations/asia-east1/backupVaults/Backupvault_name",
"startTime": "2024-09-10T06:37:00.303416182Z",
"backupPlanName": "projects/Backupplan_project_ID/locations/asia-east1/backupPlans/Backupplan_Name"
},
"resource": {
"type": "backupdr.googleapis.com/BackupDRProject",
"labels": {
"resource_container": "projects/223618678509",
"location": "asia-east1"
}
},
"timestamp": "2024-09-10T06:37:00.303416182Z",
"logName": "projects/Backupvault_Name/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs",
"receiveTimestamp": "2024-09-10T06:37:01.818767274Z"
}
Query di esempio
Per visualizzare i log selezionati, puoi scrivere query personalizzate nella sezione delle query.
Utilizza la seguente query per visualizzare i job non riusciti.
logName:"bdr_backup_restore_jobs" jsonPayload.jobStatus="FAILED"
Utilizza la seguente query per visualizzare i job archiviati in un backup vault.
logName:"bdr_backup_restore_jobs" jsonPayload.backupVaultName:"backupVaults/BACKUPVAULT_NAME"
Utilizza la seguente query per visualizzare i job creati con un piano di backup.
logName:"bdr_backup_restore_jobs" jsonPayload.backupPlanName:"backupPlans/BACKUPPLAN_NAME"
Visualizza i log dei dettagli del piano di backup
Puoi visualizzare i log dei dettagli del piano di backup in Cloud Logging utilizzando la consoleGoogle Cloud e Google Cloud CLI. Per visualizzare i job di backup, seleziona il progetto in cui è stato creato il piano di backup.
Console
Nella console Google Cloud , puoi utilizzare Esplora log per recuperare le voci di log dei dettagli del piano di backup:
- Nella console Google Cloud , vai a Logging > Esplora log.
- Seleziona un progetto cloud esistente.
- Nel riquadro Generatore di query, seleziona bdr_backup_plan_details dal menu a discesa Seleziona nome log.
gcloud
Google Cloud CLI fornisce un'interfaccia a riga di comando per l'API Logging. Per leggere le voci di log di backup e ripristino di un progetto, esegui questo comando:
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
Sostituisci quanto segue:
PROJECT_ID
: il nome del progetto in cui è stato creato il piano di backup.
Formato del log dei dettagli del piano di backup
Le voci di log di backup e ripristino includono i seguenti campi:
Campo | Descrizione |
---|---|
backupPlanName |
Il nome relativo del piano di backup. |
ruleName |
Il nome della regola di backup utilizzata per i job di backup. |
recurrence |
Il tipo di ricorrenza del backup, che può essere oraria, giornaliera, settimanale, mensile o annuale. |
recurrenceSchedule |
La pianificazione della ricorrenza di un backup in base alla regola di backup. |
backupWindow |
Il periodo di tempo in cui possono iniziare i job di backup. |
retentionDays |
La durata in giorni per cui devono essere conservati i backup. |
backupWindowTimezone |
Il fuso orario applicato alla finestra di backup. |
backupVaultName |
Il nome relativo del vault di backup associato al piano di backup. |
resourcesProtectedCount |
Il numero di risorse protette dal piano di backup. |
protectedDataVolumeGib |
La dimensione totale in GiB dei dati di origine protetti dal piano di backup. |
Il seguente esempio mostra una voce di log bdr_backup_plan_details
.
{
"insertId": "15792541403682418506",
"jsonPayload": {
"resourcesProtectedCount": 3,
"protectedDataVolumeGib": 30,
"@type": "type.googleapis.com/google.cloud.backupdr.logging.v1.BDRBackupPlanDetailsLog",
"backupVaultName": "projects/hk-staging-saas-report-1/locations/us-central1/backupVaults/hk-bv-1",
"backupPlanName": "projects/hk-staging-saas-report-1/locations/us-central1/backupPlans/hk-bp-2",
"backupRuleDetails": [
{
"retentionDays": 10,
"recurrence": "Daily",
"recurrenceSchedule": "Every day",
"backupWindow": "00:00 to 24:00",
"ruleName": "hk-br-2",
"backupWindowTimezone": "Asia/Calcutta"
}
]
},
"resource": {
"type": "staging-backupdr.sandbox.googleapis.com/BackupPlan",
"labels": {
"location": "us-central1",
"resource_container": "838468076466",
"backup_plan_id": "hk-bp-2"
}
},
"timestamp": "2025-06-09T08:04:10Z",
"severity": "INFO",
"logName": "projects/hk-staging-saas-report-1/logs/staging-backupdr.sandbox.googleapis.com%2Fbdr_backup_plan_details",
"receiveTimestamp": "2025-06-09T09:40:14.711832094Z"
}
Query di esempio
Per visualizzare i log selezionati, puoi scrivere query personalizzate nella sezione delle query.
Utilizza la seguente query per visualizzare i piani di backup associati a un piano di backup specifico:
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
Utilizza la seguente query per visualizzare i piani di backup associati a un vault di backup specifico:
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
Utilizza la seguente query per visualizzare i piani di backup che contengono un nome di regola specifico:
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
Visualizzare i report del piano di backup per i backup archiviati nel vault
Puoi visualizzare i log dei dettagli del piano di backup in Cloud Logging utilizzando la consoleGoogle Cloud e Google Cloud CLI. Per visualizzare i job di backup, seleziona il progetto in cui è stato creato il piano di backup.
Console
Nella console Google Cloud , puoi utilizzare Esplora log per recuperare le voci di log dei dettagli del piano di backup:
- Nella console Google Cloud , vai a Logging > Esplora log.
- Seleziona un progetto cloud esistente.
- Nel riquadro Generatore di query, seleziona bdr_backup_plan_details dal menu a discesa Seleziona nome log.
gcloud
Google Cloud CLI fornisce un'interfaccia a riga di comando per l'API Logging. Per leggere le voci di log di backup e ripristino di un progetto, esegui questo comando:
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
Sostituisci quanto segue:
PROJECT_ID
: il nome del progetto in cui è stato creato il piano di backup.
Formato report del piano di backup
Questo report fornisce informazioni complete sui piani di backup configurati, dettagliando le regole, i vault di backup associati e le statistiche delle risorse che proteggono.
Il report include i seguenti campi:
- data: la data più recente in cui sono state aggiornate le informazioni del piano di backup.
- backup_plan_name: il nome designato del piano di backup.
- backup_plan_location: la posizione geografica del piano di backup.
- backup_rules: un record ripetuto (array) contenente i dettagli granulari per ogni regola di backup all'interno del piano. Ogni record di regola comprende:
- backup_rules.rule_name: il nome designato della regola di backup.
- backup_rules.recurrence: il tipo di ricorrenza specificato per il backup (ad es. "hourly" (orario), "daily" (giornaliero), "weekly" (settimanale), "monthly" (mensile), "yearly" (annuale).
- backup_rules.recurrence_schedule: la pianificazione della ricorrenza definita per la regola di backup (ad es. "ogni giorno alle 10:00", "ogni lunedì".
- backup_rules.backup_window: il periodo di tempo definito (nel formato 24 ore) durante il quale è consentito l'avvio dei job di backup (ad es. "02:00-08:00").
- backup_rules.backup_window_time_zone: il fuso orario in cui sono pianificati i backup (ad es. "UTC", "America/Los_Angeles").
- backup_rules.retention_days: la durata specificata (in giorni) per la quale i backup devono essere conservati in conformità a questa regola.
- backup_vault_name: il nome del vault di backup intrinsecamente collegato al piano di backup.
- backup_vault_location: la posizione geografica del vault di backup associato al piano di backup.
- resources_protected_count: il numero quantificabile di risorse protette da questo piano di backup specifico.
- protected_data_volume_gib: il volume totale di dati (espresso in GiB) delle risorse protette da questo piano di backup.
- minimum_enforced_retention_days: il periodo di conservazione minimo obbligatorio (in giorni) applicabile ai backup associati a questo piano di backup.
- effective_date_for_enforced_retention_lock: la data di validità precisa per il blocco del periodo di conservazione applicato.
lock_on_enforced_retention: un indicatore che indica se la conservazione è in uno stato bloccato. Questo campo viene generato dinamicamente in base alla logica successiva:
- Se il timestamp
effective_date_for_enforced_retention_lock
è presente e corrisponde all'ora attuale o a un'ora passata, il valore viene designato come "bloccato". - Se questa condizione non è soddisfatta, il valore viene designato come "sbloccato".
- Se il timestamp
Query di esempio
Per visualizzare i log selezionati, puoi scrivere query personalizzate nella sezione delle query.
Utilizza la seguente query per visualizzare i piani di backup associati a un piano di backup specifico:
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
Utilizza la seguente query per visualizzare i piani di backup associati a un vault di backup specifico:
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
Utilizza la seguente query per visualizzare i piani di backup che contengono un nome di regola specifico:
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
Passaggi successivi
- Per configurare gli avvisi basati su log per il servizio di Backup e DR, crea una query di log, utilizzando Filtra log dei job e poi Configura gli avvisi basati su log.