Ereignisprotokolle für Sicherung und Notfallwiederherstellung

Auf dieser Seite wird beschrieben, wie Sie die auf der Sicherungs-/Wiederherstellungs-Appliance erstellten Ereignisprotokolle in Cloud Logging aufrufen. Ereignisprotokolle liefern Informationen zu Ihrer Sicherungs-/Wiederherstellungs-Appliance, z. B. zu Systemereignissen oder Fehlern.

Berechtigungen und Rollen

IAM bestimmen, ob Sie auf Ereignisprotokolldaten des Sicherungs- und Notfallwiederherstellungsdiensts zugreifen können.

Sie benötigen die Berechtigung roles/logging.viewer, um die Ereignisprotokolle aufzurufen. Mit der Rolle Log-Betrachter erhalten Sie Lesezugriff auf die Ereignisprotokolle aller Sicherungs-/Wiederherstellungsgeräte im angegebenen Projekt. Weitere Informationen zu den IAM-Berechtigungen und -Rollen, die für Ereignisprotokolldaten gelten, finden Sie unter Zugriffssteuerung mit IAM.

Ereignisprotokolle ansehen

Sie können Sicherungs- und Notfallwiederherstellungsereignisprotokolle in Cloud Logging mit derGoogle Cloud Console und der Google Cloud  CLI aufrufen.

Konsole

In der Google Cloud -Console können Sie mit dem Log-Explorer die Backup- und Notfallwiederherstellungsereignisprotokolleinträge für Ihre Sicherungs-/Wiederherstellungsgeräte abrufen:

  1. Rufen Sie in der Google Cloud Console Logging > Log-Explorer auf.
  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ü Protokollnamen auswählen die Option backup_recovery_appliance_events aus, um sich Ereignisprotokolle von Sicherungs-/Wiederherstellungsgeräten anzusehen.

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 Ereignisprotokolleinträge von Sicherungs-/Wiederherstellungsgeräten in einem Projekt zu lesen:

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

API

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

  1. Rufen Sie den Abschnitt Diese API testen in der Dokumentation für die Methode entries.list auf.

  2. Geben Sie im Formular Diese API testen im Abschnitt Anfragetext Folgendes ein. Wenn Sie auf dieses vorausgefü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

Die Ereignisprotokolleinträge für Sicherung und Notfallwiederherstellung 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 auf der Sicherungs-/Wiederherstellungs-Appliance auftritt.
  • 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 Uhrzeit 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 ist ein Beispiel für 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 aufzurufen.

Mit der folgenden Abfrage können Sie alle Ereignisprotokolle aufrufen, die mit Sicherungs-/Wiederherstellungsgeräten für einen bestimmten PROJECT_ID verknüpft sind:

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

Wenn Sie nach Ereignisprotokollen für eine bestimmte Sicherungs-/Wiederherstellungs-Appliance suchen, fügen Sie den folgenden Namen 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 nach Ereignisprotokollen für eine bestimmte Ereignis-ID suchen, verwenden Sie die folgende Protokollabfrage. Verwenden Sie AND in Großbuchstaben.

    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 Protokollabfrage. Verwenden Sie AND und OR in Großbuchstaben.

    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 nach Ereignisprotokollen suchen und bestimmte Ereignis-IDs ausschließen möchten, verwenden Sie die folgende Protokollabfrage. Verwenden Sie AND NOT und OR in Großbuchstaben.

    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 nach Ereignisprotokollen für eine bestimmte Anwendung suchen, verwenden Sie die folgende Protokollabfrage. Verwenden Sie AND in Großbuchstaben.

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

Nächste Schritte