Auf dieser Seite wird erläutert, wie Sie die Logbücher für Sicherungs- und Wiederherstellungsjobs für Vault-Sicherungen in Cloud Logging aufrufen. Diese Sicherungen gelten für die Ressourcen, die mit Sicherungsplänengeschützt werden. Wenn Sie die Logbücher für Sicherungs- und Wiederherstellungsjobs aufrufen möchten, die mit der Sicherungsvorlage in der Appliance-Verwaltungskonsole geschützt werden, lesen Sie den Artikel Logbücher für Sicherungs- und Wiederherstellungsjobs.
Berechtigungen und Rollen
Sie benötigen die IAM-Berechtigung roles/logging.viewer, um die Logbücher für Sicherungs- und Wiederherstellungsjobs aufzurufen. Mit der Rolle Logs Viewer haben Sie schreibgeschützten Zugriff auf die Logbücher für Sicherungs- und Wiederherstellungsjobs aller Ressourcen, die durch einen Sicherungsplan im angegebenen Projekt geschützt sind. Wenn Sicherungs- und Wiederherstellungsvorgänge in einem anderen Projekt ausgeführt werden, bitten Sie Ihren Administrator, die Berechtigung roles/logging.viewer in dem Projekt zuzuweisen, in dem Sie die Logbücher aufrufen möchten. Weitere Informationen zu den IAM-Berechtigungen und ‑Rollen zum Steuern des Zugriffs auf Logdaten finden Sie unter Zugriffssteuerung mit IAM.
Logbücher für Sicherungs- und Wiederherstellungsjobs aufrufen
Sie können Logbücher für Sicherungs-, Wiederherstellungs- und PITR-Jobs für Vault-Sicherungen in Cloud Logging über die Google Cloud console und die gcloud CLI aufrufen. Wählen Sie zum Aufrufen von Sicherungsjobs entweder das Projekt des Backup Vault oder das Ressourcenprojekt aus, in dem die Sicherung ausgeführt wird. Wählen Sie zum Aufrufen von Wiederherstellungs- und Wiederherstellung zu einem bestimmten Zeitpunkt-Jobs entweder das Projekt des Backup Vault oder das Projekt aus, in dem die Ressource wiederhergestellt wird.
Console
In der Google Cloud console können Sie mit dem Log-Explorer die Logeinträge für Sicherungs- und Wiederherstellungsjobs für Ihre Vault-Sicherungen abrufen:
- Wechseln Sie in der Google Cloud console zu Logging > Log-Explorer.
- Wählen Sie ein vorhandenes Cloud-Projekt aus.
- Wählen Sie im Bereich Abfrage erstellen in der Drop-down-Liste Logname auswählen die Option bdr_backup_restore_jobs aus.
gcloud
Die gcloud CLI bietet eine Befehlszeile für die Logging API. Führen Sie den folgenden Befehl aus, um die Logeinträge für Sicherungs- und Wiederherstellungsjobs eines Projekts zu lesen:
```none
gcloud logging read "logName:bdr_backup_restore_jobs" --project=PROJECT_ID
```
Ersetzen Sie Folgendes:
PROJECT_ID: der Name des Projekts. Wenn Sie Sicherungsjobs aufrufen möchten, können Sie entweder das Projekt des Backup Vault oder das Ressourcenprojekt eingeben, in dem die Sicherung ausgeführt wird. Wenn Sie Wiederherstellungsjobs aufrufen möchten, können Sie entweder das Projekt des Backup Vault oder das Projekt eingeben, in dem die Ressource wiederhergestellt wird.
Logformat für Sicherungs- und Wiederherstellungsjobs
Logeinträge für Sicherungs- und Wiederherstellungsjobs enthalten die folgenden Felder:
| Feld | Beschreibung |
|---|---|
jobId |
Die ID, die dem Job zugeordnet ist. |
sourceResourceName |
Der relative Name der geschützten Ressource. |
jobCategory |
Die Kategorie des Jobs, die SCHEDULED_BACKUP, ON_DEMAND_BACKUP, RESTORE oder PITR sein kann. |
sourceResourceId |
Die ID der geschützten Ressource. |
resourceType |
Der Ressourcentyp. Beispiel: eine Compute Engine-Instanz. |
jobStatus |
Der Status des Jobs, der SUCCESSFUL, FAILED, RUNNING oder SKIPPED sein kann. |
backupRule |
Der Name der Sicherungsregel, die den Sicherungsjob ausgelöst hat. |
backupVaultName |
Der relative Name des Backup Vault, in dem die Sicherungen gespeichert sind. |
startTime |
Die Startzeit des Jobs im UTC-Format YYYY-MM-DD HH:MM:SS.SSS. |
backupPlanName |
Der relative Name des Sicherungsplans, der mit der Ressource verknüpft ist. Bei Wiederherstellungsjobs bleibt das Feld für den Namen des Sicherungsplans Null. |
errorCode |
Der Fehlercode, der dem fehlgeschlagenen Job zugeordnet ist. Der Fehlercode wird als Null angezeigt, wenn für den Job kein Fehler aufgetreten ist. |
errorType |
Der Name des Fehlertyps. Beispiel: PERMISSION_DENIED. Der Fehlertyp wird als Null angezeigt, wenn für den Job kein Fehler aufgetreten ist. |
errorMessage |
Die Fehlermeldung für den fehlgeschlagenen Job. Die Fehlermeldung wird als Null angezeigt, wenn für den Job kein Fehler aufgetreten ist. |
restoreResourceName |
Der relative Name der Ressource, die nach der erfolgreichen Wiederherstellung erstellt wird. |
backupName |
Bei Sicherungsjobs ist der Name der Sicherung ein vom System generierter Name für die Sicherung in Form einer UUID. Bei Wiederherstellungsjobs ist der Name der Sicherung der Name der Sicherung, die zum Ausführen der Wiederherstellung verwendet wurde. |
recoveryPointTime |
Bei Wiederherstellungen zu einem bestimmten Zeitpunkt (PITR) erfolgt die Wiederherstellung zu einem bestimmten Zeitpunkt und nicht nur die Wiederherstellung einer Sicherung. In diesem Feld wird der vom Nutzer angegebene Wiederherstellungspunkt im UTC-Format YYYY-MM-DD HH:MM:SS.SSS erfasst. |
dataSourceName |
Name der Datenquelle im Backup Vault, in dem die Sicherungen gespeichert sind. Die Wiederherstellung zu einem bestimmten Zeitpunkt wird für die Datenquelle und nicht für Sicherungen ausgelöst. |
Das folgende Beispiel zeigt einen Logeintrag für eine geplante Sicherung einer Compute Engine-Instanz.
{
"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"
}
Beispielabfragen
Wenn Sie ausgewählte Logbücher aufrufen möchten, können Sie im Abfragebereich benutzerdefinierte Abfragen schreiben.
Verwenden Sie die folgende Abfrage, um fehlgeschlagene Jobs aufzurufen.
logName:"bdr_backup_restore_jobs" jsonPayload.jobStatus="FAILED"
Verwenden Sie die folgende Abfrage, um Jobs aufzurufen, die in einem Backup Vault gespeichert sind.
logName:"bdr_backup_restore_jobs" jsonPayload.backupVaultName:"backupVaults/BACKUPVAULT_NAME"
Verwenden Sie die folgende Abfrage, um Jobs aufzurufen, die mit einem Sicherungsplan erstellt wurden.
logName:"bdr_backup_restore_jobs" jsonPayload.backupPlanName:"backupPlans/BACKUPPLAN_NAME"
Logbücher mit Details zum Sicherungsplan aufrufen
Sie können Logbücher mit Details zum Sicherungsplan in Cloud Logging über die Google Cloud Console und die gcloud CLI aufrufen. Wählen Sie zum Aufrufen von Sicherungsjobs das Projekt aus, in dem der Sicherungsplan erstellt wurde.
Console
In der Google Cloud console können Sie mit dem Log-Explorer die Logeinträge mit Details zum Sicherungsplan abrufen:
- Wechseln Sie in der Google Cloud console zu Logging > Log-Explorer.
- Wählen Sie ein vorhandenes Cloud-Projekt aus.
- Wählen Sie im Bereich Abfrage erstellen in der Drop-down-Liste Logname auswählen die Option bdr_backup_plan_details aus.
gcloud
Die gcloud CLI bietet eine Befehlszeile für die Logging API. Führen Sie den folgenden Befehl aus, um die Logeinträge für Sicherungs- und Wiederherstellungsjobs eines Projekts zu lesen:
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
Ersetzen Sie Folgendes:
PROJECT_ID: der Name des Projekts, in dem der Sicherungsplan erstellt wurde.
Logformat mit Details zum Sicherungsplan
Logeinträge für Sicherungs- und Wiederherstellungsjobs enthalten die folgenden Felder:
| Feld | Beschreibung |
|---|---|
backupPlanName |
Der relative Name des Sicherungsplans. |
ruleName |
Der Name der Sicherungsregel, die für Sicherungsjobs verwendet wird. |
recurrence |
Der Wiederholungstyp für die Sicherung, der stündlich, täglich, wöchentlich, monatlich oder jährlich sein kann. |
recurrenceSchedule |
Der Wiederholungszeitplan einer Sicherung basierend auf der Sicherungsregel. |
backupWindow |
Der Zeitraum, in dem Sicherungsjobs gestartet werden können. |
retentionDays |
Die Dauer in Tagen, für die die Sicherungen aufbewahrt werden sollen. |
backupWindowTimezone |
Die Zeitzone, die für den Sicherungszeitraum gilt. |
backupVaultName |
Der relative Name des Backup Vault, der mit dem Sicherungsplan verknüpft ist. |
resourcesProtectedCount |
Die Anzahl der Ressourcen, die durch den Sicherungsplan geschützt sind. |
protectedDataVolumeGib |
Die Gesamtgröße der Quelldaten in GiB, die durch den Sicherungsplan geschützt sind. |
Das folgende Beispiel zeigt einen bdr_backup_plan_details-Logeintrag.
{
"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"
}
Beispielabfragen
Wenn Sie ausgewählte Logbücher aufrufen möchten, können Sie im Abfragebereich benutzerdefinierte Abfragen schreiben.
Verwenden Sie die folgende Abfrage, um Sicherungspläne aufzurufen, die mit einem bestimmten Sicherungsplan verknüpft sind:
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
Verwenden Sie die folgende Abfrage, um Sicherungspläne aufzurufen, die mit einem bestimmten Backup Vault verknüpft sind:
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
Verwenden Sie die folgende Abfrage, um Sicherungspläne aufzurufen, die einen bestimmten Regelnamen enthalten:
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
Berichte zu Sicherungsplänen für Vault-Sicherungen aufrufen
Sie können Logbücher mit Details zum Sicherungsplan in Cloud Logging über die Google Cloud Console und die gcloud CLI aufrufen. Wählen Sie zum Aufrufen von Sicherungsjobs das Projekt aus, in dem der Sicherungsplan erstellt wurde.
Console
In der Google Cloud console können Sie mit dem Log-Explorer die Logeinträge mit Details zum Sicherungsplan abrufen:
- Wechseln Sie in der Google Cloud console zu Logging > Log-Explorer.
- Wählen Sie ein vorhandenes Cloud-Projekt aus.
- Wählen Sie im Bereich Abfrage erstellen in der Drop-down-Liste Logname auswählen die Option bdr_backup_plan_details aus.
gcloud
Die gcloud CLI bietet eine Befehlszeile für die Logging API. Führen Sie den folgenden Befehl aus, um die Logeinträge für Sicherungs- und Wiederherstellungsjobs eines Projekts zu lesen:
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
Ersetzen Sie Folgendes:
PROJECT_ID: der Name des Projekts, in dem der Sicherungsplan erstellt wurde.
Berichtsformat für Sicherungspläne
Dieser Bericht bietet umfassende Einblicke in konfigurierte Sicherungspläne mit Details zu ihren Regeln, verknüpften Backup Vaults und Statistiken der Ressourcen, die sie schützen.
Der Bericht enthält die folgenden Felder:
- date: Das letzte Datum, an dem die Informationen zum Sicherungsplan aktualisiert wurden.
- backup_plan_name: Der angegebene Name des Sicherungsplans.
- backup_plan_location: Der geografische Standort des Sicherungsplans.
- backup_rules: Ein wiederholter Datensatz (Array) mit detaillierten Informationen zu jeder Sicherungsregel im Plan. Jeder Regeldatensatz enthält:
- backup_rules.rule_name: Der angegebene Name der Sicherungsregel.
- backup_rules.recurrence: Der angegebene Wiederholungstyp für die Sicherung (z.B. „stündlich“, „täglich“, „wöchentlich“, „monatlich“, „jährlich“).
- backup_rules.recurrence_schedule: Der definierte Wiederholungszeitplan für die Sicherungsregel (z.B. „jeden Tag um 10:00 Uhr“, „jeden Montag“).
- backup_rules.backup_window: Der definierte Zeitraum (im 24-Stunden-Format), in dem Sicherungsjobs gestartet werden dürfen (z.B. „02:00–08:00“).
- backup_rules.backup_window_time_zone: Die Zeitzone, in der die Sicherungen geplant sind (z.B. „UTC“, „America/Los_Angeles“).
- backup_rules.retention_days: Die angegebene Dauer (in Tagen), für die Sicherungen gemäß dieser Regel aufbewahrt werden sollen.
- backup_vault_name: Der Name des Backup Vault, der mit dem Sicherungsplan verknüpft ist.
- backup_vault_location: Der geografische Standort des Backup Vault, der mit dem Sicherungsplan verknüpft ist.
- resources_protected_count: Die Anzahl der Ressourcen, die durch diesen Sicherungsplan geschützt sind.
- protected_data_volume_gib: Das aggregierte Datenvolumen (in GiB) der Ressourcen, die durch diesen Sicherungsplan geschützt sind.
- minimum_enforced_retention_days: Die obligatorische Mindestaufbewahrungsdauer (in Tagen) für Sicherungen, die mit diesem Sicherungsplan verknüpft sind.
- effective_date_for_enforced_retention_lock: Das genaue Datum des Inkrafttretens für die Sperre für erzwungene Aufbewahrung.
lock_on_enforced_retention: Gibt an, ob die Aufbewahrung gesperrt ist. Dieses Feld wird dynamisch basierend auf der folgenden Logik generiert:
- Wenn der Zeitstempel
effective_date_for_enforced_retention_lockvorhanden ist und entweder der aktuellen Zeit oder einer vergangenen Zeit entspricht, wird der Wert als „gesperrt“ festgelegt. - Wenn diese Bedingung nicht erfüllt ist, wird der Wert als „nicht gesperrt“ festgelegt.
- Wenn der Zeitstempel
Beispielabfragen
Wenn Sie ausgewählte Logbücher aufrufen möchten, können Sie im Abfragebereich benutzerdefinierte Abfragen schreiben.
Verwenden Sie die folgende Abfrage, um Sicherungspläne aufzurufen, die mit einem bestimmten Sicherungsplan verknüpft sind:
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
Verwenden Sie die folgende Abfrage, um Sicherungspläne aufzurufen, die mit einem bestimmten Backup Vault verknüpft sind:
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
Verwenden Sie die folgende Abfrage, um Sicherungspläne aufzurufen, die einen bestimmten Regelnamen enthalten:
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
Nächste Schritte
- Wenn Sie logbasierte Benachrichtigungen für Backup und DR konfigurieren möchten, erstellen Sie eine Logabfrage, mit dem Filter für Job-Logbücher und konfigurieren Sie dann logbasierte Benachrichtigungen.