Jobprotokolle für gesicherte Back-ups sichern und wiederherstellen

Auf dieser Seite wird beschrieben, wie Sie die Sicherungs- und Wiederherstellungsjob-Logs für gesicherte Sicherungen in Cloud Logging aufrufen. Diese Sicherungen gelten für die Ressourcen, die mit Sicherungsplänen geschützt sind. Wenn Sie sich die Sicherungs- und Wiederherstellungsjobprotokolle ansehen möchten, die mit der Sicherungsvorlage in der Verwaltungskonsole geschützt sind, lesen Sie den Hilfeartikel Jobprotokolle für Sicherung und Wiederherstellung.

Berechtigungen und Rollen

Sie benötigen die IAM-Berechtigung roles/logging.viewer, um die Sicherungs- und Wiederherstellungsjobprotokolle aufzurufen. Die Rolle Logs Viewer gewährt Lesezugriff auf Sicherungs- und Wiederherstellungsauftragsprotokolle aller Ressourcen, die im angegebenen Projekt durch einen Sicherungsplan geschützt sind. Wenn Sicherungs- und Wiederherstellungsvorgänge in einem anderen Projekt ausgeführt werden, bitten Sie Ihren Administrator, Ihnen die Berechtigung roles/logging.viewer in dem Projekt zuzuweisen, in dem Sie sich Protokolle ansehen möchten. Weitere Informationen zu den IAM-Berechtigungen und -Rollen zur Steuerung des Zugriffs auf Protokolldaten finden Sie unter Zugriffssteuerung mit IAM.

Sicherungs- und Wiederherstellungsjobprotokolle ansehen

Sie können Sicherungs- und Wiederherstellungsjob-Logs für gesicherte Sicherungen in Cloud Logging mit der Google Cloud Console und der Google Cloud CLI aufrufen. Wenn Sie Sicherungsjobs aufrufen möchten, wählen Sie entweder das Backup Vault-Projekt oder das Ressourcenprojekt aus, in dem die Sicherung ausgeführt wird. Wenn Sie Wiederherstellungsjobs aufrufen möchten, wählen Sie entweder das Sicherungsspeicher-Projekt oder das Projekt aus, in dem die Ressource wiederhergestellt wird.

Konsole

In der Google Cloud Console können Sie mit dem Log-Explorer die Sicherungs- und Wiederherstellungsprotokolleinträge für Ihre gesicherten Sicherungen abrufen:

  1. Klicken Sie in der Google Cloud Console auf Logging > Log-Explorer.
  2. Wählen Sie ein vorhandenes Cloud-Projekt aus.
  3. Wählen Sie im Bereich Abfragebaustein im Drop-down-Menü Lognamen auswählen die Option bdr_backup_restore_jobs aus.

gcloud

Die Google Cloud CLI bietet eine Befehlszeile für die Logging API. Führen Sie den folgenden Befehl aus, um die Sicherungs- und Wiederherstellungs-Logeinträge eines Projekts zu lesen:

 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 Backup Vault-Projekt oder das Ressourcenprojekt eingeben, in dem die Sicherung ausgeführt wird. Wenn Sie sich Wiederherstellungsjobs ansehen möchten, können Sie entweder das Sicherungsspeicher-Projekt oder das Projekt eingeben, in dem die Ressource wiederhergestellt wird.

Protokollformat für Sicherungs- und Wiederherstellungsjobs

Logeinträge für Sicherungen und Wiederherstellungen enthalten die folgenden Felder:

Feld Beschreibung
jobId Die ID, die mit dem Job verknüpft ist.
sourceResourceName Der relative Name der geschützten Ressource.
jobCategory Die Kategorie der Aufgabe, z. B. SCHEDULED_BACKUP, ON_DEMAND_BACKUP oder RESTORE.
sourceResourceId Die ID der geschützten Ressource.
resourceType Der Ressourcentyp. Beispiel: eine Compute Engine-Instanz.
jobStatus Der Status der Aufgabe, z. B. SUCCESSFUL, FAILED, RUNNING oder SKIPPED.
backupRule Der Name der Sicherungsregel, die den Sicherungsjob ausgelöst hat.
backupVaultName Der relative Name des Sicherungsspeichers, in dem die Sicherungen gespeichert sind.
startTime Die Startzeit des Jobs im Format YYYY-MM-DD HH:MM:SS.SSS UTC.
backupPlanName Der relative Name des Sicherungsplans, der mit der Ressource verknüpft ist. Bei Wiederherstellungsjobs bleibt das Feld „Name des Sicherungsplans“ Null.
errorCode Der Fehlercode, der mit dem fehlgeschlagenen Job verknüpft ist. Wenn beim Job kein Fehler aufgetreten ist, wird der Fehlercode als Null angezeigt.
errorType Der Name des Fehlertyps. Beispiel: PERMISSION_DENIED. Wenn für den Job kein Fehler aufgetreten ist, wird der Fehlertyp als Null angezeigt.
errorMessage Die Fehlermeldung für den fehlgeschlagenen Job. Wenn beim Job kein Fehler aufgetreten ist, wird die Fehlermeldung als Null angezeigt.
restoreResourceName Der relative Name der Ressource, die nach der erfolgreichen Wiederherstellung erstellt wird.
backupName Bei Sicherungsjobs ist der Sicherungsname ein systemgenerierter Name für die Sicherung in Form einer UUID. Bei Wiederherstellungsjobs ist der Sicherungsname der Name der Sicherung, die für die Wiederherstellung verwendet wurde.

Das folgende Beispiel ist ein Logeintrag für ein geplantes Back-up auf 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 Protokolle aufrufen möchten, können Sie im Bereich „Abfrage“ benutzerdefinierte Abfragen schreiben.

Mit der folgenden Abfrage können Sie fehlgeschlagene Jobs aufrufen.

    logName:"bdr_backup_restore_jobs" jsonPayload.jobStatus="FAILED"

Mit der folgenden Abfrage können Sie Jobs aufrufen, die in einem Back-up Vault gespeichert sind.

    logName:"bdr_backup_restore_jobs" jsonPayload.backupVaultName:"backupVaults/BACKUPVAULT_NAME"

Mit der folgenden Abfrage können Sie Jobs aufrufen, die mit einem Sicherungsplan erstellt wurden.

    logName:"bdr_backup_restore_jobs" jsonPayload.backupPlanName:"backupPlans/BACKUPPLAN_NAME"

Nächste Schritte