Throttling-Vermeidung

KONNEKTs Drosselungsschutz umfasst zwei Richtlinien, eine „Aktualisierungshäufigkeitssteuerung“-Richtlinie und eine „Anforderungsratenbegrenzung“-Richtlinie, die darauf ausgelegt ist, die Rate zu verwalten und zu steuern, mit der Anfragen an die Microsoft GraphAPI gestellt werden, damit die Verbindungen zu SharePoint Online (SPO) stabil bleiben und optimal funktionieren. Diese Richtlinien sind besonders nützlich, um einen übermäßigen Ressourcenverbrauch zu verhindern und eine reibungslose Benutzererfahrung aufrechtzuerhalten.

Die Nutzung von Microsoft 365-APIs unterliegt Beschränkungen hinsichtlich der Anzahl von Anfragen pro Zeiteinheit, die eine Anwendung senden darf. Wenn eine Anwendung mehr Ressourcen verbraucht, wird sie gedrosselt. Mehr dazu finden Sie im Microsoft-Dokumentation.

Da KONNEKT die Microsoft SharePoint Online REST API und die Microsoft Graph API verwendet, kann es vorkommen, dass Microsoft-APIs Ihre KONNEKT-Nutzung drosseln. Wenn eine Anwendung gedrosselt wird, teilt die entsprechende API (z. B. die SPO REST API) KONNEKT mit, dass es eine definierte Zeit warten muss. Das beginnt bei einigen Sekunden und kann je nach Nutzung auf mehrere Minuten anwachsen. Auswirkungen für KONNEKT können langsames Durchsuchen oder Laden/Schreiben von Dateien sein. Wenn die Drosselung auf mehrere Minuten anwächst, führt das zu Fehlermeldungen, dass das Laufwerk derzeit nicht verfügbar ist.

KONNEKT verfügt über mehrere Mechanismen zur Verringerung des Auftretens von Drosselung, die automatisch angewendet werden.

Häufige Szenarien zur Vermeidung von Drosselung

Szenario 1: Daten-Uploads mit hohem Volumen oder Datenmigration

Wenn ein Benutzer versucht, innerhalb kurzer Zeit eine große Anzahl von Dateien hochzuladen oder eine Datenmigration innerhalb von SPO durchzuführen, kann das Gerät die angegebene Grenze erreichen.

Szenario 2: Intensive Lesevorgänge

Wenn ein Benutzer intensive Lesevorgänge durchführt, z. B. das Abfragen oder Durchsuchen eines großen Verzeichnisses (> 1000 Elemente), kann das Gerät die angegebene Grenze erreichen.

Beispiele:

• Verwendung der Suche im Datei-Explorer in großen Ordnern
• Durchscrollen von Ordnern mit zahlreichen Grafik- oder PDF-Dateien

Szenario 3: Berechtigungsabfragen

Seit Version 2.10 prüft KONNEKT zusätzlich Berechtigungen pro Ordner und Datei, da diese Abfragen im Vergleich zu den anderen Vorgängen eine höhere Anzahl an Ressourceneinheiten verbrauchen. Das System kann die angegebene Grenze dadurch viel schneller erreichen, wodurch Drosselungsschutz ausgelöst werden kann. Berechtigungsabfragen werden nicht ausgelöst, wenn „SharePoint-Drosselungsschutz“ auf 'High' gesetzt ist.

In Umgebungen mit hoher Last reichen möglicherweise nicht alle Maßnahmen aus, um Drosselung zu verhindern.

KONNEKT ist für die reguläre Büroarbeit gemacht. Wenn Sie Dateien mit hohem Volumen verwenden (z. B. Videobearbeitung, Grafikdesign, CAD) oder Gigabytes an Daten lesen/schreiben, ist KONNEKT (& SPO) möglicherweise nicht das geeignete Werkzeug der Wahl.

Bitte prüfen Sie auch unsere Anwendungsfälle.

Ressourceneinheiten

Jede Art von GraphAPI-Anfrage verbraucht unterschiedliche Mengen an Ressourceneinheiten:

• Lesezugriffe auf einzelne Elemente: jeweils 1 Ressourceneinheit
• Schreibvorgänge und Verzeichnisabfragen: jeweils 2 Ressourceneinheiten
• Berechtigungsabfragen: 5

Details siehe: https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online

Wie kann ich Drosselung verhindern?

