Fehlerbehebung¶
Dieser Artikel erläutert häufige Ursachen für Fehler und Warnungen bei Sicherungen und Wiederherstellungen und enthält Anleitungen zur Diagnose und Behebung dieser Probleme.
Aufgaben mit dem Status Failed oder Warning anzeigen und prüfen¶
Wenn innerhalb eines Zeitraums von 7 Tagen eine Aufgabe für einen Mandanten mit dem Status Failed oder Warning abgeschlossen wird, zeigt das Diagramm Backup status im Dashboard Overview eine Anzahl von Fehlern oder Warnungen größer als null an.
Sie können auf der Registerkarte Configuration → Reports Dienstberichte konfigurieren, um regelmäßig per E-Mail oder über Slack, Teams bzw. Google Chat über Lizenzierungs-, Schutz- und Sicherungsstatus eines Mandanten informiert zu werden.
Um Aufgaben mit Fehlern oder Warnungen zu finden, öffnen Sie die Registerkarte Activity → Tasks und filtern nach dem Status Failed oder Warning. Klicken Sie anschließend auf eine Aufgabe, um ihre Details anzuzeigen und die Fehlerursache beziehungsweise bei einer Warnung die betroffenen Elemente zu prüfen.
Fehler bei Sicherung und Wiederherstellung¶
Häufigste Sicherungsfehler:
| Fehler | Ursache |
|---|---|
| Not authorized |
Der Afi-Anwendung wurden keine Berechtigungen zum Sichern des Nutzers gewährt.
Prüfen Sie, ob die Afi-Anwendung wie empfohlen für den gesamten Google Workspace-Mandanten und nicht nur für bestimmte Organisationseinheiten oder Gruppen installiert ist. Wenn Sie die Installation weiterhin auf bestimmte Einheiten oder Gruppen beschränken möchten, stellen Sie sicher, dass die betroffenen Nutzer diesen angehören. |
| The attempted action requires shared drive membership |
Die Afi-Anwendung hat keinen Zugriff auf ein aktives, also weder gesperrtes noch archiviertes, Mitglied der geteilten Ablage mit der Rolle Manager oder Content Manager.
Stellen Sie sicher, dass die Afi-Anwendung für den gesamten Google Workspace-Mandanten oder zumindest für ein Mitglied der geteilten Ablage mit der Rolle Manager oder Content Manager installiert ist. |
| Quota exceeded |
Der Afi-Mandant überschreitet sein lizenziertes Nutzer- oder Speicherkontingent.
Öffnen Sie die Registerkarte Licensing → Subscriptions, um das verfügbare Kontingent und die aktuelle Dienstnutzung zu prüfen oder die Lizenzanzahl an die Nutzung anzupassen. |
Häufigste Wiederherstellungsfehler:
| Fehler | Ursache |
|---|---|
|
Not authorized (User) |
Der Afi-Anwendung wurden keine Berechtigungen für den Zugriff auf den Zielnutzer der Wiederherstellung gewährt.
Prüfen Sie, ob die Afi-Anwendung wie empfohlen für den gesamten Google Workspace-Mandanten und nicht nur für bestimmte Organisationseinheiten oder Gruppen installiert ist. Wenn Sie die Installation weiterhin auf bestimmte Einheiten oder Gruppen beschränken möchten, stellen Sie sicher, dass die betroffenen Nutzer diesen angehören. |
|
Not authorized (Shared drive) |
Der Afi-Anwendung wurden keine Berechtigungen für mindestens einen aktiven Manager oder Content Manager der geteilten Zielablage gewährt.
Stellen Sie sicher, dass die Afi-Anwendung für den gesamten Google Workspace-Mandanten oder zumindest für ein Mitglied der geteilten Ablage mit der Rolle Manager oder Content Manager installiert ist. |
|
User not found Shared drive is not found |
Der Zielnutzer beziehungsweise die geteilte Zielablage ist derzeit in Google Workspace nicht vorhanden.
Dieser Fehler tritt typischerweise auf, wenn Sie eine Ressource sichern, sie anschließend in Google löschen und dann eine überschreibende Wiederherstellung für diese Ressource versuchen. Da Afi bei einer Wiederherstellung keine Nutzer oder geteilten Ablagen neu erstellt, schlägt der Vorgang fehl. Erstellen Sie in diesem Fall den Zielnutzer beziehungsweise die geteilte Zielablage zunächst manuell in Google. Lösen Sie dann im Afi-Portal auf der Seite Service → Protection über das Aktualisierungssymbol oben rechts eine Ressourcenerkennung aus. Wählen Sie den neu erstellten Nutzer oder die Ablage nach Abschluss der Erkennung als Wiederherstellungsziel aus. |
Warnungen bei Sicherung und Wiederherstellung¶
In seltenen Fällen endet eine Sicherungsaufgabe mit einer Warnung, wenn mindestens ein Element wie eine Datei oder E-Mail nicht aus Google Workspace heruntergeladen werden konnte. Häufige Ursachen sind:
| Fehler | Ursache |
|---|---|
| Can't download file due to API errors, probably it is corrupted, will retry later. |
Die Datei ist wahrscheinlich beschädigt und kann nicht über die Google-API abgerufen werden.
Versuchen Sie, die Datei über die Google-Drive-Benutzeroberfläche zu öffnen. Dabei wird sehr wahrscheinlich ein Serverfehler 500 angezeigt. Ersetzen Sie die beschädigte Datei in Google Drive durch eine intakte Kopie aus einer früheren Sicherung, um das Problem zu beheben. Handelt es sich um ein natives Google-Drive-Dokument, eine Tabelle oder eine Präsentation, können Sie es in eine Microsoft 365-Office-Datei im Format DOCX, XLSX oder PPTX umwandeln. Die Google-API erlaubt in manchen Fällen nicht den Export großer nativer Google-Dokumente mit komplexer Formatierung. |
| Google Chats API access is not granted for the backup application |
Diese Warnung tritt auf, wenn der Afi-Anwendung kein Zugriff auf die Google Chat API gewährt wurde.
Richten Sie den Zugriff für die Anwendung Afi Google Chats Backup wie in dieser Anleitung beschrieben ein. |
Angehaltene Sicherungen oder Wiederherstellungen¶
Eine häufige Ursache für angehaltene Sicherungen ist die Drosselung der Google Workspace-API während der ersten Datensynchronisierung einer Ressource wie eines Nutzers oder einer geteilten Ablage. Erkennt der Afi-Dienst eine erhöhte Anzahl vorübergehender Google Workspace-Fehler, hält er die betroffene Aufgabe an und startet sie nach einigen Stunden automatisch neu. Dabei setzt die Aufgabe am gespeicherten Zustand an und führt die Synchronisierung fort. Angehaltene Sicherungen erfordern normalerweise keine manuelle Fehlerbehebung, da sich API-Drosselungsprobleme meist innerhalb weniger Stunden von selbst lösen. Nach Abschluss der ersten Datensynchronisierung des Google Workspace-Mandanten sollten nachfolgende inkrementelle Sicherungen unabhängig von der Ressourcengröße schnell und störungsfrei ausgeführt werden.
In seltenen Fällen wird eine Sicherungs- oder Wiederherstellungsaufgabe aufgrund eines unbeabsichtigten Google Workspace-Fehlers angehalten, der nicht mit der Drosselung zusammenhängt. Die Aufgabe pausiert dann auf ähnliche Weise und wird nach dem automatischen Neustart durch den Dienst in der Regel erfolgreich abgeschlossen. Das Afi-Team überwacht angehaltene Aufgaben aller Kunden fortlaufend und untersucht und behebt wiederkehrende Probleme proaktiv.


