Résolution des problèmes

Cet article explique les causes courantes des avertissements et des échecs de sauvegarde ou de restauration, et indique comment diagnostiquer et résoudre ces problèmes.

Afficher et vérifier les tâches dont l’état est Failed ou Warning

Si une tâche d’un locataire se termine avec l’état Failed ou Warning au cours d’une période de 7 jours, le graphique Backup status du tableau de bord Overview affiche un nombre d’échecs ou d’avertissements différent de zéro.

Vous pouvez configurer des rapports de service dans l’onglet Configuration → Reports afin de recevoir régulièrement par e-mail, Slack, Teams ou Google Chat des informations sur l’état des licences, des protections et des sauvegardes d’un locataire.

Pour retrouver les tâches touchées par un échec ou un avertissement, accédez à l’onglet Activity → Tasks et filtrez les tâches dont l’état est Failed ou Warning. Cliquez ensuite sur chaque tâche pour consulter ses détails et examiner la cause de l’échec ou les éléments concernés par l’avertissement.

Échecs de sauvegarde et de restauration

Échecs de sauvegarde les plus courants :

Erreur	Cause
Not authorized	L’application Afi n’a pas reçu l’autorisation de sauvegarder l’utilisateur. Vérifiez que l’application Afi est installée pour l’ensemble du locataire Google Workspace, ce qui constitue la configuration recommandée, et non uniquement pour certaines unités organisationnelles ou certains groupes. Si vous préférez tout de même limiter l’installation à certaines unités ou certains groupes, assurez-vous que les utilisateurs concernés en font partie.
The attempted action requires shared drive membership	L’application Afi n’a accès à aucun membre actif (ni suspendu ni archivé) du Drive partagé doté du rôle Manager ou Content Manager. Assurez-vous que l’application Afi est installée pour l’ensemble du locataire Google Workspace ou, au minimum, pour l’un des membres du Drive partagé dotés du rôle Manager ou Content Manager.
Quota exceeded	Le locataire Afi dépasse son quota de licences utilisateur ou de stockage. Accédez à l’onglet Licensing → Subscriptions pour examiner le quota disponible et l’utilisation actuelle du service, ou ajustez le nombre de licences en fonction de l’utilisation.

Échecs de restauration les plus courants :

Erreur	Cause
Not authorized (User)	L’application Afi n’a pas reçu l’autorisation d’accéder à l’utilisateur de destination de la restauration. Vérifiez que l’application Afi est installée pour l’ensemble du locataire Google Workspace, ce qui constitue la configuration recommandée, et non uniquement pour certaines unités organisationnelles ou certains groupes. Si vous préférez tout de même limiter l’installation à certaines unités ou certains groupes, assurez-vous que les utilisateurs concernés en font partie.
Not authorized (Shared drive)	L’application Afi n’a pas reçu l’autorisation d’accéder à au moins un Manager ou Content Manager actif du Drive partagé de destination de la restauration. Assurez-vous que l’application Afi est installée pour l’ensemble du locataire Google Workspace ou, au minimum, pour l’un des membres du Drive partagé dotés du rôle Manager ou Content Manager.
User not found Shared drive is not found	L’utilisateur ou le Drive partagé de destination de la restauration n’existe pas actuellement dans Google Workspace. Cette erreur se produit généralement lorsque vous sauvegardez une ressource, la supprimez du côté de Google, puis tentez de la restaurer avec remplacement. Comme Afi ne recrée pas les utilisateurs ni les Drive partagés lors d’une restauration, l’opération échoue avec l’erreur correspondante. Dans ce cas, nous vous recommandons de recréer d’abord manuellement l’utilisateur ou le Drive partagé de destination dans Google, puis de déclencher la découverte des ressources dans le portail Afi en cliquant sur l’icône d’actualisation située dans l’angle supérieur droit de l’écran Service → Protection. Une fois la découverte terminée, sélectionnez le nouvel utilisateur ou Drive comme destination de restauration.

Avertissements de sauvegarde et de restauration

Dans de rares cas, une tâche de sauvegarde peut se terminer avec un avertissement lorsqu’elle ne parvient pas à télécharger un ou plusieurs éléments (fichiers, e-mails, etc.) depuis Google Workspace. Les causes les plus courantes sont les suivantes :

Erreur	Cause
Can't download file due to API errors, probably it is corrupted, will retry later.	Le fichier est probablement endommagé et ne peut pas être récupéré via l’API Google. Dans ce cas, nous vous suggérons d’essayer d’ouvrir le fichier dans l’interface utilisateur Google Drive ; l’opération échouera très probablement avec une erreur de serveur 500. Pour résoudre le problème, vous pouvez remplacer le fichier endommagé dans Google Drive par une copie correcte provenant de l’une des sauvegardes précédentes. Si le fichier concerné est un document, une feuille de calcul ou une présentation Google Drive natif, vous pouvez le convertir en fichier Microsoft 365 Office (DOCX, XLSX ou PPTX), car dans certains cas l’API Google ne permet pas d’exporter les documents Google natifs volumineux dotés d’une mise en forme complexe.
Google Chats API access is not granted for the backup application	Cet avertissement se produit lorsque l’accès à l’API Google Chat n’a pas été accordé à l’application Afi. Configurez l’accès pour l’application de sauvegarde Afi Google Chats comme décrit dans ce guide.

Sauvegardes ou restaurations suspendues

La limitation du débit de l’API Google Workspace pendant la synchronisation initiale des données d’une ressource (utilisateur ou Drive partagé) est une cause courante de suspension des sauvegardes. Lorsque le service Afi détecte un taux élevé d’erreurs transitoires provenant de Google Workspace, il suspend la tâche concernée et la redémarre automatiquement quelques heures plus tard. La tâche reprend alors à partir de l’état enregistré et poursuit la synchronisation. Les sauvegardes suspendues ne nécessitent généralement aucune intervention manuelle, car les problèmes de limitation du débit de l’API disparaissent habituellement d’eux-mêmes en quelques heures. Une fois la synchronisation initiale des données du locataire Google Workspace terminée, les sauvegardes incrémentielles suivantes doivent être rapides et s’exécuter sans interruption, quelle que soit la taille de la ressource.

Dans de rares cas, une tâche de sauvegarde ou de restauration peut être suspendue en raison d’une erreur accidentelle de Google Workspace sans rapport avec la limitation du débit. La tâche est alors suspendue de façon similaire et se termine généralement correctement après son redémarrage automatique par le service. L’équipe Afi surveille en continu les tâches suspendues de tous nos clients, et examine et résout de manière proactive les problèmes récurrents.