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:
- Wechseln Sie in der Google Cloud Console zu Logging > Log-Explorer.
- Wählen Sie ein vorhandenes Cloud-Projekt aus.
Führen Sie im Bereich Query Builder folgende Schritte aus:
- Wählen Sie im Drop-down-Menü Ressource die Option Backup Recovery Appliance aus.
- Wählen Sie im Drop-down-Menü Logname auswählen die Option backup_recovery_appliance_events aus, um Ereignisprotokolle von Sicherungs-/Wiederherstellungs-Appliances 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 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:
- Rufen Sie den Abschnitt Diese API testen in der Dokumentation für die Methode entries.list auf.
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" } ```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
Wenn Sie logbasierte Benachrichtigungen für Backup and DR konfigurieren möchten, erstellen Sie eine Logabfrage, mit dem Filter Ereignisprotokolle und konfigurieren Sie dann logbasierte Benachrichtigungen.
Informationen zum Erstellen logbasierter Messwerte für Backup and DR finden Sie unter Übersicht über logbasierte Messwerte.