Cette page explique comment afficher les journaux des jobs de sauvegarde et de restauration pour les sauvegardes stockées dans un coffre dans Cloud Logging. Ces sauvegardes concernent les ressources protégées à l'aide de plans de sauvegarde. Si vous souhaitez afficher les journaux des jobs de sauvegarde et de restauration protégés à l'aide du modèle de sauvegarde dans la console de gestion de l'appliance, consultez Journaux des jobs de sauvegarde et de récupération.
Autorisations et rôles
Vous devez disposer de l'autorisation IAM roles/logging.viewer pour afficher les journaux des jobs de sauvegarde et de restauration. Le rôle Logs Viewer (Lecteur de journaux) vous permet d'accéder en lecture seule aux journaux des jobs de sauvegarde et de restauration de toutes les ressources protégées par un plan de sauvegarde dans le projet spécifié. Si des opérations de sauvegarde et de restauration sont effectuées dans un autre projet, demandez à votre administrateur d'attribuer l'autorisation roles/logging.viewer dans le projet dans lequel vous souhaitez afficher les journaux. Pour en savoir plus sur les autorisations et les rôles IAM permettant de contrôler l'accès aux données des journaux, consultez Contrôle des accès avec IAM.
Afficher les journaux des jobs de sauvegarde et de restauration
Vous pouvez afficher les journaux des jobs de sauvegarde, de restauration et de récupération à un moment précis pour les sauvegardes stockées dans un coffre dans Cloud Logging à l'aide de la Google Cloud console et de la gcloud CLI. Pour afficher les jobs de sauvegarde, sélectionnez le projet de coffre de sauvegarde ou le projet de ressource dans lequel la sauvegarde est effectuée. Pour afficher les jobs de restauration et de récupération à un moment précis, sélectionnez le projet de coffre de sauvegarde ou le projet dans lequel la ressource est restaurée.
Console
Dans la Google Cloud console, vous pouvez utiliser l'explorateur de journaux pour récupérer les entrées des journaux de sauvegarde et de restauration de vos sauvegardes stockées dans un coffre :
- Dans la Google Cloud console, accédez à Logging > Explorateur de journaux.
- Sélectionnez un projet Cloud existant.
- Dans le volet Générateur de requêtes, sélectionnez bdr_backup_restore_jobs dans la liste déroulante Sélectionner le nom du journal.
gcloud
Le gcloud CLI fournit une interface de ligne de commande à l'API Logging. Pour lire les entrées de journal de sauvegarde et de restauration d'un projet, exécutez la commande suivante :
```none
gcloud logging read "logName:bdr_backup_restore_jobs" --project=PROJECT_ID
```
Remplacez les éléments suivants :
PROJECT_ID: nom du projet. Pour afficher les jobs de sauvegarde, vous pouvez saisir le projet de coffre de sauvegarde ou le projet de ressource dans lequel la sauvegarde est effectuée. Pour afficher les jobs de restauration, vous pouvez saisir le projet de coffre de sauvegarde ou le projet dans lequel la ressource est restaurée.
Format des journaux des jobs de sauvegarde et de restauration
Les entrées des journaux de sauvegarde et de restauration incluent les champs suivants :
| Champ | Description |
|---|---|
jobId |
ID associé au job. |
sourceResourceName |
Le nom relatif de la ressource protégée. |
jobCategory |
Catégorie de job, qui peut être SCHEDULED_BACKUP, ON_DEMAND_BACKUP, RESTORE ou PITR. |
sourceResourceId |
ID de la ressource protégée. |
resourceType |
Type de ressource. Par exemple, une instance Compute Engine. |
jobStatus |
État du job, qui peut être SUCCESSFUL, FAILED, RUNNING ou SKIPPED. |
backupRule |
Nom de la règle de sauvegarde qui a déclenché le job de sauvegarde. |
backupVaultName |
Le nom relatif du coffre de sauvegarde dans lequel les sauvegardes sont stockées. |
startTime |
Heure de début du job, au format UTC YYYY-MM-DD HH:MM:SS.SSS. |
backupPlanName |
Nom relatif du plan de sauvegarde associé à la ressource. Pour les jobs de restauration, le champ du nom du plan de sauvegarde reste Null. |
errorCode |
Code d'erreur associé au job ayant échoué. Le code d'erreur s'affiche sous la forme Null si aucune erreur ne s'est produite pour le job. |
errorType |
Nom du type d'erreur. Par exemple, PERMISSION_DENIED. Le type d'erreur s'affiche sous la forme Null si aucune erreur ne s'est produite pour le job. |
errorMessage |
Message d'erreur pour le job ayant échoué. Le message d'erreur s'affiche sous la forme Null si aucune erreur ne s'est produite pour le job. |
restoreResourceName |
Le nom relatif de la ressource créée après la restauration réussie. |
backupName |
Pour les jobs de sauvegarde, le nom de la sauvegarde est généré par le système au format UUID. Pour les jobs de restauration, le nom de la sauvegarde correspond au nom de la sauvegarde utilisée pour effectuer la restauration. |
recoveryPointTime |
Pour les restaurations à un moment précis, la restauration est effectuée à un moment précis au lieu de restaurer uniquement une sauvegarde. Ce champ capture le point de récupération fourni par l'utilisateur au format UTC YYYY-MM-DD HH:MM:SS.SSS. |
dataSourceName |
Nom de la source de données dans le coffre de sauvegarde où les sauvegardes sont stockées. La restauration à un moment précis est déclenchée sur la source de données, et non sur les sauvegardes. |
L'exemple suivant illustre une entrée de journal pour une sauvegarde programmée sur une instance 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"
}
Exemples de requêtes
Pour afficher les journaux sélectionnés, vous pouvez écrire des requêtes personnalisées dans la section des requêtes.
Utilisez la requête suivante pour afficher les jobs ayant échoué.
logName:"bdr_backup_restore_jobs" jsonPayload.jobStatus="FAILED"
Utilisez la requête suivante pour afficher les jobs stockés dans un coffre de sauvegarde.
logName:"bdr_backup_restore_jobs" jsonPayload.backupVaultName:"backupVaults/BACKUPVAULT_NAME"
Utilisez la requête suivante pour afficher les jobs créés avec un plan de sauvegarde.
logName:"bdr_backup_restore_jobs" jsonPayload.backupPlanName:"backupPlans/BACKUPPLAN_NAME"
Afficher les journaux des détails du plan de sauvegarde
Vous pouvez afficher les journaux des détails du plan de sauvegarde dans Cloud Logging à l'aide de la Google Cloud console et de la gcloud CLI. Pour afficher les jobs de sauvegarde, sélectionnez le projet dans lequel le plan de sauvegarde a été créé.
Console
Dans la Google Cloud console, vous pouvez utiliser l'explorateur de journaux pour récupérer les entrées des journaux des détails du plan de sauvegarde :
- Dans la Google Cloud console, accédez à Logging > Explorateur de journaux.
- Sélectionnez un projet Cloud existant.
- Dans le volet Générateur de requêtes, sélectionnez bdr_backup_plan_details dans la liste déroulante Sélectionner le nom du journal.
gcloud
Le gcloud CLI fournit une interface de ligne de commande à l'API Logging. Pour lire les entrées de journal de sauvegarde et de restauration d'un projet, exécutez la commande suivante :
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
Remplacez les éléments suivants :
PROJECT_ID: nom du projet dans lequel le plan de sauvegarde a été créé.
Format des journaux des détails du plan de sauvegarde
Les entrées des journaux de sauvegarde et de restauration incluent les champs suivants :
| Champ | Description |
|---|---|
backupPlanName |
Le nom relatif du plan de sauvegarde. |
ruleName |
Nom de la règle de sauvegarde utilisée pour les jobs de sauvegarde. |
recurrence |
Type de récurrence de la sauvegarde, qui peut être horaire, quotidienne, hebdomadaire, mensuelle ou annuelle. |
recurrenceSchedule |
Planification de la récurrence d'une sauvegarde en fonction de la règle de sauvegarde. |
backupWindow |
Période pendant laquelle les jobs de sauvegarde peuvent démarrer. |
retentionDays |
Durée en jours pendant laquelle les sauvegardes doivent être conservées. |
backupWindowTimezone |
Fuseau horaire qui s'applique à la période de sauvegarde. |
backupVaultName |
Nom relatif du coffre de sauvegarde associé au plan de sauvegarde. |
resourcesProtectedCount |
Nombre de ressources protégées par le plan de sauvegarde. |
protectedDataVolumeGib |
Taille totale en Gio des données sources protégées par le plan de sauvegarde. |
L'exemple suivant illustre une entrée de journal 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"
}
Exemples de requêtes
Pour afficher les journaux sélectionnés, vous pouvez écrire des requêtes personnalisées dans la section des requêtes.
Utilisez la requête suivante pour afficher les plans de sauvegarde associés à un plan de sauvegarde spécifique :
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
Utilisez la requête suivante pour afficher les plans de sauvegarde associés à un coffre de sauvegarde spécifique :
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
Utilisez la requête suivante pour afficher les plans de sauvegarde qui contiennent un nom de règle spécifique :
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
Afficher les rapports de plan de sauvegarde pour les sauvegardes stockées dans un coffre
Vous pouvez afficher les journaux des détails du plan de sauvegarde dans Cloud Logging à l'aide de la Google Cloud console et de la gcloud CLI. Pour afficher les jobs de sauvegarde, sélectionnez le projet dans lequel le plan de sauvegarde a été créé.
Console
Dans la Google Cloud console, vous pouvez utiliser l'explorateur de journaux pour récupérer les entrées des journaux des détails du plan de sauvegarde :
- Dans la Google Cloud console, accédez à Logging > Explorateur de journaux.
- Sélectionnez un projet Cloud existant.
- Dans le volet Générateur de requêtes, sélectionnez bdr_backup_plan_details dans la liste déroulante Sélectionner le nom du journal.
gcloud
Le gcloud CLI fournit une interface de ligne de commande à l'API Logging. Pour lire les entrées de journal de sauvegarde et de restauration d'un projet, exécutez la commande suivante :
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
Remplacez les éléments suivants :
PROJECT_ID: nom du projet dans lequel le plan de sauvegarde a été créé.
Format des rapports de plan de sauvegarde
Ce rapport fournit des insights complets sur les plans de sauvegarde configurés, en détaillant leurs règles, les coffres de sauvegarde associés et les statistiques des ressources qu'ils protègent.
Le rapport inclut les champs suivants :
- date : date la plus récente à laquelle les informations du plan de sauvegarde ont été mises à jour.
- backup_plan_name : nom désigné du plan de sauvegarde.
- backup_plan_location : emplacement géographique du plan de sauvegarde.
- backup_rules : enregistrement répété (tableau) contenant des informations détaillées pour chaque règle de sauvegarde du plan. Chaque enregistrement de règle comprend les éléments suivants :
- backup_rules.rule_name : nom désigné de la règle de sauvegarde.
- backup_rules.recurrence : type de récurrence spécifié pour la sauvegarde (par exemple, "horaire", "quotidienne", "hebdomadaire", "mensuelle", "annuelle").
- backup_rules.recurrence_schedule : planification de la récurrence définie pour la règle de sauvegarde (par exemple, "tous les jours à 10h00", "tous les lundis").
- backup_rules.backup_window : période définie (au format 24 heures) pendant laquelle les jobs de sauvegarde sont autorisés à démarrer (par exemple, "02:00-08:00").
- backup_rules.backup_window_time_zone : fuseau horaire dans lequel les sauvegardes sont programmées (par exemple, "UTC", "America/Los_Angeles").
- backup_rules.retention_days : durée spécifiée (en jours) pendant laquelle les sauvegardes doivent être conservées conformément à cette règle.
- backup_vault_name : nom du coffre de sauvegarde intrinsèquement lié au plan de sauvegarde.
- backup_vault_location : emplacement géographique du coffre de sauvegarde associé au plan de sauvegarde.
- resources_protected_count : nombre quantifiable de ressources protégées par ce plan de sauvegarde spécifique.
- protected_data_volume_gib : volume de données agrégé (exprimé en Gio) des ressources protégées par ce plan de sauvegarde.
- minimum_enforced_retention_days : période de conservation minimale obligatoire (en jours) applicable aux sauvegardes associées à ce plan de sauvegarde.
- effective_date_for_enforced_retention_lock : date d'entrée en vigueur précise du verrouillage de la conservation appliquée.
lock_on_enforced_retention : indicateur indiquant si la conservation est verrouillée. Ce champ est généré de manière dynamique en fonction de la logique suivante :
- Si l'horodatage
effective_date_for_enforced_retention_lockest présent et correspond à l'heure actuelle ou à une heure passée, la valeur est désignée comme "verrouillée". - Si cette condition n'est pas remplie, la valeur est désignée comme "déverrouillée".
- Si l'horodatage
Exemples de requêtes
Pour afficher les journaux sélectionnés, vous pouvez écrire des requêtes personnalisées dans la section des requêtes.
Utilisez la requête suivante pour afficher les plans de sauvegarde associés à un plan de sauvegarde spécifique :
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
Utilisez la requête suivante pour afficher les plans de sauvegarde associés à un coffre de sauvegarde spécifique :
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
Utilisez la requête suivante pour afficher les plans de sauvegarde qui contiennent un nom de règle spécifique :
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
Étape suivante
- Pour configurer des alertes basées sur les journaux pour Backup and DR, créez une requête de journal, à l'aide des journaux de jobs de filtre, puis configurez des alertes basées sur les journaux.