Log dei job di backup e ripristino per i backup archiviati nel vault

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:

  1. Nella console Google Cloud , vai a Logging > Esplora log.
  2. Seleziona un progetto cloud esistente.
  3. 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:

  1. Nella console Google Cloud , vai a Logging > Esplora log.
  2. Seleziona un progetto cloud esistente.
  3. 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:

  1. Nella console Google Cloud , vai a Logging > Esplora log.
  2. Seleziona un progetto cloud esistente.
  3. 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".

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