Throttling-Vermeidung

KONNEKTs Schutz vor Drosselung umfasst zwei Richtlinien, eine "Aktualisierungshäufigkeitssteuerung"-Richtlinie und eine "Anforderungsratenbegrenzungs"-Richtlinie, die darauf ausgelegt sind, die Rate zu steuern und zu kontrollieren, mit der Anfragen an die Microsoft GraphAPI gestellt werden, und sicherzustellen, dass die Verbindungen zu SharePoint Online (SPO) stabil bleiben und optimal funktionieren. Diese Richtlinien sind besonders nützlich, um eine übermäßige Ressourcennutzung zu verhindern und eine reibungslose Benutzererfahrung aufrechtzuerhalten.

Die Nutzung von Microsoft 365 APIs unterliegt Beschränkungen hinsichtlich der Anzahl von Anfragen pro Zeit, die eine Anwendung senden darf. Wenn eine Anwendung mehr Ressourcen verbraucht, wird sie gedrosselt. Mehr dazu finden Sie in der 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 für eine bestimmte Zeit warten muss. Dies beginnt bei einigen Sekunden und kann je nach Nutzung bis zu Minuten anwachsen. Auswirkungen für KONNEKT können langsames Durchsuchen oder Laden/Schreiben von Dateien sein. Wenn die Drosselung bis auf Minuten anwächst, führt dies zu Fehlermeldungen, dass das Laufwerk derzeit nicht verfügbar ist.

KONNEKT verfügt über mehrere Mechanismen, um das Auftreten von Drosselung zu reduzieren, die automatisch angewendet werden.

Häufige Szenarien zur Vermeidung von Drosselung

Szenario 1: Hochvolumige Daten-Uploads 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 das angegebene Limit erreichen.

Szenario 2: Intensive Leseoperationen

Wenn ein Benutzer intensive Leseoperationen ausführt, wie etwa das Abfragen oder Durchsuchen eines großen Verzeichnisses (> 1000 Elemente), kann das Gerät das angegebene Limit erreichen.

Beispiele:

• Die Suche im Datei-Explorer in großen Ordnern verwenden

• Durch Ordner mit zahlreichen Grafik- oder PDF-Dateien scrollen

Szenario 3: Berechtigungsabfragen

Seit Version 2.10 prüft KONNEKT zusätzlich Berechtigungen pro Ordner und Dateien, da diese Abfragen im Vergleich zu den anderen Operationen eine höhere Anzahl von Ressourceneinheiten verbrauchen. Das System kann das angegebene Limit wesentlich schneller erreichen, was eine Vermeidung von Drosselung auslösen kann. Berechtigungsabfragen werden nicht ausgelöst, wenn "SharePoint Throttling Prevention" auf 'High' gesetzt ist.

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

KONNEKT wurde für die normale Büroarbeit entwickelt. 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.

Bitte prüfen Sie auch unsere Anwendungsfälle.

Ressourceneinheiten

Jeder Typ von GraphAPI-Anfrage verbraucht unterschiedliche Mengen an Ressourceneinheiten:

• Lesezugriffe auf einzelne Elemente: jeweils 1 Ressourceneinheit

• Schreiboperationen 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?

Die folgenden Umstände begünstigen Drosselung:

• Nutzung von Drittanbieter-Tools für SPO-Backups - insbesondere während der Arbeitszeit

• Verwendung von Tools, die Ihr gesamtes Dateisystem durchsuchen (z. B. Preview-Renderer etc.)

• Verwendung sehr großer Ordner mit >1000 Dateien auf der ersten Ebene des Ordners

• Übermäßige Nutzung der Datei-Explorer-Suche in großen Site Collections oder Dokumentbibliotheken

Berücksichtigen Sie die folgenden Einstellungen und Maßnahmen für alle Benutzer eines M365-Tenants ohne Ausnahmen.

Um Drosselung zu vermeiden:

• Führen Sie keine SPO-Backups während der Geschäftszeiten aus.

• Wenn die Datei-Explorer-Suche unvermeidlich ist: Optimieren Sie Datei-Explorer-Suchen, 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 Nutzung der Datei-Explorer-Suche in großen Site Collections oder Dokumentbibliotheken

• Verwenden Sie keinen Preview-Renderer für KONNEKT-Ressourcen. Siehe auch hier. Sie können zusätzlich den Offline-Filter auf die Dateierweiterung "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 Richtlinie "SharePoint Throttling Prevention" auf "High" - nur empfohlen bis KONNEKT Version 2.10.2

• Ab Version 2.11.0 empfehlen wir, "Drosselung auf Clientseite" zu aktivieren und die Richtlinie "SharePoint Throttling Prevention" auf "Auto" zu setzen.

Wenn Sie das KONNEKT-Logging auf "debug"stellen, sehen Sie Logeinträge mit "ThrottlingHook: Need to wait Xs before start" (wobei X für die Anzahl der Sekunden steht, die SPO uns warten lassen möchte).

Logeinträge, die "[Sharepoint] UpdateDrives: Skipping volume due to throttling prevention." enthalten, werden NICHT durch SharePoint-Drosselung verursacht. Diese zeigen reguläre Vorgänge zur Vermeidung von Drosselung an - nichts, worüber man sich Sorgen machen müsste. ;-)

Wie es funktioniert

Die Richtlinie "Aktualisierungshäufigkeitssteuerung" begrenzt Anfragen durch verbesserte Aktualisierungszyklen, z. B. beim Aktualisieren der Site Collections der Benutzer.

Die Richtlinie "Anforderungsratenbegrenzungs"-Richtlinie arbeitet, indem sie die Anzahl der Anfragen und die entsprechenden Ressourceneinheiten überwacht, die innerhalb eines festgelegten Zeitfensters gestellt werden, und diese Anfragen begrenzt. Diese Richtlinie, “Drosselung auf Clientseite”, umfasst weiche und harte Grenzwerte:

• Soft Limit: Wenn der Soft-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 der Drosselungsvermeidung auf HIGH umschaltet. Einige Vorgänge, wie opportunistische Upload-Jobs und Read-Ahead-Operationen, werden verschoben, bis die Anzahl der Anfragen wieder unter den Soft-Grenzwert fällt.

• Hard Limit: Wenn der Hard-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 bei Bedarf, da dadurch KONNEKT daran gehindert wird, mit den Endpunkten von Microsoft zu kommunizieren.