Journaux des événements de sauvegarde et de reprise après sinistre

Cette page explique comment afficher les journaux des événements créés sur l'appliance de sauvegarde/restauration dans Cloud Logging. Les journaux des événements fournissent des informations sur votre appareil de sauvegarde/restauration, telles que les événements système ou les erreurs.

Autorisations et rôles

Les autorisations et les rôles IAM déterminent si vous pouvez accéder aux données des journaux d'événements du service Backup and DR.

Vous devez disposer de l'autorisation roles/logging.viewer pour afficher les journaux des événements. Le rôle Lecteur de journaux vous permet de consulter les journaux des événements de tous les appareils de sauvegarde/restauration du projet spécifié en lecture seule. Pour en savoir plus sur les autorisations et les rôles IAM qui s'appliquent aux données des journaux d'événements, consultez la page Contrôle des accès avec IAM.

Afficher les journaux des événements

Vous pouvez consulter les journaux des événements de sauvegarde et de reprise après sinistre dans Cloud Logging à l'aide de la consoleGoogle Cloud et de la CLI Google Cloud .

Console

Dans la console Google Cloud , vous pouvez utiliser l'explorateur de journaux pour récupérer les entrées du journal des événements de sauvegarde et de reprise après sinistre de vos appareils de sauvegarde/restauration:

  1. Dans la console Google Cloud , accédez à Journalisation > Explorateur de journaux.
  2. Sélectionnez un projet Cloud existant.

  3. Dans le volet Générateur de requêtes, procédez comme suit:

    1. Dans le menu déroulant Ressource, sélectionnez l'appareil de récupération de sauvegarde.
    2. Dans le menu déroulant Sélectionner un nom de journal, sélectionnez backup_recovery_appliance_events pour afficher les journaux des événements des appliances de sauvegarde/restauration.

gcloud

La Google Cloud CLI fournit une interface de ligne de commande à l'API Logging. Fournissez un identifiant de ressource valide dans chacun des noms de journaux. Pour lire les entrées de journal des événements des appareils de sauvegarde/restauration dans un projet, exécutez la commande suivante:

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

API

Pour afficher les entrées de journal d'audit des appareils de sauvegarde/restauration d'un projet, procédez comme suit:

  1. Accédez à la section Essayer cette API dans la documentation de la méthode entries.list.

  2. Insérez les éléments suivants dans la partie Corps de la requête du formulaire Essayer cette API. En cliquant sur ce formulaire prérempli, vous remplissez automatiquement le corps de la requête, mais vous devez fournir un PROJECT_ID valide dans chacun des champs de nom de journal.

    ```API
{
  "resourceNames": [
    "projects/PROJECT_ID"
  ],
  "pageSize": 5,
  "filter": "logName : projects/PROJECT_ID/logs/backupdr_audit_log"
}
```

  3. Cliquez sur Exécuter.

Format du journal des événements

Les entrées du journal des événements de sauvegarde et de reprise après sinistre incluent les champs suivants:

  • appName: ce champ affiche le nom de l'application associée à l'événement.
  • srcid: ce champ affiche un ID unique de l'événement qui se produit dans l'appliance de sauvegarde/restauration.
  • jobName: ce champ affiche le nom de l'emploi associé à l'événement.
  • appType: ce champ affiche le type d'application associé à l'événement.
  • eventId: ce champ affiche un ID unique associé à l'erreur.
  • component: ce champ affiche la source de l'événement.
  • eventTime: ce champ affiche l'heure à laquelle l'événement a été signalé.
  • errorMessage: ce champ décrit l'erreur détaillée associée à l'événement.

L'exemple suivant est une entrée de journal enregistrée sur un appareil de sauvegarde/restauration ba-1-52973 pour une tâche d'instantané ayant échoué.

    {
    "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"
    }

Exemples de requêtes

Vous pouvez écrire des requêtes d'événements personnalisées dans la section des requêtes pour afficher les journaux d'événements de votre choix.

Utilisez la requête suivante pour afficher tous les journaux des événements associés aux appliances de sauvegarde/restauration pour un PROJECT_ID donné:

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

Si vous recherchez des journaux d'événements pour un appareil de sauvegarde/récupération spécifique, ajoutez le nom de l'appareil de sauvegarde/récupération suivant:

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

Si vous recherchez des journaux d'événements pour un ID d'événement spécifique, utilisez la requête de journal suivante. Veillez à utiliser un ET en majuscules.

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

Si vous recherchez des journaux d'événements pour plusieurs ID d'événement spécifiques, utilisez la requête de journal suivante. Veillez à utiliser les valeurs AND et OR en majuscules.

    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)

Si vous recherchez des journaux d'événements et que vous souhaitez exclure des ID d'événement spécifiques, utilisez la requête de journal suivante. Veillez à utiliser les majuscules pour AND NOT (ET NON) et OR (OU).

    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)

Si vous recherchez des journaux d'événements pour une application spécifique, utilisez la requête de journal suivante. Veillez à utiliser la majuscule ET.

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

Étape suivante