Folgende Umstände begünstigen Drosselung:

• Verwendung von Drittanbieter-Tools für SPO-Backups - insbesondere während der Arbeitszeit
• Verwendung von Tools, die Ihr gesamtes Dateisystem durchforsten (wie z. B. Vorschau-Renderer usw.)
• Verwendung von sehr großen Ordnern mit >1000 Dateien auf der ersten Ordnerebene
• Übermäßige Verwendung der Datei-Explorer-Suche in großen Site Collections oder Dokumentbibliotheken

Berücksichtigen Sie die folgenden Einstellungen und Aktionen für alle Benutzer eines M365 Tenant ohne Ausnahmen.

Zur Vermeidung von Drosselung:

• Führen Sie SPO-Backups nicht während der Geschäftszeiten aus.
• Wenn die Datei-Explorer-Suche unvermeidbar ist: Optimieren Sie die Datei-Explorer-Suchen und konzentrieren Sie sich auf bestimmte Ordner oder Unterordner, um GraphAPI-Anfragen zu begrenzen
• Regelmäßige Wartung: Archivieren oder entfernen Sie veraltete Dateien, Ordner, Dokumentbibliotheken und Site Collections.
• Vermeiden Sie die übermäßige Verwendung der Datei-Explorer-Suche in großen Site Collections oder Dokumentbibliotheken
• Verwenden Sie keinen Vorschau-Renderer für KONNEKT-Ressourcen. Siehe auch hier. Zusätzlich können Sie den Offline-Filter auf die Dateiendung "YYY" (die nicht existiert) setzen, um zu verhindern, dass der Windows-Datei-Explorer Vorschauen für PDF-Dateien rendert.
• Segmentieren Sie Ihre Daten (nicht zu viele Dateien auf der ersten Ebene eines Ordners).
• Setzen Sie die „SharePoint-Drosselungsschutz“-Richtlinie auf „High“ - nur empfohlen bis KONNEKT-Version 2.10.2
• Ab Version 2.11.0 empfehlen wir, „clientseitige Drosselung“ zu aktivieren und die „SharePoint-Drosselungsschutz“-Richtlinie auf „Auto“ zu setzen.

Wenn Sie das KONNEKT-Logging auf „debug“, sehen Sie Logeinträge mit „ThrottlingHook: Es muss Xs gewartet werden, bevor gestartet wird“ (wobei X für die Anzahl der Sekunden steht, die SPO uns warten lassen möchte).

Logeinträge, die „[Sharepoint] UpdateDrives: Volume wird aufgrund von Drosselungsschutz übersprungen.“ enthalten, werden NICHT durch SharePoint-Drosselung verursacht. Diese weisen auf normale Vorgänge zur Vermeidung von Drosselung hin - kein Grund zur Sorge. ;-)

Wie es funktioniert

Die „Aktualisierungshäufigkeitssteuerung“-Richtlinie begrenzt Anfragen durch erweiterte Aktualisierungszyklen, z. B. beim Aktualisieren der Site Collections der Benutzer.

Die „Anforderungsratenbegrenzung“-Richtlinie funktioniert, indem die Anzahl der Anfragen und der entsprechenden Ressourceneinheiten, die innerhalb eines festgelegten Zeitfensters erfolgen, überwacht und Beschränkungen auf diese Anfragen angewendet werden. Diese Richtlinie, „clientseitige Drosselung“, umfasst weiche und harte Grenzwerte:

• Soft-Limit: Wenn der weiche Grenzwert erreicht wird, beginnt das System, Anfragen zu drosseln. Das bedeutet, dass die meisten Vorgänge für kurze Zeit verzögert werden (z. B. 2 Sekunden), und die Stufe des Drosselungsschutzes wechselt auf HOCH. Einige Vorgänge, wie opportunistische Upload-Jobs und Vorab-Lesevorgänge, werden aufgeschoben, bis die Anzahl der Anfragen wieder unter den weichen Grenzwert fällt.
• Hard-Limit: Wenn der harte Grenzwert erreicht wird, sendet das System keine Anfragen mehr. Die Anwendung zeigt eine Fehlermeldung an, bis das Ende des Zeitfensters erreicht ist.

Verwenden Sie „Hard Limit“ nur, wenn nötig, da es KONNEKT daran hindert, mit den Endpunkten von Microsoft zu kommunizieren.