Ereignisprotokolle der Sicherungs‑/Wiederherstellungs-Appliance

Auf dieser Seite wird erklärt, wie Sie die Ereignisprotokolle ansehen, die auf einer Sicherungs-/Wiederherstellungs-Appliance in Cloud Logging erstellt wurden. Ereignisprotokolle liefern Informationen zu Ihrer Sicherungs-/Wiederherstellungs-Appliance, z. B. Systemereignisse oder Fehler.

Berechtigungen und Rollen

IAM-Berechtigungen und ‑Rollen bestimmen, ob Sie auf Ereignisprotokolldaten von Backup and DR zugreifen können.

Sie benötigen die Berechtigung roles/logging.viewer, um die Ereignisprotokolle anzusehen. Mit der Rolle Betrachter der Logs haben Sie schreibgeschützten Zugriff auf die Ereignisprotokolle aller Sicherungs-/Wiederherstellungs-Appliances im angegebenen Projekt. Weitere Informationen zu den IAM-Berechtigungen und ‑Rollen für Ereignisprotokolldaten finden Sie unter Zugriffssteuerung mit IAM.

Ereignisprotokolle ansehen

Sie können Backup and DR-Ereignisprotokolle in Cloud Logging über die Google Cloud Console und die Google Cloud CLI ansehen.

Console

In der Google Cloud Console können Sie mit dem Log-Explorer die Backup and DR-Ereignisprotokolle für Ihre Sicherungs-/Wiederherstellungs-Appliances abrufen:

  1. Wechseln Sie in der Google Cloud Console zu Logging > Log-Explorer.
  2. Wählen Sie ein vorhandenes Cloud-Projekt aus.
  3. Führen Sie im Bereich Query Builder folgende Schritte aus:

    1. Wählen Sie im Drop-down-Menü Ressource die Option Backup Recovery Appliance aus.
    2. Wählen Sie im Drop-down-Menü Logname auswählen die Option backup_recovery_appliance_events aus, um Ereignisprotokolle von Sicherungs-/Wiederherstellungs-Appliances anzusehen.
nur die Ereignisprotokolle ansehen, die nach dem 6. März 2023 generiert wurden.

gcloud

Die Google Cloud CLI bietet eine Befehlszeile für die Logging API. Geben Sie in jedem Lognamen eine gültige Ressourcenkennung an. Führen Sie den folgenden Befehl aus, um die Ereignisprotokolle von Sicherungs-/Wiederherstellungs-Appliances in einem Projekt zu lesen:

```gcloud
gcloud logging read "logName : projects/PROJECT_ID/logs/backup_recovery_appliance_events"\
 --project=PROJECT_ID
 ```

API

So sehen Sie die Audit-Logeinträge von Sicherungs-/Wiederherstellungs-Appliances in einem Projekt:

  1. Rufen Sie den Abschnitt Diese API testen in der Dokumentation für die Methode entries.list auf.
  2. Geben Sie im Teil Anfragetext des Formulars Diese API testen Folgendes ein. Wenn Sie auf dieses vorab ausgefüllte Formular klicken, wird der Anfragetext automatisch übernommen. Sie müssen jedoch in jedem Feld für den Lognamen eine gültige PROJECT_ID angeben.

    ```API
    {
      "resourceNames": [
        "projects/PROJECT_ID"
      ],
      "pageSize": 5,
      "filter": "logName : projects/PROJECT_ID/logs/backupdr_audit_log"
    }
    ```
    
  3. Klicken Sie auf Ausführen.

Ereignisprotokollformat

Backup and DR-Ereignisprotokolleinträge enthalten die folgenden Felder:

  • appName: In diesem Feld wird der Name der Anwendung angezeigt, die mit dem Ereignis verknüpft ist.
  • srcid: In diesem Feld wird eine eindeutige ID des Ereignisses angezeigt, das in der Sicherungs-/Wiederherstellungs-Appliance aufgetreten ist.
  • jobName: In diesem Feld wird der Name des Jobs angezeigt, der mit dem Ereignis verknüpft ist.
  • appType: In diesem Feld wird der Typ der Anwendung angezeigt, die mit dem Ereignis verknüpft ist.
  • eventId: In diesem Feld wird eine eindeutige ID angezeigt, die mit dem Fehler verknüpft ist.
  • component: In diesem Feld wird die Quelle des Ereignisses angezeigt.
  • eventTime: In diesem Feld wird die Zeit angezeigt, zu der das Ereignis gemeldet wurde.
  • errorMessage: In diesem Feld wird der detaillierte Fehler beschrieben, der mit dem Ereignis verknüpft ist.

Das folgende Beispiel zeigt einen Logeintrag, der auf einer Sicherungs-/Wiederherstellungs-Appliance ba-1-52973 für einen fehlgeschlagenen Snapshot-Job protokolliert wurde.

    {
    "insertId": "aop2oko38hsami1c",
    "jsonPayload": {
    "appName": "instance-2",
    "srcid": "111428",
    "jobName": "Job_0110906c",
    "appType": "GCPInstance",
    "eventId": 43901,
    "component": "udp",
    "eventTime": "2023-02-06T20:24:52.450Z",
    "errorMessage": "Failed snapshot Job_0110906c for application instance-2 on host instance-2, Error: 1249: Failed to get VM details , sltname: pd snaps, slpname: ba-1-52973_Profile. "
    },
    "resource": {
    "type": "backupdr.googleapis.com/BackupRecoveryAppliance",
    "labels": {
    "backup_recovery_appliance_id": "test-backup-recovery-appliances",
    "resource_container": "projects/1234567",
    "management_server_id": "abcd-efgh-1234-5678-6789",
    "location": ""
    }
    },
    "timestamp": "2023-02-06T20:24:55.275029393Z",
    "severity": "ERROR",
    "logName": "projects/project1/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events",
    "receiveTimestamp": "2023-02-06T20:24:56.388937247Z"
    }

Beispielabfragen

Sie können im Abfragebereich benutzerdefinierte Ereignisabfragen schreiben, um die gewünschten Ereignisprotokolle anzusehen.

Verwenden Sie die folgende Abfrage, um alle Ereignisprotokolle für Sicherungs-/Wiederherstellungs-Appliances für eine bestimmte PROJECT_ID anzusehen:

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"

Wenn Sie Ereignisprotokolle für eine bestimmte Sicherungs-/Wiederherstellungs-Appliance suchen, fügen Sie den Namen der Sicherungs-/Wiederherstellungs-Appliance hinzu:

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    resource.labels.backup_recovery_appliance_id= "backup/recovery appliance name"

Wenn Sie Ereignisprotokolle für eine bestimmte Ereignis-ID suchen, verwenden Sie die folgende Logabfrage. Verwenden Sie dabei ein großes UND.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND jsonPayload.eventId = event ID

Wenn Sie Ereignisprotokolle für mehrere bestimmte Ereignis-IDs suchen, verwenden Sie die folgende Logabfrage. Verwenden Sie dabei ein großes UND und ODER.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND jsonPayload.eventId = (event ID 1 OR event ID 2 OR event ID 3)

Wenn Sie Ereignisprotokolle suchen und bestimmte Ereignis-IDs ausschließen möchten, verwenden Sie die folgende Logabfrage. Verwenden Sie dabei ein großes UND NICHT und ODER.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND NOT jsonPayload.eventId = (event ID 1 OR event ID 2 OR event ID 3)

Wenn Sie Ereignisprotokolle für eine bestimmte Anwendung suchen, verwenden Sie die folgende Logabfrage. Verwenden Sie dabei ein großes UND.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.app_name = appname

Nächste Schritte